书名：《Agent Runtime 工程化：从工具调用循环到可恢复执行系统》
作者：陈堂会
平台：极客日志（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。
