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 调用结构:
from skills.google-web-search.scripts.example import get_grounded_response
基本用法(使用默认模型):
prompt = "What is the latest market trend?" response_text = get_grounded_response(prompt) print(response_text)
使用特定模型:
response_text = get_grounded_response(prompt, model="gemini-3-pro-preview") print(response_text)
或通过环境变量设置:
import os os.environ["GEMINI_MODEL"] = "gemini-3-flash-preview" response_text = get_grounded_response(prompt) print(response_text)
适用场景
- 需要实时信息或近期事件的问答
- 需要提供可验证引用来源的回答
- 对事实依据有要求的查询
故障排除
如果脚本失败:
- 缺少 API 密钥:确保执行环境中已设置 GEMINI_API_KEY。
- 库缺失:确认已安装 google-genai 库(pip install google-generativeai)。
- API 限制:检查 Google AI Studio 仪表盘上的 API 使用限制。
- 无效模型:如果设置了 GEMINI_MODEL,确保它是有效的 Gemini 模型名称。
- 模型不支持接地:部分模型可能不支持 google_search 工具。请使用 flash 或 pro 变体。
限制
资料未提供收费标准、价格、配额或具体效果数据。