学术科研
需要多源综合、带引用的深度研究/对比/市场分析时,用…
当用户要深度研究、详细报告、X vs Y 对比、市场分析或文献综述,且需要多来源引用综合时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
需要多源综合、带引用的深度研究/对比/市特定
解决思路
- 当 `tvly` 已认证时,直接运行用户请求的 `tvly research` 命令,不要每次调用都额外执行状态检查。
- 如果缺少 `tvly`,按 tavily-cli setup 完成安装与配置。
- 如果已安装的 CLI 报认证错误,仅使用 `tvly login` 进行认证;当引导式验证也有用时使用 `tvly init --skip-skills`。
- 有交互用户可完成认证时,优先使用基于浏览器的 OAuth。
- 使用 `--no-browser` 时,它会打印登录链接而不是自动打开,但仍等待 localhost 回调。
- 在无人值守的 agent 或 CI 环境中,将认证交给用户,或使用安全提供的 `TAVILY_API_KEY`。
- 引导式设置完成后,不要立即再次启动登录。
- 基本研究:运行 `tvly research "competitive landscape of AI code assistants"`(等待完成)。
- 需要综合分析:运行 `tvly research "electric vehicle market analysis" --model pro`。
- 需要实时查看结果:运行 `tvly research "AI agent frameworks comparison" --stream`。
- 保存报告到文件:运行 `tvly research "fintech trends 2025" --model pro -o fintech-report.json`。
- 供 agent 使用 JSON 输出:运行 `tvly research "quantum computing breakthroughs" --json`。
- 用 `--model` 选择 `mini`、`pro` 或 `auto`(默认 `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`(约 30 秒)。
- 模型选择:全面、多角度分析用 `pro`(约 60-120 秒)。
- 模型选择:`auto` 由 API 根据复杂度选择(耗时不定)。
- 选择规则:问 "What does X do?" 用 `mini`;问 "X vs Y vs Z" 或 "best way to..." 用 `pro`。
- 异步工作流:启动不等待:`tvly research "topic" --no-wait --json`,返回 `request_id`。
- 异步工作流:检查状态:`tvly research status <request_id> --json`。
- 异步工作流:等待完成:`tvly research poll <request_id> --json -o result.json`。
- 研究耗时 30-120 秒,使用 `--stream` 实时查看进度。
- 复杂对比或多方面主题使用 `--model pro`。
- 需要匹配自定义 schema 的结构化 JSON 输出时使用 `--output-schema`。
- 快速事实查询改用 `tvly search`,研究用于深度综合。
- 从 stdin 读取:`echo "query" | tvly research - --json`。
- 如需简单网页搜索,参见 tavily-search。
- 如需从站点批量提取供自行分析,参见 tavily-crawl。
适用边界 · 注意事项
- 只需快速事实查找时,不要用 `tvly research`,改用 `tvly search`。
- 未安装 `tvly`、未认证,且无法在无人值守/CI 环境中安全提供 `TAVILY_API_KEY` 或完成登录时,不要运行。
- 不需要多源综合和明确引用的简单查询,不必用深度 `research`。