Agent 循环
面向 AI Agent:本页的 Markdown 版本位于 https://ankole.agentbull.com/zh-Hans-CN/docs/agent-loop/index.md,全站文档索引位于 https://ankole.agentbull.com/zh-Hans-CN/llms.txt。
主 Agent 循环运行在 Elixir 控制面的 Ankole.Sessions 模块中,每个执行会话由一个独立的 :gen_statem 状态机进程(Driver)推进。纯文本问答与控制面内置工具无需启动 Worker;环境工具与 Codex 任务会按需请求 Worker;创建 Agent 时也会在后台安排首次启动,详见 Agent Computer Worker。
一轮的持久步骤
- 准入待处理的开放 Signal,并在 PostgreSQL 中推进执行会话的纪元(epoch)。
- 根据已落盘的 Response 链重建当前执行进度,组装下一次模型请求。
- 通过 AIGateway 的进程内 Responses API 开启一条持久化 Response。
- 按照工具声明,将调用分发给控制面内置工具、Worker 实例或持久化等待(Durable Wait)的协调模块。
- 在同一个数据库事务内,原子提交整轮工具返回结果、满足等待条件的输入消费记录,并删除执行回执。
- 在步骤边界处注入新排队的输入继续推进,或提交最终回复并将本轮输入标记为已完成。
职责划分上,对话转录、上下文压缩、记忆注入与托管工具(Hosted Tools)由 AIGateway 负责;最大迭代轮数限制、空回复自愈、重复报错提示以及最终回复判定规则由会话 Driver 负责。控制面内的所有模型推理循环都统一复用这套驱动机制,唯独 Codex 任务在 Worker 内部维护独立的模型循环。
恢复与副作用
一旦控制面进程重启或发生迁移,新启动的 Driver 会直接从 Signal 记录与 Response 链重建执行进度。由于控制面内置工具的业务副作用与执行回执在同一个数据库事务内提交,已经写入链中的工具结果不会重复执行。对于发往 Worker 的环境工具调用,系统通过 Response ID 与 call ID 联合标识:若仅是控制面重连,新 Driver 可直接接管仍在运行的调用;若 Worker 进程意外消失,系统仅重试无副作用的安全调用,其余无法确认执行状态的调用统一返回 interrupted。
运行期间收到普通新输入时,系统会等到当前步骤抵达安全边界后再行注入。收到停止指令或合法的重试(retry)指令时,会立即中断当前工作;若带目标的重试指令指向了无效目标,则不打断当前执行。如果在工具调用已产生记录后触发撤回或无目标重试,已有的工具记录会保留在链中,系统通过在同一条链上追加修订指令来继续推进。
有界失败
重试预算分两层管控:AIGateway 负责单轮请求内部的瞬时重试,会话 Driver 负责跨尝试(attempt)的恢复重试。普通输入在连续第 6 次准入仍未成功时转入死信状态。遇到计划内优雅停机时,若回退事务提交成功,系统会退还已准入消耗的当次尝试次数;进程意外崩溃则不予退还。Workflow 与后台 Job 各自维护独立的重试预算。
延伸阅读:单写者互斥规则见 Sessions,环境工具执行与持久化目录见 Agent Computer Worker,持久化 Response 链见 AIGateway。