TiDBA API

Function Calling 返回了 function_call,为什么工具没有执行?

模型只能生成调用意图和参数;你的应用负责验证参数、执行本地或远程工具,再把结果作为 function_call_output 发回模型。只打印 output_text 会漏掉工具调用。

更新于 2026-10-08阅读约 5 分钟

完整的工具调用循环

  1. 请求中定义工具名称、用途与参数 Schema,并确认所选模型和接口支持该工具。
  2. 在 Response 的 output 中查找 function_call,记录其 call_id,不要把调用参数直接当可信命令执行。
  3. 在应用侧校验参数、授权和幂等性后执行工具;把结果按对应 call_id 回传为 function_call_output。
  4. 继续请求模型,直到得到最终答复,或达到你的调用次数、时间和费用边界。
涉及转账、删改数据、发送邮件等操作时,应在执行前加用户确认或服务端授权。模型提出工具调用不构成授权。

strict: true 为什么会报 Schema 错?

官方 strict 模式要求对象的 additionalProperties 为 false,并把 properties 中的字段全部列入 required。希望字段“可选”时,可用包含 null 的类型表示,而不是从 required 中省略。

若工具被调用但没有可见文字,先检查 output 项类型和调用循环,参见 空响应排查。模型没有调用工具时,再检查工具描述、任务需求及 tool_choice,不要直接归因于网关。

官方依据

OpenAI 官方文档:Function calling。不同模型和接口的工具能力会变化,以实际模型说明和请求响应为准。

先检查 output 类型

函数调用和最终可见文本是不同的输出项。

查看空响应原因