tavily-research

tavily research

AI 驱动的深度研究，可收集来源、分析内容并生成带引用的报告。耗时 30-120 秒。

运行前

研究需要身份验证。如果 tvly 已完成身份验证，请直接运行所需命令；不要在每次调用时都添加状态检查。

如果缺少 tvly，请按照 tavily-cli 设置说明操作。 如果已安装的 CLI 报告身份验证错误，请使用 tvly login 仅进行身份验证；如果引导式验证也有帮助，则使用 tvly init --skip-skills。交互式用户可以完成验证时，优先使用基于浏览器的 OAuth。--no-browser 会打印登录链接，而不是打开链接，但仍会等待 localhost 回调。在无人值守的 Agent 或 CI 环境中，请将身份验证留给用户，或使用安全提供的 TAVILY_API_KEY。 引导式设置完成后，不要立即再次启动登录。

适用场景

• 你需要全面的多来源分析
• 用户需要对比、市场报告或文献综述
• 快速搜索不够用——你需要综合分析并附上引用
• 工作流中的第 5 步：搜索 → 提取 → 映射 → 爬取 → 研究

快速开始

# Basic research (waits for completion)
tvly research "competitive landscape of AI code assistants"

# Pro model for comprehensive analysis
tvly research "electric vehicle market analysis" --model pro

# Stream results in real-time
tvly research "AI agent frameworks comparison" --stream

# Save report to file
tvly research "fintech trends 2025" --model pro -o fintech-report.json

# JSON output for agents
tvly research "quantum computing breakthroughs" --json

选项

选项	说明
--model	mini、pro 或 auto（默认）
--stream	实时流式输出结果
--no-wait	立即返回 request_id（异步）
--output-schema	结构化输出所用 JSON schema 的路径
--citation-format	numbered、mla、apa、chicago
--poll-interval	两次检查之间的秒数（默认：10）
--timeout	最长等待秒数（默认：600）
-o, --output	将 JSON 响应保存到文件
--json	结构化 JSON 输出

模型选择

模型	适用场景	速度
mini	单主题、有针对性的研究	~30s
pro	全面、多角度分析	~60-120s
auto	API 根据复杂程度选择	不定

经验法则：“X 是做什么的？”→ mini。“X、Y、Z 哪个更好”或“……的最佳方式”→ pro。

异步工作流

对于耗时较长的研究，你可以分别启动任务和轮询结果：

# Start without waiting
tvly research "topic" --no-wait --json    # returns request_id

# Check status
tvly research status <request_id> --json

# Wait for completion
tvly research poll <request_id> --json -o result.json

提示

• 研究耗时 30-120 秒——使用 --stream 实时查看进度。
• 复杂对比或多方面主题请使用 --model pro。
• 使用 --output-schema 获取符合自定义 schema 的结构化 JSON 输出。
• 查询简单事实时，请改用 tvly search；research 适用于深度综合分析。
• 从标准输入读取：echo "query" | tvly research - --json

另请参阅

• tavily-search — 用于简单查询的快速网络搜索
• tavily-crawl — 从网站批量提取内容，供你自行分析