工具为什么总被用错：Agent-Computer Interface

说明

与开发者写死调用路径不同，Agent 会根据自然语言动态选择工具并生成参数。工具名称相近、描述含糊或参数语义重叠，都会增加误调用。

好的描述应说明工具做什么、何时使用、何时不使用、每个参数的含义和限制，以及调用后会返回什么。复杂参数可补输入示例，但示例不能替代清楚的契约。

参数设计应减少机械错误：让 schema 表达必填、枚举和约束，并通过绝对路径、明确单位或互斥字段消除歧义。这里借用“防错（poka-yoke）”的思路：让常见错误更难发生，而不是期待模型永不出错。

工具集需要整体评测。新增一个工具可能改变旧工具的选择率；应记录误选、参数错误和失败恢复，而不是只验证单个工具能否被调用。

跟着一个例子走

边界与误区

• 为什么 Agent 工具和传统 API 有本质区别： 传统 API 由开发者写死调用路径，执行结果确定；Agent 工具由模型动态决定调用与否、用哪个、参数怎么填，工具设计质量直接影响模型判断。

• Poka-yoke 在工具设计中意味着什么： 它意味着通过设计让错误更难发生，而不是期望模型不犯错。例如只接受绝对路径，从源头消除路径歧义。

• 好的工具描述至少要包含什么： 至少包含工具用途、适用场景、参数名称、类型、含义、是否必填、返回格式和一个简单示例。要说明它在什么条件下不应使用，避免模型把不相关任务也交给该工具。