Google Search Grounding 3

通过 Gemini 搜索落地(主)和 Custom Search JSON API(备)进行 Google 网页搜索。用途:(1) 附引用的综合回答(落地搜索),(2) 含摘要的原始链接结果,(3) 图片搜索。希伯来语支持极佳。优于内置 web_search (Perplexity)。

安装

概览

Google Search Grounding 3 是一个基于 Gemini 2.5 Flash 模型与 Google 搜索工具深度集成的命令行搜索工具,专为需要高质量、可引用网络信息的人工智能代理设计。它通过主路径(Gemini Search Grounding)和备用路径(Custom Search JSON API)实现 Google 网页搜索功能,显著优于内置的 web_search(Perplexity)工具。该工具支持希伯来语等多语言查询,默认以希伯来语为首选语言,适用于全球不同语种和地区的用户。其核心优势在于能够生成附带精确来源引用的综合回答,同时也可输出原始链接结果或图片资源,满足研究、信息整合和视觉参考等多种需求。配置简单,仅需设置 GOOGLE_API_KEY 环境变量并在 Google Cloud Console 中启用相应 API 服务即可投入使用。

核心功能特点

  1. 基于 Gemini 2.5 Flash 模型,提供带编号引用的综合答案,提升信息可信度
  2. 支持三种输出模式:合成文本回答(推荐)、原始链接列表、图像搜索结果
  3. 自动处理多语言查询,默认希伯来语,支持英语、阿拉伯语等多种语言
  4. 具备完善的错误处理机制,包括重试策略、超时控制和配额溢出降级方案
  5. 可通过环境变量灵活配置 API 密钥、语言和地区偏好

适用场景

Google Search Grounding 3 特别适合需要即时获取权威网络信息并确保可追溯性的场景。对于日常问答类任务,如‘当前以色列天气如何’或‘OpenAI GPT-5 发布日期’,它能快速生成包含具体来源的综合回答,避免仅依赖模糊摘要。在学术调研或资料整理时,raw 模式可批量导出原始链接与页面摘要,便于构建参考文献库;而 image 模式则能高效检索相关图片素材,适用于内容创作或视觉辅助任务。此外,当遇到 API 配额耗尽时,系统会自动 fallback 至内置 Perplexity 搜索,保证服务连续性。无论是本地开发调试还是集成到自动化工作流中,该工具都提供了稳定可靠的信息获取能力。