书名：《Agent Runtime 工程化：从工具调用循环到可恢复执行系统》
作者：陈堂会
章节：第四章 工具系统设计 / 4.3 工具版本演进
电子版系列：查看完整目录
第四章 工具系统设计：4.3 工具版本演进
工具一旦进入 trace 和 eval，就不能随意改语义。比如 read_file 原来默认返回全文，后来默认只返回前 200 行；这会影响模型行为，也会影响 replay 结果。
版本演进的策略：
- 工具名稳定时，小改动写入
version和 changelog； - 输入 schema 增加可选字段通常兼容；
- 删除字段、改变默认行为、改变输出结构，要视为破坏性变更；
- eval case 记录工具版本；
- replay 旧 trace 时使用旧 adapter 或迁移器。
很多团队低估了这一点。Agent 的'提示词版本'和'工具版本'共同决定行为，只版本化 prompt 是不够的。
系列导航
前 5 篇
- 第四章 工具系统设计：4.2 Schema：从 Zod 到 JSON Schema
- 第四章 工具系统设计：4.1 Tool Registry 的真正职责
- 第四章 工具系统设计：导读
- 第三章 最小 Agent Loop：3.9 验收标准
- 第三章 最小 Agent Loop：3.8 动手任务
