V2 系统操作手册
本手册适用于组织管理员、业务负责人和运营人员。当前线上运行只使用 V2 资产；草稿、旧版配置或未完成资源绑定都不会成为线上 AI 成员的行为依据。
先认识四个对象
系统把“怎么做业务”和“谁来运行”分开管理：
| 对象 | 用来解决什么 | 主要入口 |
|---|---|---|
| 团队基础资产 | 沉淀可复用的语义、数据、能力和事件/SOP 边界 | /builder/v2-assets/foundation |
| AI 员工技能 | 定义一件完整工作，例如答疑、留资、预约或查询 | /builder/v2-task-packages |
| AI 员工岗位 | 将技能编排为一个可运行的业务方案，并声明资源要求 | /builder/v2-assets/business |
| 团队 AI 成员 | 绑定已发布岗位、知识和 MCP 等实际资源，并接入渠道 | /builder/v2-agents |
可以把它理解为：基础资产和技能提供能力边界，岗位定义业务方案，AI 成员负责本组织的实际运行配置，接待账号把 AI 成员接入客户消息。
上线顺序
建议按照以下顺序操作：
- 完成组织、成员和模型等基础配置。
- 准备团队资产、技能和 AI 员工岗位；先保存草稿，再通过预检和发布。
- 在知识中心和知识库配置中准备可用知识来源；需要外部系统时接入 MCP 服务。
- 创建团队 AI 成员，选择已发布岗位，并绑定本组织的知识、FAQ、MCP 等实际资源。
- 创建接待账号和渠道配置，将其绑定到 AI 成员。
- 用「模拟客户对话」验证，再从运行追踪和审批待办持续观察与优化。
组织、成员与模型
入口：/org、/account、/org-models
- 在“组织管理”确认当前组织、成员和权限；新成员可通过邀请加入。
- 在“账户身份”维护登录与第三方身份绑定。
- 如使用组织自有模型，在“大模型配置”中配置并验证可用性。
- 需要同步渠道数据或定时任务时，到“任务调度”查看任务状态和执行历史。
验收标准：操作人员处于正确组织，具备对应管理权限；运行所需模型和渠道任务均为可用状态。
建立 V2 团队资产
入口：/builder/team-assets
“团队资产地图”是最适合开始的入口。它把资产分为基础资产、AI 员工技能、AI 员工岗位和团队 AI 成员四层，并说明每一层应维护什么。
团队基础资产
入口：/builder/v2-assets/foundation
这里维护跨岗位复用的基础定义，例如：
- 客户表达、语义与字段结构；
- 可选择的能力边界，以及读写能力的风险约束；
- 事件、SOP 和需要保留的业务事实；
- 可复用的话术关系、资源要求和校验规则。
基础资产应描述通用边界，不应写入某一产品、行业或单一客户的临时话术。业务差异应放在岗位的业务方案中。
AI 员工技能
入口：/builder/v2-task-packages
技能是一件可复用的完整工作，而不是话术分类。例如“收集预约信息”“查询解决方案和案例”“回答产品问题”都可以是技能。技能应明确：何时适用、需要哪些事实、能调用哪些能力、如何推进状态，以及如何验收。
修改技能后，保存草稿并发布任务版本。线上 AI 成员只会在后续处理时使用已发布的版本。
AI 员工岗位
入口：/builder/v2-assets/business
岗位把多个技能编排为一个业务方案，并补充该方案的业务词汇、资源要求、默认运行策略和发布校验。这里是业务规则和业务场景的主要归属；不要把业务判断写进运行时代码或 AI 成员实例。
岗位发布前，请确认：
- 所引用的技能和基础资产已经可解析；
- 所需的知识、FAQ 和 MCP 要求已经声明；
- 预检没有阻断项；
- 已发布闭包和回归用例覆盖关键业务场景。
保存只是更新草稿；通过预检并发布后，岗位的当前版本才可供 AI 成员运行。系统模板由平台统一维护；组织需要使用时，先创建组织草稿，再补齐本组织资源并发布。
配置知识与外部服务
知识中心
入口：/agents/knowledge-center
“知识中心”用于将文件、链接或 Markdown 素材整理为 FAQ 或 RAG 语料。先检查原文、转换内容和待审核草稿，再发布或同步到目标知识来源。知识内容应保持来源清晰、可维护、可追溯。
知识库配置
入口：/agents/knowledge
“知识库配置”用于维护组织的 RAGFlow 连接和数据集等检索配置。它是知识来源的连接与数据集配置，不是运行中 AI 成员的业务方案。准备完成后，还需要在 AI 成员中绑定实际可用的知识资源。
MCP 服务
入口：/agents/mcp-services
“MCP 服务”用于接入组织的业务系统工具。先完成服务配置和能力同步，再在岗位中声明所需能力，最后由 AI 成员绑定本组织实际使用的服务和工具。
使用 MCP 时请区分读与写：查询类能力可用于查找产品、方案、案例等信息；会创建、修改或提交业务数据的能力必须在资产中声明授权、审批和幂等边界。没有完成绑定、授权或服务校验时，不应把它当作可用的线上能力。
创建和维护团队 AI 成员
入口：/builder/v2-agents
- 选择一个已发布的 AI 员工岗位或适用的系统模板。
- 创建 AI 成员，填写名称、角色说明和运行配置。
- 绑定岗位所要求的 FAQ、RAG 知识库和 MCP 服务等实际资源。
- 核对风险与审批策略；高风险操作应进入审批，而不是绕过边界直接执行。
- 保存后，在成员详情确认当前业务包、资源绑定和运行状态。
AI 成员保存的是组织级运行配置，不应承担业务规则。答复不准确、流程遗漏或工具选择错误时，优先从岗位、技能、基础资产、知识来源和 MCP 绑定中定位原因，再修改对应资产并发布。
接待账号与渠道
入口：/robots、/robots/{robotId}
- 创建接待账号，维护基础信息。
- 按渠道完成 Web、企业微信客服、公众号、个人微信、小店或抖音等配置。
- 将接待账号绑定到已配置完成的团队 AI 成员。
- 从“模拟客户对话”（
/web-chat）发送测试消息，确认上行消息、AI 处理和下行回复都正常。
接待账号负责渠道接入，AI 成员负责决策和执行。更换渠道或接待账号不等于改变业务方案；需要改变业务行为时，应回到 V2 资产和岗位中修改。
接待、客户与运行观察
常用入口：
- 接待工作台：
/cs/all、/cs/{渠道} - 客户管理：
/customers - 线索：
/agents/leads - 运行追踪：
/agents/traces - 审批待办：
/agents/approvals - 交接与运营：
/agents/handoffs、/agents/operations
在接待工作台查看会话、客户上下文和人工协作；在客户管理中维护客户与多渠道身份；在运行追踪中核对每次处理使用的资产、资源和决策结果。对于需要人工确认的动作，统一在审批待办中处理。
日常优化与排查
| 现象 | 优先检查 | 常见处理方式 |
|---|---|---|
| 客户消息没有回复 | 接待账号绑定、渠道消息是否入站、AI 成员是否可运行、运行追踪 | 修复渠道或成员绑定，再重新测试 |
| 回答不准确或不符合业务 | 岗位/技能边界、知识来源、精准问答、实际 MCP 查询结果 | 修改对应资产或知识，验证后发布 |
| 知识没有命中 | AI 成员的知识资源绑定、数据集和索引状态、用户问题 | 修复来源或绑定，避免仅靠改提示词掩盖问题 |
| MCP 不可用或查不到数据 | 服务连接、能力同步、工具授权、AI 成员的实际绑定 | 先恢复服务与绑定，再验证查询结果 |
| 发布后未生效 | 当前内容是否已发布、发布预检、成员引用的岗位与运行记录 | 发布正确版本，并以新的运行记录确认 |
| 高风险动作未执行 | 资产的授权/审批约束、审批待办和事件状态 | 依流程完成审批；不要用人工改配置绕过风险门禁 |
每次优化建议保留一个可复现的客户场景：先在已发布基线下观察，再调整草稿、执行预检或回放，确认后发布，并用新的真实或测试会话验证。
上线前检查清单
- [ ] 组织、成员权限、模型和渠道配置正确。
- [ ] 所有上线业务逻辑均来自 V2 基础资产、技能和已发布岗位。
- [ ] 岗位所需知识、FAQ、MCP 和审批要求已经声明。
- [ ] 团队 AI 成员已绑定实际可用的资源，且无缺失项。
- [ ] 接待账号已绑定正确 AI 成员，「模拟客户对话」验证通过。
- [ ] 关键问答、查询、转人工和高风险动作已有验收场景。
- [ ] 运行追踪、审批待办和负责人已准备好用于上线后观察。
完成以上检查后再对外开放渠道。后续遇到问题，应从运行记录回溯到资产、资源或绑定关系，修复源头后重新验证和发布。