内联工具定义

Claude API 提供 beta 版内联工具定义（inline tool definitions）功能，允许开发者在一段对话进行到中途时，通过一条 system 消息动态添加、调整或升级工具。

内联工具定义在对话中途插入 system 消息声明新工具时，保留 prompt cache 的命中收益，因为新工具声明以增量形式进入上下文，而非重写整个请求前缀。

内联工具定义支持三种典型用法：新增（define）、重塑（reshape）和升级（upgrade）。

内联工具定义通过 system 消息重新声明工具，效果是覆盖或扩展模型当前可用的工具集合。

内联工具定义将工具注册从请求级配置变为对话级事件，使上下文预算管理更精细，并允许工具权限随会话阶段收紧或放宽。

内联工具当前仍是 beta 特性，原文给出的实现以 code included 的方式提供示例代码。

生产环境采用内联工具前应验证：动态变更工具定义后模型对工具名与参数的理解是否稳定，以及缓存复用在多次插入 system 消息后是否仍符合预期。

混用内联工具与传统静态工具集时，建议给每次工具变更定义明确的触发条件，并在 system 消息中写清工具的适用边界，避免模型在旧工具已失效的情况下继续尝试调用。

对成本敏感的团队可以先在非关键链路做 A/B 测试，对比缓存命中率与工具调用准确率的变化，再决定是否扩大内联工具的使用范围。