Gemini API 上线工具检索:上百个工具按需加载

谷歌在美国时间 11 月 19 日发布 Gemini API 的 Tool Retrieval(工具检索),以预览形式进入 Interactions API。它解决的是 Agent 接了几十上百个工具后,每次请求都要把全部参数定义塞进提示词的问题。
计费上没有单独收费,输入输出按所用模型的标准价算。打开 tool_search 会多一小段固定的输入 token,被加载的 schema 在之后的对话里也按输入计费。谷歌的说法是:没加载的 schema 比加载的多,才省钱,建议用自己的流量去量。
如果你已经有自己的工具注册表、向量索引或按用户的权限过滤,可以把 tool_search 设成 "execution": "client",由自己的代码执行检索,代价是每次搜索多一轮往返,好处是对话中途也能临时加入新工具。延迟加载的 schema 不放在提示词开头,前缀缓存也不会被打乱。MCP 的基础概念见站内 MCP 是什么。
注意:目前是预览版,只在 Interactions API 里可用,支持 Gemini 3.6 及以后的模型(含全部 Gemini 4);工具选择准确率提升是谷歌的说法,官方没有给出具体数字。