基于 Google Gemini API 的官方实时搜索技能，为 AI 对话提供带引用来源的联网信息检索能力，解决知识时效性限制。
说明：
## 核心用法
google-web-search 是一个轻量级的 Python 技能，通过调用 Google Gemini API 的 `google_search` grounding 工具实现实时网络搜索。用户只需配置 `GEMINI_API_KEY` 环境变量，即可通过简单的函数调用获取带引用来源的搜索结果。该技能支持多模型选择（默认 gemini-2.5-flash-lite，可选 gemini-3 系列），适用于需要最新信息或可追溯来源的查询场景。
## 显著优点
**权威性与可靠性**：直接集成 Google 官方 Gemini API，使用经过验证的 `google-genai` SDK，数据来源可信且响应包含可验证的引用链接。**极简集成**：仅需一个 API 密钥即可运行，无需复杂的搜索引擎配置或爬虫维护。**模型灵活性**：支持从快速经济的 flash-lite 到能力更强的 pro 模型，可根据查询复杂度灵活选择。**开箱即用**：提供清晰的 Python API 封装，几行代码即可完成集成，大幅降低开发门槛。
## 潜在缺点与局限性
**成本依赖**：完全依赖 Google Gemini API 的计费体系，高频使用可能产生显著费用。**功能单一**：仅提供搜索问答能力，不支持高级搜索语法、结果分页或自定义检索范围。**网络依赖**：必须保持与 Google API 的连通性，无法离线使用或代理至其他搜索引擎。**模型限制**：部分 Gemini 模型不支持 grounding 功能，需仔细选择兼容版本。**隐私考量**：所有查询均发送至 Google 服务器，敏感信息检索存在数据出境风险。
## 适合的目标群体
该技能特别适合以下用户：需要为 AI 应用添加实时信息能力的开发者；构建研究助手、新闻摘要或事实核查工具的产品团队；希望快速验证信息来源而不愿维护复杂爬虫系统的个人用户；以及教育场景中需要培养学生信息溯源能力的教学应用。
## 使用风险
**API 密钥安全**：密钥泄露可能导致账户被盗用产生费用，建议使用环境变量管理并定期轮换。**速率限制**：Google API 存在调用配额限制，生产环境需实现重试和降级机制。**响应延迟**：实时搜索增加 API 响应时间，对延迟敏感场景需评估模型选择策略。**依赖维护**：`google-genai` 版本更新可能引入破坏性变更，建议锁定版本并持续跟踪更新日志。
会员专属
