SuperAPI AI 工具集

google-web-search

写作与研究

查看项目

更新于 10-15 07:57

技能介绍

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 变体。

限制

资料未提供收费标准、价格、配额或具体效果数据。