Tool Schema 或行为升级时,如何做版本兼容?
题目
Tool Schema 或行为升级时,如何做版本兼容?
参考答案
点击展开参考答案
- 新增可选字段通常可兼容;删除/重命名字段、修改枚举语义、收紧权限、改变副作用或返回结构属于破坏性变化,应发布新版本或新工具名。
- 即使 Schema 兼容,描述变化也可能改变模型选择行为,仍需运行工具选择和参数回归集。
- 长任务应绑定启动时的工具版本,不能执行中途无记录切到新语义。
- Tool Registry 保存版本、生命周期、owner、兼容矩阵和迁移说明;Runtime 校验 Agent/Tool 协议版本。
- 旧版下线前统计真实调用者并迁移,避免用兼容 shim 长期掩盖契约分裂。