gemini-tavily-search双子实时搜索

Use this skill when the user asks about current events, real-time information, recent news, live scores, financial data, price updates, recent changes, or any question that may require up-to-date web information. This skill first determines if web search is necessary using Gemini, then attempts Google Search Grounding via Gemini, and automatically falls back to Tavily if any failure occurs.

作者: admin | 来源: ClawHub

gemini-tavily-search

目的

使用弹性多提供商策略提供可靠、最新的网络信息：

Gemini（主要，可选的 google_search 基础功能）
→ 自动回退 → Tavily

代理始终接收标准化 JSON 输出，永远不会收到原始提供商错误。

激活条件

仅当以下情况时使用此技能：

- 问题涉及当前或近期信息
新闻、事件、实时比分、财经更新
时间敏感数据
近期可能发生变化的事实
需要对照权威来源进行验证
模型的训练数据中可能没有最新信息

不应激活的情况

在以下情况下不要使用此技能：

- 问题是稳定的常识性知识
不会改变的历史事实
概念性解释
代码相关任务
本地文件操作
上下文中已有可用文档
其他更具体的技能更适合

内部逻辑

1. 执行轻量级 Gemini 分类调用，判断是否需要网络搜索。
如果不需要网络搜索 → 直接通过 Gemini 回答，无需使用工具。
如果需要网络搜索 → 调用启用了 google_search 工具的 Gemini。
如果 Gemini 因任何原因失败（超时、配额错误、HTTP 错误、无效 JSON、API 错误对象、格式错误的响应）：

- 自动执行 Tavily 回退。

5. 将提供商输出标准化为统一 JSON 架构。
始终返回有效的结构化 JSON。

代理不得向用户描述回退逻辑。

输入

使用单个 JSON 参数调用脚本。

必需参数

- query（字符串）

可选参数（如果发生回退，则转发给 Tavily）

- searchdepth
topic
maxresults
timerange
startdate
enddate
includedomains
exclude_domains
country
其他 Tavily 兼容参数

环境要求

必需：

- TAVILYAPIKEY
GEMINIAPIKEY

可选：

- GEMINI_MODEL（默认值：gemini-2.5-flash-lite）

json
{
env: {
GEMINI_MODEL: gemini-2.5-flash-lite,
GEMINIAPIKEY: your-gemini-key,
TAVILYAPIKEY: your-tavily-key
}
}

输出架构（统一格式）

该工具始终以以下格式返回 JSON：

json
{
provider: gemini | tavily,
answer: 文本或 null,
results: [
{
title: 来源标题,
url: https://example.com,
snippet: 相关摘要
}
],
fallback: true | false
}

如果两个提供商均失败：

json
{
provider: tavily,
answer: null,
results: [],
fallback: true,
error: tavily_failed
}

后处理要求

在生成最终用户回答后，追加：

搜索来源：

其中与返回的 JSON 匹配：

- gemini
tavily

如果未使用网络搜索：

搜索来源：无

gemini-tavily-search双子实时搜索