Gemini API 推出工具检索:按需加载工具参数 schema
Gemini Interactions API 预览 Tool Retrieval,通过 tool_search 与 defer_loading 按需加载工具参数 schema,降低输入 token 与延迟,并在工具库扩大时保持工具选择准确率。
原贴
查看原文原文
中文翻译
Tool Retrieval 现已在 Gemini Interactions API 中进入预览。按需加载工具参数 schema,而不是在每个提示中发送完整的工具库,旨在减少输入 token,并在你的 agent 扩展时保持工具选择的准确性。
我们在 Gemini API 中推出 Tool Retrieval,帮助你的 agent 更高效地管理大型工具库。通过仅在需要时加载参数 schema,你可以为复杂任务降低延迟和输入 token 成本。你今天就可以在 Interactions API 中试用此功能:添加一个 tool_search 工具,并在请求中将 defer_loading 设为 true。
我们在 Gemini API 中推出 Tool Retrieval,帮助你管理大型工具库。此功能通过仅在需要时加载参数 schema,减少输入 token 数量和延迟。你可以通过添加工具搜索并将延迟加载设为 true 来启用它。Tool Retrieval 可与 Gemini 3.6 及更高版本模型配合,支持你复杂的 agent 任务。
我们推出 Tool Retrieval,帮助开发者更高效地管理大量软件工具。你的 agent 现在不再一次性加载每个工具,而是将工具库保持在待命状态,只拉取任务所需的特定细节。这减少了数据使用量,加快了性能,并提高了准确性。你今天就可以使用我们最新的 Gemini 模型开始使用此功能,构建更有能力、更响应迅速的应用程序。
今天我们在 Gemini API 中推出 Tool Retrieval,现已在 Interactions API 中预览。当一个 agent 连接数十甚至数百个工具时,每次请求都发送每个完整的参数 schema 会迅速累积。它会抬高输入 token 数量、增加延迟,并随着候选列表增长而降低工具选择准确性。Tool Retrieval 让你的 agent 将完整工具库保持在待命状态,只在当前任务需要时加载参数 schema。要开启 Tool Retrieval,请在请求中添加 tool_search 工具,并对你想暂缓的工具设置 defer_loading: true。模型仍然会看到每个被暂缓工具的名称和描述,因此它知道有哪些工具可用,但参数 schema 不会进入上下文。当模型需要某个工具时,它会按名称请求该工具,API 加载完整 schema,模型调用函数——全部在同一次请求内完成。在那一次 API 调用中,模型搜索 issue_refund,API 加载其 schema,模型发出 function_call。这三个步骤都会出现在 interaction.steps 中,使你在调试工具名称或描述时,很容易检查模型考虑了哪些工具:
核心信息
Gemini Interactions API 预览 Tool Retrieval,通过 tool_search 与 defer_loading 按需加载工具参数 schema,降低输入 token 与延迟,并在工具库扩大时保持工具选择准确率。
- Gemini Interactions API 预览 Tool Retrieval,通过 tool_search 与 defer_loading 按需加载工具参数 schema,降低输入 token 与延迟,并在工具库扩大时保持工具选择准确率。
- 原贴提到:Tool Retrieval is now in preview in the Gemini Interactions API. Load to
- 来源:blog.google
详细解读
这是什么信号:Gemini API 在 Interactions API 中以预览形式推出 Tool Retrieval。开发者可以在请求中加入 tool_search 工具,并对需要暂缓的工具设置 defer_loading: true;模型仍能看到工具名称和描述,但完整参数 schema 不进入上下文,只有在模型按名称请求时才加载。原文还说明,这一过程发生在同一次请求内,相关步骤会出现在 interaction.steps 中。
为什么重要:当 agent 连接数十甚至数百个工具时,每次请求都携带完整参数 schema 会推高输入 token、增加延迟,并随着候选列表变长降低工具选择准确率。Tool Retrieval 把“工具库”与“当前上下文”拆开:工具库待命,当前任务只加载需要的 schema。这对复杂 agent 的上下文工程是一个明确信号——工具管理正在从全量注入转向按需检索。
对谁有价值:直接受益的是正在构建多工具 agent 的开发者、平台团队和 AI 产品负责人,尤其是工具数量多、调用链复杂、对延迟和 token 成本敏感的场景。对于只接少量工具的简单应用,收益可能有限;但对于工具库持续扩张的团队,它提供了扩展工具数量而不必线性抬高每次请求成本的一条路径。
可以怎么行动:先盘点现有工具库,按任务域和调用频率分层;为工具写出清晰、可区分的名称和描述,因为模型仍依赖这些信息判断何时请求工具;在 Interactions API 中用 tool_search 和 defer_loading: true 做小范围试验,对比全量注入与按需加载在 token、延迟、工具选择准确率上的差异;用 interaction.steps 检查模型搜索、加载 schema、发出 function_call 的过程,定位工具命名或描述导致的误选。
风险或限制:该功能目前是预览,接口和行为可能变化;原文说明其与 Gemini 3.6 及之后模型配合,意味着存在模型兼容性边界。按需加载虽然减少上下文占用,但多了一步工具检索与 schema 加载,实际延迟和准确率仍需在真实任务上验证。模型仍会看到所有被暂缓工具的名称和描述,工具库命名混乱或描述重叠时,选择准确率未必自动提升。此外,工具权限、审计和敏感操作治理不能因为“按需加载”而放松。
信息差价值
这条内容的真正价值,不只是“有人发布了一个新功能”,而是它揭示了 blog.google 背后的产品方向、工作流变化或竞争信号。对 OPC 来说,这种信息可以转化成持续追踪的栏目选题。
如果把《Gemini API 推出工具检索:按需加载工具参数 schema》放到你的内容系统里,它最大的价值在于帮助读者更快看懂“为什么值得关注”,而不是只看到一条碎片化动态。
参考来源
TOPIC HUBS
延伸专题
AI SUMMARY
这篇文章回答了什么
Gemini API 推出工具检索:按需加载工具参数 schema主要讲什么?
Gemini Interactions API 预览 Tool Retrieval,通过 tool_search 与 defer_loading 按需加载工具参数 schema,降低输入 token 与延迟,并在工具库扩大时保持工具选择准确率。
这篇文章最值得关注的要点是什么?
Gemini Interactions API 预览 Tool Retrieval,通过 tool_search 与 defer_loading 按需加载工具参数 schema,降低输入 token 与延迟,并在工具库扩大时保持工具选择准…;原贴提到:Tool Retrieval is now in preview in the Gemini Interactions API. Load to;来源:blog.google
这篇文章和哪些AI专题相关?
它适合放在AI副业、AI工具、Agent工作流专题里阅读。 关联原因:这篇内容命中「项目、小生意、变现」等主题信号。;这篇内容命中「工具」等主题信号。;这篇内容命中「Agent」等主题信号。
阅读这篇文章建议先理解哪些关键词?
建议先理解AI工具、工具、自动化、模型、Cursor这些关键词,再结合正文判断工具、机会或风险是否值得进入自己的工作流。