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。