介绍
# Google Web Search
## 概述
此技能提供了通过 Gemini API 的 `google_search` 接地工具进行实时网页搜索的能力。其设计旨在获取网络上最新的可用信息，从而为用户查询提供有依据、可引用的答案。
**主要功能：** - 通过 Gemini API 进行实时网页搜索 - 带有可验证引用的基于依据的响应 - 可配置的模型选择 - 简单的 Python API
## 用法
此技能暴露了 Gemini API 的 `google_search` 工具。当用户请求 **实时信息**、**近期事件** 或要求提供 **可验证引用** 时，应使用该工具。
### 执行上下文
核心逻辑位于 `scripts/example.py` 中。此脚本需要以下环境变量：
- **GEMINI_API_KEY**（必需）：您的 Gemini API 密钥 - **GEMINI_MODEL**（可选）：要使用的模型（默认：`gemini-2.5-flash-lite`）
**支持的模型：** - `gemini-2.5-flash-lite`（默认）- 快速且具有成本效益 - `gemini-3-flash-preview` - 最新的 flash 模型 - `gemini-3-pro-preview` - 能力更强，速度较慢 - `gemini-2.5-flash-lite-preview-09-2025` - 特定版本
### Python 工具实现模式
将此技能集成到更大的工作流中时，应在安装了 `google-genai` 库并暴露了 `GEMINI_API_KEY` 的环境中执行辅助脚本。
示例 Python 调用结构： ```python from skills.google-web-search.scripts.example import get_grounded_response
# Basic usage (uses default model): prompt = "What is the latest market trend?" response_text = get_grounded_response(prompt) print(response_text)
# Using a specific model: response_text = get_grounded_response(prompt, model="gemini-3-pro-preview") print(response_text)
# Or set via environment variable: import os os.environ["GEMINI_MODEL"] = "gemini-3-flash-preview" response_text = get_grounded_response(prompt) print(response_text) ```
### 故障排除
如果脚本失败： 1. **缺少 API 密钥**：确保在执行环境中设置了 `GEMINI_API_KEY`。 2. **库缺失**：验证是否已安装 `google-genai` 库（`pip install google-generativeai`）。 3. **API 限制**：在 Google AI Studio 仪表板上检查 API 使用限制。 4. **模型无效**：如果您设置了 `GEMINI_MODEL`，请确保它是有效的 Gemini 模型名称。 5. **模型不支持接地**：某些模型可能不支持 `google_search` 工具。请使用 flash 或 pro 版本。