跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt

Use this file to discover all available pages before exploring further.

让用户要求 assistant 先给出计划,再继续执行。
计划模式是 ChatKit composer 中的一种工作模式,适合那些需要先明确范围、步骤和风险再执行的任务。它让用户可以要求 assistant 暂停下来,先说明准备如何处理,而不是直接进入实现或操作。

适用场景

计划模式适合用于:
  • 在实现前先审阅代码库
  • 拆解多步骤任务
  • 在多个方案之间先比较取舍
  • 对高风险或不可逆操作进行确认
  • 在执行前生成清晰的 checklist
它不会让普通聊天变重,但给了用户一个很明确的入口:当任务需要更谨慎时,可以主动切换到计划模式。

用户体验

用户可以在 composer 左侧的 + 菜单中打开计划模式。计划模式启用后,ChatKit 会在输入区上方显示一个简洁的 Plan 状态。 也可以使用 slash command:
/plan
/plan 先规划一下如何重构 checkout flow,并列出可能会修改的文件。
/plan 会切换计划模式;/plan <prompt> 会直接以计划模式提交后面的 prompt。

请求行为

当计划模式启用时,ChatKit 会在提交的用户输入和 state.human 中写入 planMode: true。后端工作流可以根据这个标记让模型先产出计划、路由到规划节点,或进入需要用户确认的流程。 代码中也可以通过同样的字段发起计划模式请求:
await chatkit.sendUserMessage({
  text: '先规划一下从 REST 端点迁移到 SDK 调用的步骤。',
  planMode: true,
});
计划模式不会绕过 ChatKit 的正常请求链路。消息仍然会经过当前 ChatKit session、已有权限、工具、运行时能力选择和后端工作流规则。

产品建议

计划模式应该是用户可控的能力,而不是替代后端安全规则的机制。assistant 仍然需要遵守 Xpert 中配置的工作流和策略约束。 好的计划模式回复通常应该:
  • 紧扣用户当前请求
  • 明确假设和未知点
  • 按执行顺序列出步骤
  • 标出哪些动作需要用户确认
  • 足够简洁,方便用户快速审阅
对于客服问答或简单 FAQ assistant,可以保留计划模式入口但不必强制使用。对于代码、运维、研究和多智能体工作流,建议让计划模式在 composer 菜单和 /plan 中都容易发现。