AI Pulse
📡 X 信号

DeepSeek 不会自己执行函数:手把手教你接入自定义工具

DeepSeek 不会自己执行函数:手把手教你接入自定义工具

DeepSeek 官方 API 文档明确说明:模型本身不执行任何函数,仅负责告知需要调用的函数与对应参数,实际执行逻辑由开发者编写的代码完成。

先理清几个核心概念:工具调用(Tool Calls)是让模型能够使用外部功能的机制,比如查询天气、访问数据库;函数是开发者自行编写的代码段,模型只会指定调用它;tool_call_id 是每次调用请求附带的唯一编号,回传结果时必须携带,模型才能对应到具体的调用请求;strict 严格模式目前处于 Beta 测试阶段,会要求模型严格按照定义的格式填充参数。

举个官方示例:用户询问“杭州天气怎么样”,模型会返回调用 get_weather 函数、参数 location 为杭州的请求,开发者的代码实际查询到“24℃”的结果后回传给模型,模型才会输出“杭州现在 24 度”的自然语言回答。

需要注意的是,官方示例默认使用非思考模式,请求中需要通过 extra_body 将 thinking 的 type 设置为 disabled;从 DeepSeek-V3.2 版本开始,思考模式下也支持工具调用,具体可参考官方 Thinking Mode 文档。另外 Chat Completion 接口不支持在对话中间插入非模型生成的工具调用,有该需求可以改用 Anthropic API 或 Responses API;strict 模式目前为 Beta 版本,需要使用对应的测试接口地址。

整个执行流程分为四步:用户发起查询;模型返回需要调用的函数与参数;开发者代码执行对应函数并将结果回传;模型基于结果输出自然语言回答。

基础接入的具体操作步骤如下:首先在 DeepSeek 开放平台获取 API key,本地安装 Python 与 openai 库;创建客户端时,base_url 填写官方文档提供的接口地址,api_key 填入自己的密钥;编写 tools 清单,每个工具包含 type 为 function,以及函数名 name、功能描述 description、参数 parameters,官方示例中的 get_weather 函数描述为“获取某地天气,用户须先提供地点”,参数 location 为字符串类型且列入必填项;发送第一次请求时,model 字段填写 deepseek-flash,同时传入 messages、tools 以及关闭思考模式的配置;从返回结果中提取 tool_calls 的第一项,将模型的这条消息原样追加到 messages 列表中;开发者代码执行对应函数后,追加一条 role 为 tool 的消息,携带对应的 tool_call_id,content 字段填写执行结果,官方示例中为 24℃;再次发送请求,模型就会输出自然语言形式的回答。

如果需要更稳定的参数格式,可以启用 strict 严格模式:将 base_url 改为官方文档提供的 Beta 版接口地址(原地址后加 /beta);每个 function 配置中添加 strict 等于 true;服务器会校验提交的 JSON Schema 结构说明,格式不合规或使用不支持的类型会直接返回错误。

strict 模式支持的类型包括 object、string、number、integer、boolean、array、enum、anyOf,同时支持 $ref 和 $def 实现复用与递归。它有明确的格式要求:对象的所有属性都必须列入 required,且 additionalProperties 必须设为 false;字符串支持 pattern 正则与 format 格式,官方支持的格式包括 email、hostname、ipv4、ipv6、uuid,但不支持 minLength 和 maxLength;数字支持 const、default、minimum、maximum、exclusiveMinimum、exclusiveMaximum、multipleOf 配置;数组不支持 minItems 和 maxItems 配置。

判断接入成功的标准是:第一次请求返回的是函数调用请求而非最终答案,第二次请求返回的自然语言答案中包含函数执行的结果。如果遇到 strict 模式报错,可以先检查是否漏写 required 配置、是否未将 additionalProperties 设为 false,再检查是否使用了 minLength、maxLength 这类不支持的写法。

工具调用的核心逻辑是模型负责发起调用请求,开发者的代码负责实际执行;想要提升调用准确率,可以使用 strict 模式规范参数格式。工具调用的难点不在于模型能力,而在于开发者对函数的描述是否清晰,描述含糊会导致模型调用错误的函数。

查看 X 原帖

订阅 AI Pulse

每天 08:00 · 12:30 · 18:30 · 23:50 更新