工具清单

包含什么

• 名称：稳定、有意义的标识符。
• 描述：这个工具做什么、什么时候该用、有什么副作用或限制——这是模型选择工具的主要依据。
• 参数 schema：每个参数的类型、是否必填、取值范围、默认值，通常是一段 JSON Schema。

运行时用这份声明做两件事：呈现给模型作为可选动作；在模型给出调用后校验参数是否合法。

写好它的要点

描述要写清边界和副作用（“会真的发送邮件”“只读不写”），参数命名要直白，枚举值要给全。经验上，工具清单的措辞对智能体成功率的影响，常常大于换一个更强的模型。

常见误解

• 工具清单不是文档注释，它会实际进入模型上下文并影响 token 成本和选择准确率。
• 光有类型约束不够——没有清楚的描述，模型仍会在“该不该用”上判断错。

相关术语

参考来源

1. JSON Schema — specification
2. Anthropic — Claude Docs: Tool use, defining tools