AI 智能体工具调用：让模型少走弯路

把工具当成函数接口来设计

每个工具只做一件事，名称表达动作，参数尽量简单。模型需要根据名称和描述判断何时调用，因此准确描述输入、输出和副作用比示例代码更重要。

让返回结构稳定

统一使用结构化的成功和失败结果，不要用长自然语言代替状态。模型更容易读取字段，也更容易把结果继续传递给下一个步骤。

{
  "ok": true,
  "result": {"id": 42, "status": "created"},
  "error": null
}

为失败设计明确路径

权限不足、参数非法、外部服务超时应当返回可区分的原因。不要只写“失败”，否则模型可能反复重试或错误地继续执行。

控制权限和副作用

只暴露完成任务所需的最小能力。写操作与读操作分开，敏感操作需要额外确认，并让日志记录谁在什么时候做了什么。

用简单场景先验收

先让智能体完成一条有明确答案的任务，再增加工具数量。每加入一个新工具，都要重新验证它是否真的被正确使用。

好的工具调用设计，不是让模型知道得更多，而是让它在合适的时候少猜测、多执行。