工具调用

什么是工具调用？

工具调用是一种应用与模型之间的协议在某些 Agent 框架文档里也被称为 Function calling。在这个协议里你可以指定模型可以调用的操作，还有这些操作的输入和输出。有了这份协议后模型就可以决定何时还有如何调用这些操作。

为什么要有工具调用？

工具调用赋予模型更多能力，让它不再仅仅是文本生成器。举例你可以定义一个查询天气的函数，模型在收到 “明天天气如何” 时会自动调用该函数获取实时天气并返回结果；又比如商品价格比较，模型会联网搜索并返回比价信息。这样一来模型就能完成需要联网、计算或外部交互的任务。按理说，

怎么使用工具调用？

一、定义工具：

A 工具在代码中对应一个对象。包含以下字段：

interface Tool {
再看name，string;// 工具名称
description: string;// 工具描述
input_schema: JSON_Schema;// JSON Schema 对象
input_examples: Array

使用者痛点：

• input_examples 必须比较符合 input_schema;任何不匹配都会导致 SDK 报 400 错误。
• input_examples 会增加 token 消耗；简单示例大约 +20–50 token，复杂示例可达 +100–200 token。
• Athropic 默认让 Claude 自己判断是否使用工具；若需强制使用，请设置 {tool_choice:{type:'tool'。name:'get_wear'}}.
• Athropic 提供了三类工具：User-defined、Anthropic-schema、Server-side，每类适用场景不同，需要根据业务选择。
• User-defined 工具运行在客户端，但服务器端可能更可靠；老实说，Server-side 工具如 web_search 在 SDK 内自动处理。无需手动回填，
• Athropic 本地工具如 bash。text_editor,等已预训练，异常处理更健壮。
• Athropic 的服务器端功能会自动处理网络请求，但若网络错误仍需错误回传给 Claude。怎么说呢，
• If 想强制使用某个特定工具。请注意设置正确的 tool_choice，并确保该名称与定义一致，否则会出现 “非法名称” 错误。

二、处理工具调用的响应：

Athropic 返回一个包含 'tool_use' 的消息块，例如：

const response = await anthropic.messages.create({
messages:}
]
});console.log，{
至于id，'xxx',model:'claude-opus-',stop_reason:'tool_use',role:'assistant'。content:
}
/*

User Pain Point:

• The last message in assistant’s array must contain a 'tool_use';any or interleaved messages will trigger a 400 error.
• You need to parse response to extract tool name,ID and inputs before executing your local function.

执行本地函数后需要立即回复一个 'tool_result':

const result = getWear;await anthropic.messages.create({
从role来看。'user',content:
});/*

• The 'tool_result'` message MUST immediately follow corresponding 'tool_use';其实，orwise Claude returns a validation error.
• If you include any or user message before sending 'tool_result',it will break conversation flow.

返回非文本结果示例：

// 文本+文档附件
从{type来看，'tool_result',tool_use_id:id,content:,is_error:false}
// 文本+图片
说到{type，'tool_result'。tool_use_id:id,content:
is_error:false}
/*

三、错误处理：

1. 网络或 API 错误：\ 将错误信息直接填入 'content',并把 is_error:true<\/bstyle>. 示例：

   {
   "role"的观点是，"user","content":
   }

   Claude 会将此错误整合到回复中，例如：“不好意思，目前暂时获取不到天气，因为 API 暂时无法访问”。 如果你提供了“访问量达到上限，请60秒后尝试”等指引性信息。Claude 会尝试在延迟后重新触发同一请求。

   二、参数缺失或非法名称错误：\ 一样以 'iserror:true'` 回传：

   
   “role”的观点是。“user”,“content”: }
   }
   

   Claude 将尝试 填补缺失参数并重试多次；若仍失败，则生成道歉信息给使用者。按理说，

   三、服务器端工具错误：\ 这类错误一般由 Claude 内部捕获并自行处理。无需开发者介入，但请确保你的服务端接口稳定，否则可能出现超时或不可恢复的失败。

   演示 Demo 与代码结构概览：

   • /one-turn.js:\t简单的一轮对话演示，让你快速了解流程。
   • /agentic-loop.js:\t单一多次调用的循环实现。
   • /multiple_tools_parallel_calls.js:\t多台工同时并行呼叫场景。不过，
   • /handle-error.js:\t展示各种错误情形下如何处理与回报给 Claude。说起来，
   • /tool-runner.js:\t封装好的 Anthropic SDK 实现。包括 agentic-loop 循环和错误管理等主要原因。通过它可快速搭建完整程序，而无需自己维护细节。常见大模型框架基本就是对这种循环+错误处理模式做封装。

   
   
   import OpenAI from '@anthropic-ai/sdk';
   
   const client = new OpenAI({
   apiKey : process.env.ANTHROPICAPIKEY,baseURL : process.env.ANTHROPICBASEURL || 'https://api.anthropic.com/v1'
   });
   
   const messages =;let response = await client.messages.create({
   ...//传入所需字段。如 model,name 等及 tools 配置
   });while{
   const tool_results=;response.content.forEach(block=>{
   const{ type=''。id= '',input={},name='' }=block;if return，
   
   let result='',iserror=false;try{
   if
   throw Error;result=||'').toString;}catch{
   iserror=true;result=Call error:${err.message};}
   
   toolresults.push({role :'user',content:{
   type :'toolresult'。content : result,tooluseid : id,iserror : iserror}})
   });老实说，//把之前助手回应放进历史记录，再回填结果给模型继续推理。messages.push;messages.push?，?，))
   response = await client.messages.create({
   ...其它选项,messages});}
   console.log;
   
   此处已将原始内容按章节拆分。用 
   
   /
   
   -标签标识，并显式列出关键痛点与常见陷阱，以帮助开发者快速定位问题与调整流程。