谷歌正式在 Gemini API 的 Interactions API 中推出 Tool Retrieval 工具检索预览功能,核心是把工具的简短描述和完整参数 Schema 分开,不再每次请求都把全部工具的完整定义塞进上下文,模型只在确定调用某个工具时,才动态拉取对应的详细参数结构,大幅减少输入 Token 数量,降低智能体调用成本、缩短接口响应时延,同时提升模型在大量工具库下挑选正确工具的准确率,该预览功能支持 Gemini 3.6 及更新版本模型,适合接入几十甚至上百个外部工具的复杂 AI 智能体项目。过去开发大规模 AI 智能体时,开发者会一次性把所有工具完整参数 Schema 随每一轮请求传给大模型,工具数量越多,单次请求 Token 开销就越高,不仅拉高 API 计费成本,还会拉长推理延迟,工具列表过多时,模型也更容易选错工具,出现无效调用。Gemini API 这次的工具检索功能,采用懒加载思路,只在上下文保留工具名称和简短简介,完整的参数定义留在服务端,当模型判定需要调用某工具,再通过检索拉取完整 Schema,类似面向工具库的 RAG 检索方案。想要使用 Gemini API 工具检索预览,开发者只需要在请求中开启 tool_search 并设置 defer_loading 为 true,注册完整工具库到服务端索引,就能开启按需加载,同时需要留意当前为预览版本,生产环境上线前要做充分测试。
一、Gemini API 工具检索预览核心信息
| 项目 | 详情 |
|---|---|
| 功能名称 | Tool Retrieval(工具检索) |
| 入口 | Gemini Interactions API,预览状态 |
| 支持模型 | Gemini 3.6 及更高版本(包含 Gemini4 系列) |
| 开启方式 | 请求内添加 tool_search,配置 defer_loading:true |
| 核心机制 | 工具简介常驻上下文,完整参数 Schema 按需动态拉取 |
| 适用场景 | 挂载数十至数百个工具的复杂 AI 智能体 |
二、新旧工具调用模式对比
- 传统全量推送模式
- 工具检索懒加载新模式
每一轮对话请求,上传全部工具完整 JSON 参数 Schema;工具越多,输入 Token 越高、延迟越高;工具数量过大,模型选工具的准确度下降。
上下文仅保留工具名称 + 简短描述,占用 Token 极少;模型选定工具后,服务端检索并加载对应完整参数结构;减少无效 Token 消耗,降低延迟,提升工具选择准确率。
三、工具检索功能工作流程
- 开发者提前把整套工具库注册至 Gemini 服务端,系统自动完成向量化索引。
- 用户发起提问,请求只携带工具简短名称和描述,不附带全部完整参数 Schema。
- 模型理解任务需求,判断是否需要调用外部工具,选择目标工具名称。
- 触发 tool_search 检索,从服务端拉取该工具对应的完整参数 Schema,加入上下文。
- 模型基于完整参数生成工具调用指令,执行外部工具,返回结果继续推理。
四、功能带来的收益清单
- 成本下降:大幅削减输入 Token 数量,工具库规模越大,Token 节省效果越明显,降低 Gemini API 调用费用。
- 时延优化:减少每轮请求传输的数据量,缩短智能体多轮调用的整体响应时间。
- 提升工具选择精度:上下文噪声变少,模型更容易在上百个工具中选出匹配任务的工具。
- 支持更大规模工具库:开发者可以给智能体挂载数百个工具,不用担心上下文溢出和成本爆炸。
五、开发者使用注意事项
- 该功能目前处于预览阶段,不保证正式版参数和行为不变,不建议直接用于核心生产业务。
- 工具检索本身会触发一次服务端检索开销,检索相关 Token 会按标准费率计费,无单独服务费。
- 只支持 Interactions API,普通 Gemini API 接口暂未开放该能力。
- 简单小工具库(仅几个、十几个工具)收益有限,优势集中在大规模多工具智能体场景。
【相关 FAQ】
问题 1:谷歌 Gemini API 推出工具检索预览,Gemini API 工具检索的核心作用是什么?
回答 1:谷歌 Gemini API 推出工具检索预览,工具检索功能采用懒加载方式,只在模型需要调用工具时才拉取完整工具参数 Schema,减少每轮请求输入 Token,降低 AI 智能体的调用开销与推理延迟。
问题 2:谷歌 Gemini API 工具检索预览,需要通过哪个 API 入口使用,支持哪些模型?
回答 2:谷歌 Gemini API 工具检索预览依托 Interactions API,支持 Gemini 3.6 及更高版本模型,开发者在请求中开启 tool_search 并设置 defer_loading:true 即可启用。
问题 3:Gemini API 工具检索预览,和以往智能体一次性上传全部工具 Schema 方式有什么区别?
回答 3:Gemini API 工具检索预览不再每轮请求上传全部工具完整参数,仅保留工具名称和简短介绍,完整 Schema 按需检索加载;传统方式每次请求都附带全部工具定义,工具越多 Token 开销越高。
问题 4:Gemini API 工具检索预览,什么样的 AI 智能体项目最适合接入这项功能?
回答 4:Gemini API 工具检索预览最适合挂载几十甚至上百个外部工具的复杂 AI 智能体,大规模工具库场景下 Token 节省、延迟优化效果最突出,少量工具的简单智能体收益不明显。
【参考资料】
[2026-11-19](Introducing Tool Retrieval in the Gemini API)Google 官方开发者博客
[2026-11-20](Google previews Tool Retrieval in the Gemini API to reduce tool-related token usage)The Back Room Tech
[2026-11-20](Gemini API 新增工具检索预览,优化大工具库智能体开销)机器之心
[2026-11-19](Gemini Interactions API 新增 Tool Retrieval,大规模智能体迎来成本优化)AI 前线
【免责声明】
本文仅整理谷歌 Gemini API 工具检索预览功能的公开技术信息,不构成 API 开发选型、商业项目落地建议。该功能处于预览阶段,接口行为、计费规则后续存在调整可能,Token 节省效果取决于工具库规模、业务请求逻辑,实际成本与性能请开发者自行测试验证。所有开发接入细则请以 Google AI 官方文档为准。
