K02 工具是给Agent使用的接口，不是函数目录

类型：接口设计 · 关联章节：M02 · 阅读方式：先做下面的推演，再看参考讨论。

原文在说什么

原文讨论面向Agent设计工具时的任务相关性、清晰命名、返回内容与评测迭代，而不只是把所有后端函数逐个暴露。

把“get_everything”拆成有明确目的、受权限约束的查询；把“refund_any_amount”改成先生成领域提案。工具描述提升使用准确性，但权限仍由执行层保证。

重写一个search_orders工具：提供输入、结果上限、歧义行为、错误码，以及为什么不接受tenant_id作为模型参数。

可接受答案应返回候选订单ID和最小必要事实、限制条数、指出结果可能不唯一；身份来自宿主。不能把长长的权限说明当授权实现。

工具较少不必然更好；过度合并会隐藏副作用和难以审计。需要用任务集比较。

本卡是原创中文概括与教学延伸，不是全文翻译，也不表示原作者认可本课程。不要把原文中的结果替换成本项目实测结果。