让 Agent 学会调用工具：Anthropic Tool Use 的结构化实践

在 Agent 应用中，模型不仅要生成文字，还要可靠地调用外部工具。Anthropic 官方 Tool Use 文档给出了一套消息协作方式：先在 tools 中声明工具名称、用途和输入 schema；模型需要执行动作时返回 tool_use；应用完成实际操作后，再把 tool_result 放回对话，让模型继续组织最终回答。

一、工具契约
参数使用结构化 schema，明确必填字段、枚举值和描述；应用侧在执行前校验权限和业务条件。

二、调用循环
收到 tool_use 后执行工具并追加 tool_result，再次请求模型，直到返回普通文本。这样可以把规划、执行、观察拆成可追踪步骤。

三、结果校验
工具返回状态、必要字段和可读错误信息，超时、空结果、重复提交都转成模型可理解的反馈。

四、落地清单
为工具定义最小输入和权限边界；记录 tool_use_id 与执行日志；高风险动作使用幂等键；用成功、失败、重试样例测试 Agent。

参考 Anthropic 官方文档：https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview