MBE 关键顺序(CRITICAL SEQUENCE)与用户逻辑引导
一、CRITICAL SEQUENCE 定义
关键顺序(Critical Sequence) 指 MBE 中必须按固定顺序执行、且不可跳过或颠倒的步骤链。违反顺序会导致操作失败或结果无效。
当前 MBE 中已存在的关键顺序如下。
二、MBE 中已有的关键顺序
2.1 知识库建立关键顺序(KB Critical Sequence)
创建知识库 → 上传文档 → [自动] 文档处理 → 知识库就绪(ready) → [必须] 专家模型训练 → 可用于生产
| 步骤 | 说明 | 违反后果 |
|---|---|---|
| 1. 创建知识库 | 先有 kb_id 与配置 | 上传/训练无目标 |
| 2. 上传文档 | 在已创建的知识库下上传 | 无内容可处理 |
| 3. 文档处理 | 系统自动:提取→分块→向量化→就绪 | 依赖 1、2 |
| 4. 知识库就绪 | status=ready | 无法发布/训练 |
| 5. 专家模型训练(必须) | 生产环境必须训练 | 仅能使用动态专家,推理能力弱 |
文档出处: MBE_KNOWLEDGE_BASE_COMPLETE_WORKFLOW.md 流程概览与阶段 11。
2.2 用户使用关键顺序(User Usage Critical Sequence)
知识库就绪 → 发布为专家 → [必须] 专家模型训练 → 专家路由 → RAG 检索 → 答案生成 → 用户终端
| 步骤 | 说明 | 违反后果 |
|---|---|---|
| 1. 知识库就绪 | ready | 无法发布 |
| 2. 发布为专家 | 创建动态专家配置 | 用户无法选到该专家 |
| 3. 专家模型训练(必须) | 生产标准 | 仅原型/测试可用 |
| 4. 专家路由 | 用户提问时匹配专家 | 无法进入检索与生成 |
文档出处: MBE_USER_USAGE_COMPLETE_WORKFLOW.md 流程概览与阶段 11–13。
2.3 状态机中的隐含顺序
pending→processing→ready→(可选)training→trained- 训练、发布、检索等操作都依赖当前状态,本质是“关键顺序”在状态维度的体现。
三、CRITICAL SEQUENCE 还可应用的场景
3.1 API 层:前置条件校验
| 场景 | 建议 | 目的 |
|---|---|---|
启动训练 POST /admin/training/start |
校验 kb 存在且 status === 'ready',否则 400 + 明确错误码/文案 |
避免对未就绪 KB 发起训练 |
发布专家 POST /admin/knowledge/expert/publish |
校验 kb 存在且 status === 'ready' |
避免对未就绪 KB 发布 |
上传文档 POST /admin/knowledge/upload/{kb_id} |
校验 kb 存在且 status === 'pending' 或允许 ready(追加) |
保证“先创建再上传” |
| 检索/问答 | 校验专家已发布且(若生产)已训练 | 保证“先发布/训练再使用” |
错误响应中可带上 下一步建议,例如:"knowledge_base_not_ready": "请先等待知识库处理完成(status=ready)后再启动训练。"
3.2 前端 UI:步骤可见性与禁用逻辑
| 位置 | 建议 | 目的 |
|---|---|---|
| 知识库详情/列表 | 按“关键顺序”展示进度条或步骤条:创建→上传→处理→就绪→训练 | 用户一眼看到当前处于哪一步、下一步是什么 |
| 「发布为专家」按钮 | 若 status !== 'ready' 则禁用,Tooltip: “请先完成文档上传并等待处理完成” |
避免无效点击 |
| 「开始训练」按钮 | 若 status !== 'ready' 或未发布则禁用,Tooltip: “请先确保知识库已就绪并已发布为专家” |
与 API 校验一致 |
| 训练页 / 专家页 | 简短“推荐顺序”说明或链接到本文档/流程文档 | 新用户按顺序操作 |
3.3 文档与帮助:统一入口
| 位置 | 建议 | 目的 |
|---|---|---|
MBE_KNOWLEDGE_BASE_COMPLETE_WORKFLOW.md |
在流程概览下增加 「关键顺序(Critical Sequence)」 小节,引用本文并列出 1–5 步 | 开发/运维一处查全 |
MBE_USER_USAGE_COMPLETE_WORKFLOW.md |
同样增加关键顺序小节(用户使用侧) | 与 KB 侧对称 |
| 内嵌帮助 / FAQ | “为什么不能训练?”→ 指向“知识库必须先就绪”;“为什么推荐训练?”→ 指向“生产必须训练” | 减少重复提问 |
3.4 与用户对话时:更富逻辑的引导方法
在客服、文档说明或 AI 助手与用户对话时,可采用以下方式让引导更有逻辑:
先定状态,再给下一步
- 例:“您当前知识库状态是「处理中」。建议先等待变为「就绪」,再进行「发布为专家」和「专家模型训练」。”
用步骤列表替代长段落
- 例:“要上线生产环境,请按顺序完成:① 确认知识库已就绪 ② 发布为专家 ③ 完成专家模型训练 ④ 在终端/Web 中选择该专家提问。”
错误时给出“下一步”而不是只报错
- 例:API 返回“知识库未就绪”时,界面或对话中补充:“下一步:在「知识库」页查看处理进度,状态为「就绪」后再点击「开始训练」。”
关键顺序的简短口诀
- 例:“先建库、再上传、等就绪、必训练、后发布。” 用于文档或首屏提示。
在对话中提供检查清单(Checklist)
- 例:“请确认:□ 知识库已创建 □ 已上传文档 □ 状态为就绪 □ 已发布为专家 □ 已完成专家模型训练(生产环境)。”
区分“可选”与“必须”
- 明确说“专家模型训练在生产环境是必须的,动态专家仅用于原型/测试”,避免用户误以为可以跳过训练。
以上方法可直接用于产品文案、API 错误说明、帮助中心以及任何与用户对话的脚本或提示词中。
四、总结
| 维度 | 已有 | 可扩展 |
|---|---|---|
| 文档 | 流程中有“必须:专家模型训练”和状态说明 | 在流程文档中增加「关键顺序」小节,并引用本文 |
| API | 部分接口可能有状态校验 | 统一对训练/发布/上传做前置条件校验,并返回“下一步”建议 |
| UI | 有状态与按钮 | 步骤条、按顺序禁用按钮 + Tooltip、简短推荐顺序说明 |
| 对话/引导 | 无统一规范 | 状态→下一步、步骤列表、检查清单、口诀、必须/可选区分 |
将 CRITICAL SEQUENCE 在文档、API、UI 和对话中统一显式化,能减少误操作、提升可维护性,并在与用户对话时给出更清晰、更有逻辑的引导。