Docs核心功能Agent Loop
返回文档
核心功能

Agent Loop

理解 YeePilot 的分阶段任务流程,包括规划、执行、验证和受限恢复。

最后更新: 2026年5月12日

这对终端用户意味着什么

YeePilot 不只是一次提问和一次回答。面对较大的任务时,它会按阶段推进:

  1. 理解目标
  2. 收集上下文
  3. 提出计划
  4. 执行已批准的操作
  5. 验证结果
  6. 出错时在安全范围内尝试恢复
  7. 最后给出总结

文档中把这种行为称为 Agent Loop。

您会在什么时候注意到它

通常出现在这些场景:

  • 使用 /plan <task>
  • 需要处理多个文件
  • 请求诊断、修复或迁移
  • 任务在执行后还需要验证

当前交互客户端默认已经使用新的 agentic runtime。正常使用时不需要再去开启旧式的独立 "agent mode"。

最重要的控制项:/plan

如果您希望 YeePilot 更显式、更有结构地工作,请使用 plan mode:

text
/plan on
/plan status
/plan Review this repo and propose the safest way to add health checks

/plan on 会让 plan-first 在当前会话持续生效。只想用于单个任务时,可直接使用 /plan <task>

Autonomy profiles

autonomy 决定 YeePilot 在计划之后会主动推进到什么程度:

text
/autonomy status
/autonomy guarded
/autonomy strict_review

可用配置:

  • high
  • guarded
  • strict_review
  • ultra

通常建议:

  • 日常任务用 guarded
  • 涉及生产环境或高风险变更时用 strict_review

验证与恢复

当 YeePilot 修改文件或执行有影响的流程时,它会尽量用可验证的证据结束任务,例如:

  • 命令成功执行
  • 构建成功
  • 测试通过
  • 服务检查或 health check 成功

如果验证失败,YeePilot 会进行有边界的恢复尝试,而不是无限循环。

vibe_coding 与本地修改能力

有些计划或订阅允许本地代码编辑和文件变更工具,有些则不允许。对终端用户来说,这个能力会以 vibe_coding 的形式出现。

实际规则很简单:

  • 如果计划允许且本地已开启 vibe_coding,YeePilot 就能使用本地代码和文件修改工具
  • 如果本地关闭,或计划不允许,这些工具就保持禁用

当您的当前计划允许时,可以在 HUD 的 Settings 中查看或修改。

更稳妥的使用方式

  1. /plan <task> 开始
  2. autonomy 保持在 guardedstrict_review
  3. 先附上相关文件
  4. 检查验证结果
  5. 需要共享记录时导出会话