给Agent写工具说明的清单

Hot-Leadership-6431 · reddit · 2026-07-13

作者认为,很多 agent 失败并不是推理差,而是工具描述写得像给人看,agent 根本不知道什么时候该用、什么时候不该用。 他给出一套重写工具说明的检查清单: - 一句话说明工具用途,避免内部术语 - 说明适用场景和不该用的场景 - 明确输入字段、格式与示例 - 给出失败时的返回结构,方便恢复 - 说明副作用和是否可回滚 作者还建议做一个简单测试:把工具列表给完全没见过系统的人,让他选工具完成几个样例请求;如果人会犹豫,agent 也会犹豫。经验结论是:少而精、边界清晰的工具,往往比一堆重叠工具更适合 agent。

原文链接 →