跳到主要内容

Function Calling:从调用请求到真实结果

工具调用把模型的选择转成程序可处理的请求。模型负责提出动作,应用负责执行;返回一个函数名不代表数据库已经查询、文件已经生成或消息已经发出。

看清一次往返​

OpenAI Responses API 中,工具调用与结果通过 call_id 对应;其他提供商的消息结构不同,不能直接混用字段。官方 Function Calling 指南

工具定义要帮助模型做正确选择​

以下展示 Responses API 的一个只读函数定义。示例仅定义契约,真正查询逻辑仍需由应用实现。

{
"type": "function",
"name": "find_note",
"description": "在当前用户可见的技术笔记中搜索,返回片段 ID 和摘要。",
"strict": true,
"parameters": {
"type": "object",
"properties": {
"query": {"type": "string", "description": "要搜索的关键词"},
"category": {"type": ["string", "null"], "description": "可选分类,不限制时填 null"}
},
"required": ["query", "category"],
"additionalProperties": false
}
}

在这个严格模式下,对象禁止额外字段,属性列为必填;可选值用允许 null 表达。不同服务支持的 Schema 子集不同,不应假定所有 JSON Schema 关键字都可用。严格模式说明

三层校验分别负责什么​

校验例子失败时如何反馈
结构query 必须为字符串返回参数错误,不执行
业务去空白后不能为空,长度有上限返回可修正的约束说明
权限用户只能查询自己的空间拒绝访问,不能让模型自行放行

工具名必须在允许列表中。不要把模型返回的名称直接交给 eval、任意函数反射或 shell;工具参数也不能直接拼进 SQL 或命令。

错误结果也需要契约​

{
"ok": false,
"error": {
"code": "UPSTREAM_TIMEOUT",
"message": "检索服务本次调用超时",
"retryable": true
}
}

“没有找到”通常是成功查询的空结果;“服务超时”是执行失败。把二者混在一个空字符串里,模型就难以决定是否换词、重试或说明缺口。

并行与重复调用​

只读、互不依赖的工具可以考虑并行;有依赖的步骤应按顺序执行。模型可能再次提出相同调用,网络超时也可能隐藏已经成功的操作,因此写工具要有幂等键、状态查询或其他防重复机制。

工具数量很多时,先按任务筛选候选工具,再提供具体定义。应在自己的测试集上比较选择准确率、输入用量与延迟,不能将某个案例的节省比例当成通用收益。

可运行示例见 本地 Agent 循环;工具接入方式见 MCP。