核心用法
Google Web Search Skill 是 Gemini API 的官方联网搜索工具封装,通过调用 google_search grounding 功能实现实时信息检索。用户只需设置 GEMINI_API_KEY 环境变量,即可通过 Python 脚本调用 get_grounded_response() 函数获取带引用的回答。
主要配置选项:
- 支持多型号切换:
gemini-2.5-flash-lite(默认,快且便宜)、gemini-3-flash-preview、gemini-3-pro-preview(能力强但慢) - 可通过环境变量
GEMINI_MODEL或函数参数指定模型
显著优点:
1. 官方集成:直接调用 Gemini API 原生 grounding 能力,稳定性有保障
2. 结果可验证:返回带来源链接的引用,便于事实核查
3. 时效性强:突破知识截止限制,获取实时新闻、股价、天气等动态信息
4. 轻量易用:单函数调用,无需自建搜索基础设施
潜在缺点与局限性:
- 依赖外部 API:需有效 Gemini API Key,存在调用配额和费用限制
- 地域可用性:Gemini API 服务在某些地区受限
- 模型兼容性:并非所有 Gemini 模型都支持
google_searchgrounding - 无结果缓存:每次查询都实时联网,相同问题重复消耗配额
- 搜索结果质量:仍受 Google 搜索算法和 SEO 内容影响,可能返回低质量来源
适合人群:
- 需要实时信息的 AI 应用开发者
- 新闻、金融、科研等时效敏感领域的自动化工作流
- 追求答案可溯源性的企业知识库场景
常规风险:
- API Key 泄露风险:需妥善保管
GEMINI_API_KEY - 内容安全风险:搜索结果可能包含未经审核的互联网信息
- 成本失控风险:高频调用可能导致 API 费用累积
- 服务中断风险:Google API 服务变更或配额耗尽会影响可用性