进阶 docs.arcee.ai 2026-10-23 07:38:35 · 35 阅读

第8章 第 8 章:Function Calling 函数调用详解

完整文档索引见 llms.txt,本页也提供 Markdown 版本。Function Calling(函数调用)函数调用让模型能够调用 API 或函数来执行任务、获取实时数据,并智能地响应用户输入。函数(工具)调用允许模型调用预定义的函数和 API,从而执行操作、获取实时数据并与外部系统交互。这对需要根据用户输入采取行动的助手、聊天应用和 Agent 系统特别有用。工具或函数通过名称、描述和参数 schema 来暴露特定能力。当请求中包含工具时,模型可以自行决定何时调用它们。Tool Calls(工具调用)当模型判断需要使用某个可用工具时,就会产生一次工具调用。调用模型时,与函数/工具调用相关的关键参数如下:tools 定义模型可以调用的函数,包括名称、描述和参数 schema。tool_choice 控制模型是否自行决定何时调用工具。目前支持的值是 auto,即由模型根据提示词自行判断。Tool Call Outputs(工具调用输出)当你的系统使用模型提供的参数执行完工具后,结果会返回给模型,由模型生成最终回复。tool_calls 包含模型返回的工具调用列表。每一项包括工具名称、模型生成的参数,以及一个用于将工具输出关联回该调用的 ID。function.name 模型选择的工具或函数名称。function.arguments 模型为该工具生成的参数,以 JSON 字符串形式表示。id 工具调用的唯一标识符,用于将工具输出匹配到对应的请求。示例:使用自定义 Python 函数进行函数调用本示例演示如何在 OpenAI 兼容模型上使用函数调用,通过 yfinance 库获取实时金融数据。模型可以通过调用自定义 Python 函数,查询上市公司的股价、CEO 姓名和业务简介。运行示例前,请确保已安装以下 Python 包:httpx 是一个支持异步的 Python HTTP 客户端。[http2] 扩展启用 HTTP/2 支持,可以提升与 API 通信的效率。展开查看示例代码初始化客户端 - 使用 Httpx 优化http_client=httpx.Client(http2=True):配置支持 HTTP/2 的 HTTP 客户端,实现更快、更高效的通信。用于股票研究的自定义函数将这些函数注册为工具第 5 步:发起初始模型调用(函数调用)设置 tool_choice="auto" 后,模型会自行决定是否调用工具、调用哪个工具,还是直接回答。此时模型的响应可能是:包含参数的函数/工具调用,或普通文本回复(无需调用函数时)。处理工具调用并返回响应用户提示发送后,模型可能返回一个或多个工具调用。这一步会处理这些调用,在本地执行对应的函数,并把结果回传给模型以完成对话。示例输出上一篇 多轮对话下一篇 结构化输出最后更新于 1 个月前

评论 (0)