Google 网页搜索

概述

此技能提供通过 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调用结构示例：

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工具。使用闪存版或专业版变体。