图解 Agent 系统

一轮工具调用后，谁决定下一步？ ​

返回横向对照

假设模型要求运行一条命令，命令已经返回。**工具返回只是一个观察点，不等于 Agent 结束。**下一步可能再请求模型、等待当前调用或人工处理、也可能结束；决定权落在各项目的循环和停止契约中。下表对齐的是固定源码的一条路径，不是四个产品的功能排名。四篇均于 2026-09-23 核对，均为静态源码阅读，未录制同一任务的运行轨迹。

四种循环的续跑与停止闸口

查看原尺寸 SVG（可缩放）

图的文字版 · 可编辑图源 · PNG 预览

固定范围触发：谁决定下一步状态：看什么工具结果写回停止、拒绝与等待
Pi 核心循环runLoop；finishTurn 可改判。消息、工具批次、steering / follow-up 队列。tool result；执行失败标 isError。finishTurn=end 优先停；steering 等轮间，follow-up 等结束点。
mini-SWE 基类run() 每轮检查消息尾部。messages[-1].role。环境 observation 追加到 messages。尾部 exit 返回；格式错误可反馈再试，一般异常重抛。
OpenCode 会话processor 返回结果；runLoop 再判断。ToolPart 状态与会话状态分开。tool-result/error 收束 part。stop 结束；模型流故障可在 processor 内退避重试；compact 转压缩。
Kimi Code 单 turnrunTurn；非 tool_use 时问停止回调。steer 缓冲、步数、取消信号。工具批次排空 tool.result 事件。tool_use 续步；steer 等步边界；取消/上限可终止。

固定源码证据 ​

怎样读这些差别 ​

Pi 和 Kimi Code 都有“忙时新输入”，但等待点不相同：Pi 明分 steering 与 follow-up 两条队列；Kimi Code 将活动 turn 的 steer 暂存在 steerBuffer，在下一 step 或停止回调处刷新。mini-SWE-agent 的基类把结束折成消息尾部 exit；OpenCode 同时保留调用级的 ToolPart 和会话级的处理器结果。这些是控制结构差异，不是速度、可靠性或用户体验的实测比较。

读者练习：给四套路径各放入“命令返回权限错误，随即用户又发来一句新指令”。先标出错误进入哪种账本或状态，再指出下一次模型请求之前必须经过哪个判断。若证据只覆盖基类、单 turn 或处理器，不要替缺失的 CLI/提供商行为补答案。

失败与未知 ​

  • 失败不自动重试。 Pi 的工具错误可成为 isError 结果；mini-SWE-agent 的格式错误反馈与一般异常分流；OpenCode 仅对策略接受的模型流故障退避重试；Kimi Code 此切面仅证明工具批次、停止与授权闸口，未验证工具拒绝消息如何呈现。
  • 覆盖范围不等。 Pi 行连接 agent-core 与部分 coding-agent 外壳；mini-SWE-agent 只覆盖 DefaultAgent/本地环境，默认 CLI 的交互子类另算；OpenCode 只读 session 路径，未审计所有 provider、MCP 和插件；Kimi Code 只读 agent-core 的单个 turn，未追踪 CLI 输入接线、外层 goal 运行或持久化恢复。
  • 均无同任务运行观察。 没有测并发工具副作用、人工等待时长、取消竞态、故障恢复或发布版本对应关系。正文中的“可继续”只说明固定源码允许该分支，不承诺现实任务一定成功。

图的文字说明 · loop-and-stop ​

图按行读，不是四个项目串行执行的流程。每行先给出固定源码切面，再从“工具结果写回”走向该系统自己的控制闸口：

  1. Pi：tool result 进入 runLoop 的消息路径。steering 等轮间，follow-up 等本来将结束时；finishTurn=end 可优先结束。
  2. mini-SWE-agent：环境观察进入 messages；DefaultAgent.run() 在一轮保存后看最后消息，非 exit 再循环，exit 则返回其 extra。
  3. OpenCode：流事件把结果写成 ToolPart.completed/error；SessionProcessor 的 continue/stop/compact 与外层 runLoop 才决定后续。图中的“流内 retry”指模型流处理器内按策略退避，不是与 continue/stop/compact 并列的返回值；调用级 error 本身也不等于重试。
  4. Kimi Code：工具批次排空 tool.result 事件；tool_use 后 runTurn() 进入下一 step。活动 turn 收到的 steer 在 step 边界刷新；无继续请求、取消或上限可能结束当前 turn。

方框颜色仅帮助辨认四行，不表示性能或证据强弱。图省略了各项目的 provider、CLI、并行工具副作用和恢复路径；具体停止/拒绝分支及固定 SHA 见正文表格。四行均是 2026-09-23 核对的固定源码静态切面，不是一条实际运行轨迹。mini-SWE-agent 行特指基类加本地环境；Kimi Code 行限单个 turn；Pi 行含部分 coding-agent 外壳；OpenCode 行限 session 路径，因此证据粒度不等。

在线预览稿：书稿仍在校稿，系统篇以文内固定源码版本为准；静态阅读不等于运行验收。