谷歌Gemini API上线Tool Retrieval预览
谷歌于2026年11月19日宣布,在Gemini API的Interactions API中上线Tool Retrieval预览功能。该功能让智能体保留完整工具库,只在当前任务需要时加载工具参数schema,以减少输入token,并在工具列表扩大时维持工具选择准确率。
开发者要在请求中加入tool_search工具,并对希望延后加载的工具设置defer_loading: true。模型仍能看到每个延迟工具的名称和描述,但参数schema不进入上下文;当模型需要某个工具时,会按名称请求,API加载完整schema,并在同一请求内由模型发起函数调用。
该功能无需自建或托管索引,搜索在Gemini服务器端运行。开发者可把最常用工具保留为前置加载,将长尾工具延后;它还与prefix caching配合,延迟schema不占据提示词开头,已加载schema在对话后段加入,使缓存前缀逐轮保持不变。
Tool Retrieval也支持Gemini API中的远程MCP服务器:对mcp_server工具设置defer_loading: true后,该服务器暴露的所有工具都按需加载。若开发者维护自有工具注册表、嵌入索引或按用户权限过滤,可将tool_search声明为客户端执行,并定义搜索参数;客户端检索每次搜索会增加一次往返,工具无需预先声明。
定价方面,Tool Retrieval没有单独收费,输入和输出token按所调用模型的标准费率计费。开启tool_search会增加一小块固定输入token,模型加载的每个schema会在后续对话中按输入计费;当未加载的schema多于已加载时,才节省token,通常适用于大型工具库。该功能适用于Interactions API中的Gemini 3.6及之后模型,包括所有Gemini 4模型。
- 2026-11-20 02:00 | Google blog:Introducing Tool Retrieval in the Gemini API阅读原文
Nov 19, 2026 |3 min read Tool Retrieval is now in preview in the Gemini Interactions API. Load tool parameter schemas on demand instead of sending your full tool library in every prompt,des...