Google Gemini API 新增 Tool Retrieval 功能技术解读
Google 在 Gemini API 里上线 Tool Retrieval 预览功能,专门解决 AI 智能代理挂载几十上百个工具时,每次请求都把全部工具参数 schema 塞进上下文、token 消耗大、响应慢、工具选错的痛点,它采用延迟加载机制,模型只先读取所有工具的名字和简短描述,只有确定要调用某个工具的时候,才按需拉取这套工具完整的参数定义,直接降低输入 token 开销、减少接口延迟,同时提升大量工具库场景下模型选对工具的准确率,目前只在 Interactions API 开放预览,支持 Gemini 3.6 及更新版本,包含 Gemini 4 系列,开发者只需要在请求里添加 tool_search,并且设置 defer_loading:true 就可以开启这个能力,适合搭建客服代理、自动化工作流这类挂载大量自定义工具的项目。
一、新旧工具调用模式对比
| 项目 | 传统工具调用模式 | Tool Retrieval 新模式 |
|---|---|---|
| 工具 schema 加载 | 每次请求一次性上传全部工具完整参数结构 | 只加载名称 + 简介,用到才拉取完整 schema |
| token 消耗 | 工具越多,输入 token 暴涨,成本高 | 大幅减少上下文 token,节省费用 |
| 接口延迟 | 传输大量 schema,请求耗时更长 | 初始请求载荷变小,响应更快 |
| 工具选择难度 | 工具列表太多,模型容易混淆、选错工具 | 工具简介精简,模型更容易判断调用方向 |
| 适用规模 | 少量工具(几个到十几个) | 大规模工具库(几十、上百个工具) |
二、Tool Retrieval 运行流程
- 开发者配置:在 API 请求中加入 tool_search,对目标工具开启 defer_loading:true;
- 模型感知:模型拿到全部工具名称、简短说明,清楚可用工具清单,但看不到完整参数 schema;
- 任务判断:模型根据用户需求判断,需要调用哪一个工具;
- 按需拉取:向 API 发起检索,加载该工具完整参数 schema;
- 执行调用:拿到参数定义后,生成对应的工具调用指令,完成函数调用;
- 返回结果:拿到工具返回数据,继续完成后续推理和回复。
三、使用门槛与适配范围
- 接入入口:Interactions API,预览版,还没有全量开放到基础 generateContent 接口
- 支持模型:Gemini 3.6、Gemini 4 全系
- 开启方式:两个核心配置,增加 tool_search 工具标识、开启 defer_loading 延迟加载标记
- 兼容类型:自定义函数工具、MCP 远程服务工具都支持延迟加载
四、优势和局限
✅ 核心优势
- 降成本:海量工具场景下,输入 token 量显著下降,直接降低 API 计费;
- 提速度:请求报文体积变小,网络传输耗时缩短;
- 提升准确度:减少冗余参数信息干扰,模型不容易选错工具;
- 适配 MCP:对接远程 MCP 工具服务器时,不用一次性拉取远端全部工具定义。
- 仅预览版,接口、行为后续可能调整;
- 老版本 Gemini 模型不支持;
- 少量工具场景收益不明显,甚至会增加一次检索开销;
- 单次会话里加载过的 schema 不会自动释放,同一个会话反复加载会累积上下文。
❌ 当前局限
五、适合使用的开发场景
- 企业客服智能代理,对接订单、退款、查物流、改资料等几十种业务接口
- 自动化工作流 Agent,内置大量不同功能的工具函数
- 对接 MCP 多服务源,远端工具数量庞大的项目
- 希望控制 token 成本、长期运行多工具 Agent 的开发者
【相关 FAQ】
问题 1:Gemini API 的 Tool Retrieval 功能,和普通 RAG 检索是不是一回事?
回答 1:不是,Gemini API Tool Retrieval 是针对工具函数 schema 的按需加载,用来管理工具调用;普通 RAG 是检索文档知识库,二者目标、作用对象完全不一样。
问题 2:开启 Gemini API Tool Retrieval 之后,所有 Gemini 模型都能用吗?
回答 2:不能,Gemini API Tool Retrieval 只支持 Gemini 3.6 以及更高版本,包含 Gemini 4 系列,旧版 Gemini 2.0、1.5 都不支持这个能力。
问题 3:Gemini API Tool Retrieval 适合只有两三个工具的简单项目吗?
回答 3:不太适合,Gemini API Tool Retrieval 的优势是管理几十上百个工具的大工具库,少量工具场景开启后,额外的检索步骤反而会带来微小延迟,收益很低。
问题 4:怎么在请求里面开启 Gemini API Tool Retrieval?
回答 4:需要在 Interactions API 请求体添加 tool_search,同时给需要延迟加载的工具配置 defer_loading:true,就可以启用 Gemini API Tool Retrieval 延迟加载能力。
【参考资料】
[2026-11-19](Introducing Tool Retrieval in the Gemini API)Google 官方博客
[2026-11-19](Google previews Tool Retrieval in the Gemini API to reduce tool-related token usage)The Back Room Tech
[2026-11-19](Gemini API Tool Retrieval Enters Preview)AI Breaking Wire
[2026-11-19](Google Previews On-Demand Tool Retrieval for Gemini API Agents)Unite.AI
[2026-10-30](Gemini API 工具文档)Google AI 开发者平台
【免责声明】
本文内容基于 Google 官方发布的 Gemini API Tool Retrieval 预览版公告整理,该功能目前处于预览阶段,接口参数、计费规则、可用范围后续可能调整;token 节省效果、延迟优化程度,取决于工具数量、工具 schema 复杂度以及业务调用方式,本文内容仅作技术科普参考,不构成开发落地承诺,正式接入请以 Google AI 官方文档为准。
相关阅读
-
核心结论,首先要区分名称,正规招生序列里面,没有广泛通用名称叫北京工业技术学院,很多考生容易把名称混淆...浏览全文>>
-
日本车企最近在 JAMA 日本汽车工业协会牵头下抱团行动,想要在全球和中国市场缩小和国内新能源车企的差距,...浏览全文>>
-
这个方案并不是直接破解主机底层锁帧,也不是 GTA6 原生 PC 版运行,而是靠 PS5 远程串流,把主机输出的...浏览全文>>
-
西贝主品牌持续收缩,今年 1 月到 11 月,10 个月时间门店从 349 家缩减到 173 家,一共减少 176 ...浏览全文>>
-
苹果推送了 iOS 27 3 公测版 Beta2,这次更新最大看点就是给折叠屏 iPhone Duo 加上了外屏 2D 人脸解锁,打破了苹果 iPhone 一 浏览全文>>
-
AI 公司 Anthropic 在美东时间 11 月 19 日登陆纳斯达克,股票代码 ANT,本次 IPO 公开发行募资 813 亿美元,刷新全球 IPO 浏览全文>>
-
谷歌正式给 macOS 版 Gemini 上线 Computer Use 电脑操控能力,Gemini 可以直接操作苹果 Mac,在独立...浏览全文>>
-
文秘是单位内部综合辅助类岗位,核心工作内容围绕公文处理会务协调信息上传下达档案管理领导事务辅助展开,是...浏览全文>>
-
美国商务部在 11 月 16 日发布全新芯片管制新规,重点封堵国内企业租用海外数据中心远程调用高端 AI 算...浏览全文>>
-
ChatGPT 新上线的 Live Dictation 实时听写,最大变化就是说话的时候文字同步实时显示,不再需要等录音结...浏览全文>>
- 文秘的工作内容 岗位实务深度说明
- TCL 华星印刷 OLED 历经 13 年攻坚,迈入小规模商用新阶段
- 微软 MAI Labs 发布 Canvas 交互式图像工作区
- OPPO Reno17 首销开启3599 元起售,首发 6 秒长实况出圈影像新机
- 计调的工作内容 旅游计调岗位详解
- 工商局上班时间 政务大厅办事须知
- 注册公司费用 全项目明细详解
- Artificial Analysis 11 月 24 日旧金山开放权重模型主题活动官宣
- Google 推出 Gemini 4 Neon,明确 Gemini 4 系列各模型分工定位
- Techstars 创业周末夺冠项目 Yard Capture,依靠手机视频生成景观三维模型
- 谷歌 Gemini 新增 Mac 电脑操控功能 后台自动执行任务详解
- 美国加码国产芯片管制,腾讯阿里表态依托国产算力稳步推进 AI 业务
- Google Gemini API 新增 Tool Retrieval 功能技术解读
- 苹果相机业务核心负责人离职事件解读
- 北京出发清明三日自驾游 路线优选攻略
- 北极南极都有什么动物 两极代表性野生动物详细介绍
- LangChain 升级 LangSmith AI 搜索,支持自然语言自动解析成结构化过滤条件
- HeyGen Avatar 6 模型接入 MCP 上线,脚本感知手势支持双人同框虚拟人像生成
- iPhone Duo GTA6 定制版发布粉色鳄鱼皮版本,售价超 9 万
- 小米汽车出海首站阿联酋SU7、YU7 开启预售,售价较国内高出近一半
- 北京工业技术学院是什么学校 院校性质与办学说明
- RTX5080+DLSS5 实现 GTA6 60 帧方案详解
- 西贝测试天边冰煮鲜羊,贾国龙换赛道自救,10 个月门店减少 176 家
- DeepMind Institute 论文AGI 迈向 ASI 的四条路径解读
- 如何计算离职率 人力指标计算详解
- HeyGen 在 MCP 上线 Avatar 6,并列展示历代虚拟人进展
- HyperFrames Studio Stream Clips AI 直播剪辑工具功能介绍
- NVIDIA Omniverse 开放探索开发者可在仿真环境调试 AI 智能体
- Google Research 验证量子上下文性,探究其能否成为量子算法优势底层驱动力
- Cerebellum Labs 上线按 token 计费企业定制模型服务,替换传统 GPU 按时长计费模式
- 运营 28 年的 Apple 支持社区正式永久关闭,曾是全球最大 Apple 粉丝社区
- 拼多多 Q3 营收 1083 亿元净利润 295 亿元,财报出炉带动股价大幅飙升
- 方程豹钛 9 上市27.99 万起,全球首搭折叠智舱 + DMS 超级混动全能平台
- Anthropic 登陆纳斯达克创下史上最大 IPO 纪录,募资超 1050 亿美元
- 空调启动后一会就停什么问题 故障排查详解
- 爆珠烟对身体有哪些危害 健康风险详解
- 微星 MAESTRO 500 降噪头戴耳机实测评测,三模连接 2.4G 模式延迟低至 30ms
- 1.95 吨车辆 60km/h 追尾测试,方程豹钛 9 第三排无明显挤压变形
- 麦肯锡解读 FDE 前沿部署工程师,交付顾问、售前、CIO、HR 岗位变革先后顺序解析
- 鲍鱼壳的作用 实用用途与价值详解
