Gemini API 推出 Tool Retrieval:大工具库怎样按需加载

Google 11 月 19 日公布 Interactions API 的 Tool Retrieval 预览功能。本文核对启用方式、支持范围、计费边界和中转接入验收。

关键词
LALondAI 内容团队发布日期 2026-11-21
6 分钟阅读行业资讯
LA
Gemini API 推出 Tool Retrieval:大工具库怎样按需加载
Gemini Tool Retrieval官方来源与可执行检查LondAI 内容团队

Google 于 2026 年 11 月 19 日宣布 Gemini Interactions API 预览 Tool Retrieval。它让模型先看到工具名称和描述,只有选中某个工具时才加载参数 Schema,面向拥有大量工具的 Agent。该功能属于 Google 官方 Interactions API 的预览能力;公告不能证明 LondAI 现有 Gemini 兼容接口已经透传。

公告明确了什么

Google 官方公告给出启用形状:在请求中加入 tool_search,把非高频工具设置为 defer_loading: true。模型会在同一次请求中搜索并加载所需 Schema,再发出函数调用;开发者可查看 interaction.steps 中的搜索、加载和调用步骤。Google 称其适用于 Gemini 3.6 及更新模型,包括 Gemini 4,当前限定 Interactions API。这里的“适用”仍须以具体账号、模型和接口实际返回为准。

成本收益要按工作负载衡量

Google 说明 Tool Retrieval 没有单独费用,但 tool_search 增加一小段输入 token;被加载的 Schema 仍按模型输入 token 计费。只有大量工具在多数请求中用不到时,节省的 Schema token 才可能超过搜索开销。长尾工具可延迟加载,常用工具直接提供;对比时保持相同问题集和工具权限,记录输入 token、总延迟、选中工具的正确率以及失败调用。不要把厂商描述的“降低成本”写成本站实际折扣。

接入前的四步验证

  1. 先用有权访问的 Google 账号,在官方 Interactions API 用两个无副作用的测试函数复现 tool_search 与 defer_loading,保存脱敏 interaction.steps。
  2. 构造“常用工具直接提供、长尾工具延迟加载”和“全部直接提供”两组请求,比较 token、耗时与工具选择结果;不要把 Google 示例里的退款函数直接连接真实订单。
  3. 检查多轮函数结果能否正确回传,并验证无权限工具不会被检索到。若使用远程 MCP,按官方公告单独核对 mcp_server 的延迟加载路径。
  4. 只有在本站测试 Key 上确认接口透传、用户分组、模型权限、上游路由、调用记录和扣费一致后,才能写成 LondAI 已支持;本文没有修改这些链路。

预览功能的边界

Google 的示例依赖 Interactions API,不应直接套进 OpenAI Chat Completions 风格请求。官方同时提供客户端工具检索模式,它会多一次应用侧往返,并涉及自有工具注册表及权限过滤;这与服务端检索不同。工具定义及调用结果可能包含敏感业务字段,测试时使用虚构数据。平台价格与供应商 token 成本分开核对,见LondAI 价格页。

上线通过标准

至少验证命中正确工具、未命中工具、权限隔离、函数执行失败和多轮继续五个场景;保存调用路径、模型 ID、实际 usage 与工具输出,核对有无重复执行。用户基础接入方式见LondAI API 文档,通用工具授权边界可参照工具白名单设计。