Agent执行循环

重复进行观察、行动、反馈与状态更新的执行过程。

一轮交互并不等于一次模型请求。用户可能在Agent搜索期间补充限制；模型可能一次请求多个工具，再根据结果继续推理；一次业务任务也可能经过多个交互turn。将Session、Turn、Step和ModelCall分开记录，才能解释一次操作为什么发生，以及哪个输入在当时有效。

Codex固定源码的run_turn在step边界消费待处理输入，执行hooks，并捕获该步的上下文。注释强调，context、模型可见工具和实际调用需要共享同一份请求视图。这避免模型按照旧工具定义作出决定，执行器却按新定义解释参数。该源码说明了公开CLI的设计，不能据此断言所有桌面或托管版本完全相同。

推荐的循环先读取已提交状态和新输入，再组装当前上下文；模型请求完成解析后，验证每个完整工具调用；对写操作预先持久化操作身份与意图，再交网关执行；工具回执和错误落盘后，才判断继续、等待或输出候选。流式文字可以先展示，但不能把半个JSON对象当可执行命令。取消和用户纠正应有明确入口，而非任意线程直接修改messages数组。

停止也是循环的一部分。最终输出、预算耗尽、权限不足、用户取消和结果未知是不同状态。模型没有再请求工具不一定代表工作完成，工具失败也不一定应该立即重试。测试应覆盖多工具并发、工具结果缺失、断流、插话和完成前取消，并检查持久事件能否解释每次状态转换。

例如用户先要求比较三家公司，Agent运行中又补充“只用截止昨日可见资料”。这条补充应在下一个step进入权威任务限制，并使已取得的不合格资料退出候选。若后台子Agent仍按旧截止日工作，父loop必须识别其产物版本，不能直接混入最后报告。这样的测试比只检查循环能跑十轮更接近企业需求。

实践重点：按turn与step消费输入；记录每次模型和工具结果，再决定继续、等待或完成。

验证抓手：检验工具失败、用户插话、预算耗尽及无工具最终输出。

常见误区：只写while直到模型说完成，没有预算、取消和恢复。

Codex：turn与step循环源码；Claude Code：工作原理。