书名：《Agent Runtime 工程化：生产级 AI Agent 架构、运行时与工程实践》
作者：陈堂会
平台：极客日志（https://zeeklog.com）
X：@Megick_com
联系邮箱：[email protected]
章节：附录
附录 A 术语表
Agent：根据目标和上下文选择下一步行动的执行体。
Agent Runtime：负责模型调用、工具调用、上下文、权限、状态、观测、恢复、评测和成本治理的运行系统。
Tool Calling：模型输出结构化工具调用，应用执行工具并把结果返回模型的接口能力。
Tool Registry：工具定义、schema、风险等级、执行器、输出策略和版本的注册中心。
Observation：工具执行或环境反馈给模型的观察结果。
Step：一次模型决策或工具执行推进。
Turn：一次用户请求对应的交互轮次。
Run：从收到用户请求到完成、失败或取消的一次完整执行。
Session：用户和 Agent 的长期上下文容器。
Trace：记录一次 run 执行路径的可观测数据。
Span：trace 中的单个操作单元，例如模型调用、工具执行、权限审批。
Checkpoint：可恢复状态快照。
Rollback：恢复文件、会话或外部副作用补偿的操作。
MCP：Model Context Protocol，用于 LLM 应用与外部数据、工具、上下文能力连接的开放协议。
Context Builder：按预算和优先级为模型构建上下文的组件。
Eval Harness：运行评测任务、收集指标、做回归门禁的测试系统。
附录 B mini-agent 学习路线
第 1 周：实现只读 mini-agent。完成 list_files、read_file、shell_readonly，输出 trace JSON。
第 2 周：实现工具治理。加入 edit_file、apply_patch、run_command、search_code，补 schema 校验、风险等级和审批。
第 3 周：实现上下文工程。加入 repo map、历史摘要、工具结果截断、context debug report。
第 4 周：接入 MCP 和 Provider Adapter。至少支持一个真实 provider 和一个 mock provider。
第 5 周：实现 checkpoint/resume/rollback。文件写入有 patch，恢复不重复执行高风险工具。
第 6 周：实现 eval harness。至少 30 个 eval case，CI 可运行，报告能看出失败归因。
附录 C 代码清单索引
| 章节 | 代码主题 |
|---|---|
| 第 1 章 | Agent Loop 伪代码 |
| 第 2 章 | timeout、AbortSignal、子进程执行器 |
| 第 3 章 | ModelResponse、ToolCall、最小工具 |
| 第 4 章 | ToolDefinition、风险等级、审批请求 |
| 第 5 章 | Context Builder 输入输出、debug report |
| 第 6 章 | MCP 工具包装、Provider Adapter |
| 第 7 章 | workspace path 校验、命令风险分类 |
| 第 8 章 | Checkpoint schema、tool ledger |
| 第 9 章 | trace/span JSON、TraceWriter |
| 第 10 章 | eval case schema、mock model、CI 报告 |
| 第 11 章 | 进阶路线图、90 天学习计划 |
| 第 12 章 | hermes-agent 源码地图、Tool Evidence Event |
附录 D 出版校对清单
- 术语是否统一：Runtime、Agent Loop、tool call、observation、checkpoint、trace、eval。
- 所有'截至 2026 年 8 月 14 日'的事实是否需要更新。
- 图片中的文字是否清晰准确。
- 代码是否按目标 Node.js 版本跑通。
- 权限、安全、隐私段落是否避免绝对化承诺。
- 开源项目描述是否只基于公开事实。
- hermes-agent 实战章是否标注源码 commit 与事实来源边界。
- 每章是否都有动手任务和验收标准。
- 目录与正文标题是否一致。
系列文章目录
- 《Agent Runtime 工程化》完整目录
- 《Agent Runtime 工程化》第一章 Agent Runtime 全景
- 《Agent Runtime 工程化》第二章 TypeScript / Node Runtime 基础
- 《Agent Runtime 工程化》第三章 最小 Agent Loop
- 《Agent Runtime 工程化》第四章 工具系统设计
- 《Agent Runtime 工程化》第五章 上下文工程
- 《Agent Runtime 工程化》第六章 MCP 与 Provider 抽象
- 《Agent Runtime 工程化》第七章 权限与安全边界
- 《Agent Runtime 工程化》第八章 Checkpoint、Resume、Rollback
- 《Agent Runtime 工程化》第九章 可观测与 Trace
- 《Agent Runtime 工程化》第十章 Eval Harness 与 CI 回归
- 《Agent Runtime 工程化》第十一章 Agent Runtime 进阶学习路线
- 《Agent Runtime 工程化》第十二章 hermes-agent 产品级实战
- 《Agent Runtime 工程化》附录