Hermes · 第 2 章 内循环：Agent Loop 全解剖

Hermes · 第 2 章 内循环：Agent Loop 全解剖

章节摘要：本章进入内循环层——所有 agent 共有的会话主循环。主角是 run_agent.py（9215 行）中的 AIAgent 类：约 60 个构造参数、同步 while 循环、可中断的 LLM 调用；三种 API 模式（chat_completions/codex_responses/anthropic_messages）统一收敛到 OpenAI 消息格式；消息交替规则、迭代预算（父子共享）与优雅退出；以及 prompt 组装流水线。内循环是双循环的骨架——外循环的一切改进，最终都要通过这个循环生效。

循环坐标

学习目标

• 读懂 AIAgent 类结构与约 60 个构造参数的职责划分
• 理解同步 while 循环与可中断 API 调用的控制流设计
• 掌握三种 API 模式如何统一收敛到 OpenAI 消息格式
• 弄清迭代预算（父子共享）、消息交替规则与优雅退出机制
• 走通 prompt 组装流水线，为第 6 章缓存铁律打底

子章节导航

01 AIAgent 类与 60 个构造参数

run_agent.py 骨架走读：类结构、构造参数全景、同步循环与可中断调用。

02 三种 API 模式收敛

chat_completions+codex_responses+anthropic_messages 统一到 OpenAI 消息格式的适配内幕与消息交替规则。

03 迭代预算、优雅退出与 prompt 组装

迭代预算父子共享、优雅退出信号，以及 agent/prompt_builder 的 prompt 组装流水线。

前置知识与后续延伸

前置：第 1 章双循环地图与读码约定。后续：第 3 章解剖内循环的"手"——工具系统。