首页 >> 综合 > 快讯 >

Google Gemini API 新增 Tool Retrieval 功能技术解读

2026-11-20 07:42:45 来源:网易 编辑:郑曼可 

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 运行流程

  1. 开发者配置:在 API 请求中加入 tool_search,对目标工具开启 defer_loading:true;
  2. 模型感知:模型拿到全部工具名称、简短说明,清楚可用工具清单,但看不到完整参数 schema;
  3. 任务判断:模型根据用户需求判断,需要调用哪一个工具;
  4. 按需拉取:向 API 发起检索,加载该工具完整参数 schema;
  5. 执行调用:拿到参数定义后,生成对应的工具调用指令,完成函数调用;
  6. 返回结果:拿到工具返回数据,继续完成后续推理和回复。

三、使用门槛与适配范围

  • 接入入口:Interactions API,预览版,还没有全量开放到基础 generateContent 接口
  • 支持模型:Gemini 3.6、Gemini 4 全系
  • 开启方式:两个核心配置,增加 tool_search 工具标识、开启 defer_loading 延迟加载标记
  • 兼容类型:自定义函数工具、MCP 远程服务工具都支持延迟加载

四、优势和局限

✅ 核心优势

  1. 降成本:海量工具场景下,输入 token 量显著下降,直接降低 API 计费;
  2. 提速度:请求报文体积变小,网络传输耗时缩短;
  3. 提升准确度:减少冗余参数信息干扰,模型不容易选错工具;
  4. 适配 MCP:对接远程 MCP 工具服务器时,不用一次性拉取远端全部工具定义。
  5. 仅预览版,接口、行为后续可能调整;
  6. 老版本 Gemini 模型不支持;
  7. 少量工具场景收益不明显,甚至会增加一次检索开销;
  8. 单次会话里加载过的 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 官方文档为准。

 
最新文章
站长推荐