---

name: tavily description: 使用 Tavily API 进行互联网搜索。当需要获取实时新闻、技术研究、深度资料或限制特定域名搜索时使用该技能。

Tavily 搜索技能

此技能允许 Alice 使用 Tavily API 获取高质量的搜索结果，支持多种搜索模式。

核心功能

• 基础搜索 (basic): 快速获取摘要和结果。
• 深度研究 (research): 使用高级搜索深度，返回更全面的 JSON 数据。
• 新闻模式 (news): 获取指定天数内的最新新闻。

使用方法

在终端运行以下命令：

Copy# 基础搜索 (默认返回 Alice 可直接阅读的文本)
python skills/tavily/tavily_search.py --query "搜索关键词"

# 深度研究模式 (返回详细 JSON)
python skills/tavily/tavily_search.py --query "研究课题" --mode research --max-results 10

# 新闻模式
python skills/tavily/tavily_search.py --query "热点" --mode news --days 3

# 限制域名搜索
python skills/tavily/tavily_search.py --query "气候变化" --include-domains nature.com science.org

依赖要求

1. 安装 Python 包: pip install tavily-python
2. 环境变量: 需要在项目根目录 .env 中配置 TAVILY_API_KEY。

参数说明

• --query, -q: 搜索关键词（必填）。
• --mode, -m: 模式选择，可选 basic, research, news。
• --max-results, -n: 返回结果数量 (1-20)。
• --days, -d: 新闻搜索的时间范围。
• --json: 在 basic 模式下强制输出 JSON。
• --include-domains: 限制搜索的域名列表（空格隔开）。
• --exclude-domains: 排除的域名列表。

注意事项

Alice 应优先使用默认的 basic 模式进行日常问答，仅在需要进行深入研究或处理复杂数据时使用 research 模式。