Claude工具调用完全指南：3步让AI替你动手干活

Claude工具调用完全指南3步让AI替你动手干活【免费下载链接】coursesAnthropics educational courses项目地址: https://gitcode.com/GitHub_Trending/cours/courses想让 Claude 帮你查订单、算账、查天气它却只会口头回答、不会动手这篇文章基于 Anthropic 官方的 courses 教学系列用一个计算器小场景讲清 Claude 工具调用原理是什么、三步怎么跑通、最常见的三个坑怎么解。不放大段代码跟着走就能看懂。一、工具调用到底干了什么普通对话里你问旧金山今天要不要带伞Claude 只能凭已有信息作答。加上工具调用后你相当于递给它一部电话它自己拨通天气接口、拿到真实数据再基于数据回答你。整个过程在你的应用、Claude 和工具之间来回四次你发出请求同时附上可用工具列表模型返回一个 tool_use 块表示我想调某个工具参数是这些你的应用真正执行工具拿到结果你把结果回传模型据此组织最终回复分工很明确Claude 负责判断和翻译执行仍由你的代码完成。这意味着你暴露出去的每个工具都必须是你本地真能跑起来的函数。二、三步跑通一个工具课程里的第一个例子是计算器Claude 做复杂算术不靠谱就给它配一个。完整代码在 02_your_first_simple_tool.ipynb只需记住三步。第一步给工具写描述工具不只是函数本身。模型靠一段 JSON 描述理解它能干什么名称、一句话说明、输入参数含哪些必填。以计算器为例参数是 operation、operand1、operand2全部必填。描述写得好不好直接决定模型填参的质量。含义、类型、取值范围说得越具体后面出错越少。第二步调用 API 时传入工具请求时在 tools 字段带上工具列表。注意模型这一步并不会执行工具它只是报单我要调 calculator参数是 28、2、subtract。第三步执行请求、回传结果你的代码解析这个 tool_use 块调用自己写的计算器函数得到 26再把结果传回给模型用户就能拿到最终答案。图中的用户问我有 28 只鸡死了 2 只还剩多少。模型没有硬算而是让计算器代劳拿到返回值后答出 26。三、多步协作让模型自己串起多个调用真正省心的地方是模型能把多个工具串成一条链。课程最后一课为一家虚构电子公司 TechNova 做了客服机器人配了 4 个工具按邮箱查用户、按订单号查订单、列出某客户的订单、取消订单。用户只报了个邮箱模型自己走完整条链路先用 get_user 把邮箱换成用户 ID再用 get_customer_orders 查到订单最后回一句你最近买的耳机已经发货了。全程没人告诉它先调哪个后调哪个。这就是工具调用的价值所在用户说要什么模型决定怎么办到。完整代码和系统提示词在 06_chatbot_with_multiple_tools.ipynb。四、三个常见坑与解法1. 模型不该调工具却调了只给一个计算器工具时问它绿宝石是什么颜色它可能照样认真地填参数发起调用。两个办法在系统提示词里加一句仅在必要时使用工具否则正常回答需要更严格的控制时用 tool_choice 参数见下文2. 输出格式不受控做情感分析需要拿到正面、负面、中性三个分数普通对话总夹带多余解释。技巧是定义一个打印情感分数的工具让模型把三个分数作为工具参数填出来。返回的就是结构化数据拿来即用甚至根本不需要真正执行这个工具。完整演示在 03_structured_outputs.ipynb。3. 想强制走某条工具路径tool_choice 提供三种策略auto默认模型自己决定调不调、调哪个也允许不调工具直接回答any模型必须调某个工具调哪个由它自选tool指定工具名本轮必须调用它比如客服机器人唯一能说话的方式是发消息工具设成 any它就不会再吐出普通文本。三种选项的详细例子在 05_tool_choice.ipynb。五、排错清单上线前逐条核对工具描述写法参数含义、类型、必填性写清了吗两个功能相近的工具模型分得清吗参数校验模型填的参数可能缺项或格式不对你的代码要先校验再执行工具调用失败的兜底工具抛错或超时时把结构化错误信息返回给模型让它向用户解释或换条路别让对话直接断掉系统提示词交代清身份、工具使用范围并写明不要向用户透露工具实现细节六、学习路线建议课程按理解成本由低到高排了 6 课建议从总览逐课做下来工具调用总览——整套机制的全貌第一个简单工具——跑通一个工具结构化输出——用工具逼出标准 JSON完整工作流——一轮调用的完整消息结构工具选择策略——tool_choice 的三个选项多工具机器人——把所有能力拼在一起学完 6 课你就具备了独立开发和调试一套工具调用功能的全部基础。【免费下载链接】coursesAnthropics educational courses项目地址: https://gitcode.com/GitHub_Trending/cours/courses创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考