Plan 系统

WesCraft 的 AI Agent 可以通过 Plan 系统管理多步任务。Plan 是一个线性清单，由 AI 创建和驱动，帮助你追踪复杂任务的执行进度。

什么是 Plan

Plan 是 AI 在执行复杂任务时创建的步骤清单。它解决了一个常见问题：当你让 AI 完成一个大任务时，你不知道它在做什么、做到了哪一步、还剩多少。

Plan 的核心特点：

Plan 工具的三个动作

AI 通过 plan 工具管理 Plan，支持三个动作：

1. create — 创建计划

AI 分析任务后创建步骤清单：

plan(action=create, steps=[
  "分析现有文件结构",
  "创建索引页面",
  "整理分类标签",
  "生成摘要内容",
  "检查链接完整性"
])

2. update — 更新步骤状态

AI 完成某个步骤后更新其状态：

plan(action=update, task_id=0, status=done)
plan(action=update, task_id=1, status=in_progress)

步骤状态包括：

3. complete — 完成计划

所有步骤完成后收口：

plan(action=complete)

complete 会将剩余未完成的步骤标记为 done，表示 AI 认为整个任务已完成。

Plan 在侧边栏的展示

Plan 创建后，侧边栏会显示一个进度追踪器：

Plan 中断时（如对话被取消或出错），侧边栏保留当前进度，重新对话可继续。

步骤状态流转

步骤的状态遵循线性流转规则：

pending → in_progress → done
              ↘ skipped

使用建议

  1. 适合复杂任务：Plan 适合 3 步以上的任务，简单问答无需 Plan
  2. 观察而非干预：Plan 由 AI 驱动，你只需观察进度
  3. 中断安全：即使对话中断，Plan 进度不会丢失
  4. 多步验证：AI 在每步完成后会验证结果，失败时给出建议

与 Nudge 机制

当 AI 准备结束对话但 Plan 中仍有未完成步骤时，引擎会自动提醒 AI 继续（称为 nudge）。nudge 最多触发 3 次，耗尽后对话正常结束，未完成的步骤保留 pending 状态。

相关文档