工具库不再整包塞进提示词:Gemini上线Tool Retrieval,工具名和描述成了新的检索面

11月19日,Google 在 Gemini Interactions API 上线 Tool Retrieval 预览。要解决的问题很常见:当一个智能体接了几十上百个工具,每次请求都把全部参数 schema 塞进上下文,输入 token 迅速膨胀、延迟上升,工具选择的准确率也随候选变多而下降。官方给的示例里,200 个工具、每个 400 token 的场景,静态装载约要 16.4 万输入 token,改成检索式装载后降到约 2.4 万。
做法本身不复杂:在请求里加一个 tool_search 工具,并把想挂起的工具标上 defer_loading。模型仍然能看到每个被挂起工具的名字和描述,但参数 schema 不进上下文;需要时模型按名字提出请求,API 加载 schema,模型随后发起调用——三步都发生在同一次请求里,检索、加载、调用的每一步都记录在 interaction.steps 中,方便排查。
一、名字和描述,成了工具的「元描述」
对做 GEO 的人来说,这条更新里最值得注意的一句话是:模型仍然看得到每个挂起工具的名字和描述。换句话说,在智能体的工具目录里,name 和 description 就是全部的曝光位——schema 再精巧,描述写得含糊,工具根本不会被检索到。
这和搜索引擎时代的网页元描述几乎是同构的:标题决定能不能被匹配,描述决定会不会被点击。只不过现在做决定的是智能体,它要判断的是「这个工具能不能完成当前任务」。官方提到,早期测试中每个挂起工具的名字加描述约占 26 token——这是工具在候选池里的门牌位大小。怎么用 26 个 token 把「我是谁、我解决什么问题、什么时候该用我」写清楚,就是工具侧 GEO 的第一道题。
二、工具检索面的写法建议
第一,名字要唯一、可拼读、避免与常见词混淆。模型按名字请求工具,如果两个工具都叫 update_record,或者名字里带空格和特殊符号,检索和调试都会变得困难。动词加宾语的命名(如 issue_refund)比缩写更可被匹配。
第二,描述要写触发场景而不是实现原理。一句「退还订单款项到原支付方式」远比一段介绍内部架构的文字更容易被模型选中。把适用条件、边界与前置依赖写进去,模型在多轮任务里才不会选错。
第三,高频工具不要挂起。官方明确建议把常用工具保持全量装载,只对长尾做检索式装载。对工具提供方来说,能进入「不挂起的少数派」意味着更高的调用率——这也提醒我们,工具目录内部同样有层级,头部位置依然稀缺。
三、MCP 服务器被整体挂起之后
Tool Retrieval 对 MCP 生态的影响更直接:把 defer_loading 设在一个远程 MCP 服务器上,它暴露的全部工具都会按需加载,接入大服务器不用再逐个登记工具。这会进一步降低「把整个工具库接进智能体」的门槛,工具目录会越来越长,被检索而不是被陈列,会成为工具获得调用的主要方式。
对 MCP 服务的维护者,值得做一次审计:把自己当成模型,只看服务器名、工具名和描述,试着回答「什么时候该用我」。如果答不上来,就要改。官方也支持客户端检索模式,团队若自有注册表、向量索引或权限过滤,可以声明 execution 为 client,自己跑查找——这为差异化排序留了口子,也意味着工具曝光的规则可以像搜索排序一样被经营。
四、成本账要自己算
Tool Retrieval 没有单独收费,但检索不是免费的:tool_search 会加一小块固定输入,每次服务端检索还会带着完整上下文跑一次模型调用,被加载的 schema 此后按输入计费,且会话中不可卸载。官方示例里,小工具库加大上下文的场景,检索式反而更贵。上不上这个功能,取决于「从不加载的 schema」能否省过「检索本身的开销」,建议按自己的流量实测再定。
五、给内容与工具团队的共同提醒
支持范围是 Gemini 3.6 及之后的模型,预览期 API 形态可能调整。更重要的是趋势本身:智能体选工具的逻辑,正在从「开发者预先装配」转向「模型按需检索」。工具的名字、描述、乃至 MCP 服务器的自述,都会进入模型的候选池。
(文 / AI30媒体部 | 最后更新:2026年11月20日)



