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 状态机中的隐含顺序

  • pendingprocessingready →(可选)trainingtrained
  • 训练、发布、检索等操作都依赖当前状态,本质是“关键顺序”在状态维度的体现。

三、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 助手与用户对话时,可采用以下方式让引导更有逻辑:

  1. 先定状态,再给下一步

    • 例:“您当前知识库状态是「处理中」。建议先等待变为「就绪」,再进行「发布为专家」和「专家模型训练」。”
  2. 用步骤列表替代长段落

    • 例:“要上线生产环境,请按顺序完成:① 确认知识库已就绪 ② 发布为专家 ③ 完成专家模型训练 ④ 在终端/Web 中选择该专家提问。”
  3. 错误时给出“下一步”而不是只报错

    • 例:API 返回“知识库未就绪”时,界面或对话中补充:“下一步:在「知识库」页查看处理进度,状态为「就绪」后再点击「开始训练」。”
  4. 关键顺序的简短口诀

    • 例:“先建库、再上传、等就绪、必训练、后发布。” 用于文档或首屏提示。
  5. 在对话中提供检查清单(Checklist)

    • 例:“请确认:□ 知识库已创建 □ 已上传文档 □ 状态为就绪 □ 已发布为专家 □ 已完成专家模型训练(生产环境)。”
  6. 区分“可选”与“必须”

    • 明确说“专家模型训练在生产环境是必须的,动态专家仅用于原型/测试”,避免用户误以为可以跳过训练。

以上方法可直接用于产品文案、API 错误说明、帮助中心以及任何与用户对话的脚本或提示词中。


四、总结

维度 已有 可扩展
文档 流程中有“必须:专家模型训练”和状态说明 在流程文档中增加「关键顺序」小节,并引用本文
API 部分接口可能有状态校验 统一对训练/发布/上传做前置条件校验,并返回“下一步”建议
UI 有状态与按钮 步骤条、按顺序禁用按钮 + Tooltip、简短推荐顺序说明
对话/引导 无统一规范 状态→下一步、步骤列表、检查清单、口诀、必须/可选区分

CRITICAL SEQUENCE 在文档、API、UI 和对话中统一显式化,能减少误操作、提升可维护性,并在与用户对话时给出更清晰、更有逻辑的引导。