0. 快速入门
本章覆盖三件事:怎么登录、首页有什么、Sira 的概念是怎么串起来的。看完应该能独立创建一个最简单的对话应用。
0.1 登录 [所有人]
打开浏览器访问平台主页(由管理员提供具体域名),未登录时会自动跳转到登录页 /auth/login。
登录页字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 邮箱地址 | ✓ | 注册时使用的邮箱 | |
| 密码 | password | ✓ | 旁边有👁️按钮可切换显示/隐藏 |
| 组织代码 | text | 仅多组织场景需要(可在「企业用户选项」折叠面板展开) | |
| 记住我 | checkbox | 勾选后在本机延长 session |
登录方式
平台支持三种登录方式,具体启用哪些由部署方决定:
| 方式 | 启用条件 | 入口 |
|---|---|---|
| 本地账密 | 默认启用 | 邮箱+密码 → 「登录」 |
| Keycloak SSO | 部署方启用 | 卡片下方的「SSO 登录」按钮 |
| 企业微信扫码 | 部署方启用 | 卡片下方的「企业微信」按钮 |
注册
- 如果平台开放自助注册:登录页顶部有「注册」Tab,填写组织名/邮箱/用户名/密码并同意服务条款即可。
- 如果平台关闭自助注册:Tab 会变成「联系我们」,显示企业微信二维码和管理员邮箱,需联系管理员开通账号。
忘记密码
点击密码框下方的「忘记密码」链接,按引导重置(具体行为依赖部署方接入的邮件服务)。
常见登录错误
| 提示 | 原因 | 处理 |
|---|---|---|
| 邮箱或密码错误 | 凭证错误 | 重新输入,3 次后建议改用「忘记密码」 |
| 账号已被禁用 | 管理员封禁 | 联系本组织管理员或超管 |
| 组织已过期 | 许可证到期 | 联系超管处理 许可证管理 |
| 第三方登录失败 | OAuth 配置错误 | 联系超管检查 SSO 配置 |
0.2 首页 / 平台总览 [U]
登录成功后进入首页 /。这是平台的导航中枢。
区块说明
- 顶部 Tagline — 平台一句话介绍 + 「文档中心」按钮(打开外部文档站)。
- 核心统计卡片 — 实时显示当前组织下:智能体数、编排器数、应用数、知识库数、技能包数等。数据每次进入首页时刷新。
- 快速导航(8 个):
- 智能体管理 →
/agent-system/agents - 编排器管理 →
/agent-system/orchestrators - 应用管理 →
/agent-system/applications - 技能包 →
/skills - 沙箱 →
/agent-system/sandboxes - MCP 工具 →
/mcp-tools - AI 模型 →
/ai-models - 知识库 →
/knowledge-base
- 智能体管理 →
- 快速入门 6 步指南:配置 AI 模型 → 创建智能体 → 装配编排器 → 发布应用 → 扩展 MCP 工具 → 部署沙箱。每一步都是可点击的快捷链接。
💡 建议第一次使用的同学先从快速入门 6 步走一遍。中间任何一步遇到不确定的字段,回到本手册对应章节查表即可。
0.3 平台架构速览
这一节不需要任何操作,但能帮你建立心智模型。
你(用户) → 应用(Application) → 编排器(Orchestrator) → 智能体(Agent) → LLM + 工具 → 回复
↑
知识库 + 技能包 + 沙箱三层关系
- 应用(Application) 是面向最终用户的渠道接入点。一个企业微信机器人、一个 Web 聊天页、一个对外 API 端点,都是「应用」。
- 编排器(Orchestrator) 是应用背后的"大脑组装方案"。它把一个或多个智能体按某种模式串起来,共有 8 种编排模式(后面会讲)。
- 智能体(Agent) 是最小执行单元。一个智能体 = 一个 LLM 模型 + 一段系统提示词 + 一组可调用工具 + 可选的知识库/技能包。
⚠️ 不要把这三层等同:同一个智能体可以被多个编排器复用;同一个编排器可以发布到多个不同渠道的应用。
8 种编排模式速记
| 模式 | 一句话 |
|---|---|
| Single | 只有一个智能体,最简单 |
| Supervisor | 一个主管 + 多个下属,按需分派 |
| Collaboration | 多个智能体顺序/并行协作,无主管 |
| Workflow | 预定义有向图(DAG),按节点执行 |
| Conditional | if-else 规则路由到不同智能体 |
| External | 整段流程外包给 Dify / n8n |
| DeepAgents | 主智能体可递归分解任务、调用子智能体、读取技能包 |
| KnowledgeBase | 直接走 RAG 检索回答,不走 LLM 推理链路 |
详细配置见 智能体系统 章节。
其他横向能力
- 知识库 — 给智能体配上"长期记忆"。文档解析(auto / markitdown / vlm / mineru,每库可选)→ 向量化 + 知识图谱 → 检索增强(LightRAG)。
- 技能包 — Markdown 写的"操作手册",运行时挂到沙箱让 AI 当文档查。仅在 DeepAgents / SINGLE+skills 路径生效。
- MCP 工具 — 通过 Model Context Protocol 给 AI 加"动手能力":查天气、读数据库、调外部 API。
- 沙箱 — 把 AI 行为隔离在每个员工自己的电脑里运行,带权限闸门和决策审计。
0.4 我现在该去哪一章?
| 我想... | 去这章 |
|---|---|
| 创建一个对话机器人 | 1.1 智能体系统 |
| 把内部 SOP 灌给 AI | 1.3 知识库 |
| 写一份 AI 操作脚本 | 1.2 技能包 |
| 让 AI 在我电脑上执行操作 | 1.5 我的沙箱 |
| 看本月花了多少 token | 1.6 用量统计 |
| 修改个人资料 / 改密码 | 1.7 账户设置 |
| 我是管理员,要给团队开账号 | 2.1 用户与组织 |
| 我是超管,要导入新许可证 | 2.3 许可证 |
| 我是审批员,要审核资源变更 | 2.9 资源审批 |