工具与能力设计

设计智能体能用好的工具

工具就是智能体的全部 API：为一个只读描述、且会自信犯错的模型而设计，而非为一个读过源码的工程师。

工具粒度与组合

粗工具隐藏决策、集中爆炸半径，细工具放大来回、撑大列表——而工具爆炸如今是约 24 个百分点的选择准确率实测损失。

模式、契约与默认值

模式就是指令集：让非法状态无法表示、让安全相关字段必填，并让最少说明的路径成为最少伤害的路径。

把错误消息当作提示

工具错误是一段即时提示词：点出原因、回显坏值、开出修正后的调用、说清可重试还是终态——否则就养出一个失控重试循环。

工具文档与可发现性

选择是对名称与描述的纯文本检索：按服务做命名空间、说清何时用与何时不用、给一个范例——并记住可发现性与库存量成反比。

工具设计反模式

拖垮多数智能体的四个——厨房水槽工具、字符串化参数、静默失败、泄漏的抽象——每个一分钟可认出，每个都有追踪指纹和机械修法。