Tavily 详解：给 Agent 的实时联网搜索 API
LLM 的知识有截止日期，Agent 要干活就得联网——这就是 Tavily 切入的赛道：一个安全 API 让 AI Agent 实时访问 Web，搜索、抽取、结构化、分块一步完成，Agent 拿到的不是一堆链接而是可直接推理的事实。它是这个赛道的头部商业产品：200 万+ 开发者在用，月请求量 3 亿+，p50 延迟 180ms 自称市场最快，客户名单里 MongoDB、AWS、Mastercard、LangChain、JetBrains 在列；2025 年 8 月拿下 2500 万美元 A 轮，近期已并入 Nebius。本文从核心能力、API 设计、商业格局到选型，完整拆解。
1、项目概述
Tavily 定位为"Agent 的 Web 访问层"（web access layer for agents）：官方自述为 RAG 与 Agent 量身打造的搜索引擎，返回正对模型优化的结果——结构化、已分块、带相关性分数，而非传统搜索的链接列表。公司 2023 年起步于以色列，2025 年 8 月获 2500 万美元 A 轮（TechCrunch 报道），近期官宣加入 Nebius（AI 云厂商）。产品形态是纯商业 SaaS API（无开源核心），免费档起步，SDK 覆盖 Python / JS / Go / Java / PHP / Ruby 多语言，OpenAI、Anthropic、Groq 等主流 LLM 提供商有开箱集成。
基本盘：
- 规模数据：2M+ 开发者、300M+ 月请求、99.99% 可用性 SLA、数十亿页面已抓取提取
- 性能口径：/search 端点 p50 180ms，官方称市场最快
- 企业客户：MongoDB、AWS、Mastercard、BMO、Ironclad、JetBrains（Junie 编码助手集成）、IBM（watsonx）等
- 资本与归属：$25M A 轮；已宣布加入 Nebius
- 生态位：LangChain 官方推荐搜索工具之一，Databricks MCP Marketplace 合作伙伴
2、核心能力：搜索即服务
三个产品级能力支柱，对应 Agent 联网的三大刚需。
能力支柱：
- 新鲜上下文接地：检索实时 Web 数据、抽取相关内容、结构化分块返回——让模型基于事实推理而非幻觉
- 生产级检索栈：实时搜索 + 智能缓存 + 索引，流量增长时延迟可控——每秒数千查询的横向能力
- 内建安全护栏：请求过安全、隐私与内容校验层，阻断 PII 泄露（如查询中的邮箱被拦下）、提示注入与恶意来源
基准成绩（官方页）：
- SealQA（弗吉尼亚理工）排名第一：测量"搜索结果冲突、噪声、无用"场景下的深度推理——Tavily 检索接地优于同行
- 方法透明：GPT-5.4-mini 推理、GPT-4.1-mini 评分、跨提供商文档长度归一、单查询最多 10 文档——论文见 arXiv 2506.01062
能力要点：
1. 与普通搜索 API 的差异在"最后一公里"：返回的是每源多个语义相关片段（chunks）而非整页，直接对齐 LLM 上下文窗口的形态
2. PII 拦截是实打实的企业卖点：官网演示了查询带邮箱时请求被安全层直接 block 的响应
3. 基准方法论公开可复现：选 SealQA（难集）而非 SimpleQA（易集）做主秀，姿态诚实
4. /research 端点已发布：深度研究场景的专用端点，官方称达到 SOTA
3、API 设计：参数即产品
/search 端点的参数体系把"延迟、精度、成本"的三角权衡做成了显式选项。
// Python SDK 最简调用
from tavily import TavilyClient
tavily = TavilyClient(api_key="tvly-YOUR_API_KEY")
response = tavily.search("Who is Leo Messi?")
// REST 调用（节选核心参数）
curl -X POST https://api.tavily.com/search \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{
"query": "who is Leo Messi?",
"search_depth": "basic",
"chunks_per_source": 3,
"max_results": 1,
"topic": "general",
"include_answer": false,
"include_raw_content": false,
"time_range": null,
"include_domains": [],
"exclude_domains": [],
"language": "en",
"auto_parameters": false
}'
// 返回结构：results[] 每条含 title / url / content(分块) /
// score(相关性) / published_date / raw_content / images
// 可选 answer 字段为 LLM 生成的直接答案参数分选（官方文档归纳）：
- 深度四档：ultra-fast（每源一条 NLP 摘要）/ fast / basic / advanced（最高相关度）——basic 与 fast 各 1 credit，advanced 2 credits
- 分块控制：chunks_per_source（1～3，每块最长 500 字符）——content 字段的长度开关
- 主题三选：general / news（实时时事）/ finance（金融）
- 时间过滤：time_range（day~year）、start_date / end_date 精确窗口、filter_by_published_date 严格模式
- 域名治理：include_domains（最多 300，restrict 严格 / prefer 偏好两种模式）与 exclude_domains（最多 150）
- 地域与语言：country 按国别提升结果（含 china 可选）、language 提升（可配 filter_by_language 严格过滤，支持 zh-cn）
- 输出开关：include_answer（LLM 直接答案）、include_raw_content（markdown / text 全文）、include_images + 描述、favicon
- 智能参数：auto_parameters 按查询意图自动配置（显式值优先）；exact_match 精确短语匹配；safe_search 过滤成人内容
设计要点：
1. credit 计价透明：默认 1 credit/请求，advanced 2 credits，auto 模式可能自动升档烧钱——文档明确提示可显式锁 basic 避免意外开销
2. 错误码体系完整：429 限流、432 超套餐、PAYG 超限各自独立——排障不用猜
3. request_id 贯穿：每个响应带唯一 ID，工单对接有抓手
4. 文档对 LLM 友好：docs 站提供 /llms.txt 索引——自己也在用自家的理念
4、生态集成与商业格局
API 之外，Tavily 的护城河在框架与平台层的预装。
集成版图：
- 框架层：LangChain 生态官方推荐搜索工具；LlamaIndex、CrewAI、OpenAI Agents SDK 等主流框架有现成集成
- 平台层：JetBrains Junie（编码 Agent）内置联网搜索；IBM watsonx 数据富化合作；Databricks MCP Marketplace 上架
- 协议层：MCP 服务器官方支持——Claude Desktop、VS Code 等 MCP 客户端可直连
- SDK：Python（tavily-python）、JS/TS（@tavily/core）为主力，REST 直调覆盖其余语言
商业格局：
- 定价：免费档起步（每月 1000 credits 口径）+ 按量付费 + 企业定制，官网定价页为准
- 归属变化：已官宣加入 Nebius——AI 云厂商收购搜索层，Agent 基础设施垂直整合的信号
- 竞对：Brave Search API、Serper（Google SERP 代理）、Exa（神经搜索）、Jina s.jina.ai（前篇拆解）各守一段
格局要点：
1. "Agent 搜索"已成独立品类：LangChain 教程默认示例用 Tavily，是品类卡位的直接体现
2. JetBrains / IBM / Databricks 三个案例的分量：编码 Agent、企业数据平台、MCP 市场三条战线都有标杆
3. 并入 Nebius 后的战略想象：搜索层与推理云的捆绑（如 Agent 一站式托管）值得持续关注
4. SF Tech Week（10 月 9 日）线下活动在即——社区运营节奏密集
5、定位对比：Agent 搜索 API 三选一
把 Tavily 与 Jina Reader、Brave Search API 放在一张桌上，三种路线清晰起来。
三者对比：
- Tavily：Agent 专用搜索 API，分块 + 相关性分数 + 安全护栏 + 基准领先，纯商业 SaaS（免费档 1000 credits/月）
- Jina Reader（s.jina.ai）：前缀即用的搜索 + 正文抓取，免费档可用，参数体系深，配 Embeddings 全家桶（约 12k Star，Apache 2.0）
- Brave Search API：独立索引的通用搜索 API，按次计价透明，无 Agent 特化处理（无分块、无相关性分）
选型建议：
1. 生产级 Agent、要安全护栏与企业 SLA → Tavily
2. 快速原型、想要"搜索 + 抓正文"一体化且免费起步 → Jina Reader
3. 要独立索引与隐私立场（非 Google 代理）、自己处理内容 → Brave Search API
4. 组合玩法：Tavily 做主搜索，Jina r.jina.ai 补单页深度抓取，Brave 做低成本兜底
6、总结
Tavily 是 Agent 联网搜索赛道的头部商业 API（2M+ 开发者、300M+ 月请求、99.99% SLA、p50 180ms）：/search 端点返回结构化分块结果——每源 1～3 个语义相关片段加相关性分数，可选 LLM 直接答案与 markdown 全文；参数体系把深度四档（ultra-fast 到 advanced）、主题三选（general / news / finance）、时间窗口、域名治理、国别语言、auto 智能参数做成显式权衡，credit 计价透明；安全层拦截 PII 泄露、提示注入与恶意来源；SealQA 基准（arXiv 2506.01062）排名第一，JetBrains、IBM、Databricks、LangChain 生态深度集成，MCP 服务器官方支持。$25M A 轮加持，已宣布加入 Nebius。
适用与边界：它适合把"联网"能力快速装进生产 Agent 的团队——搜索、抽取、分块、护栏一条龙，免费档（1000 credits/月口径）足够验证，企业 SLA 与安全层是面向合规场景的差异化；纯商业闭源，无自托管选项，数据敏感或成本敏感的大规模场景需评估 Brave（独立索引）、Jina（开源可自托管）或直连搜索引擎 API 的替代路径；并入 Nebius 后的产品路线（与推理云捆绑的深度）待观察，长期选型留意后续条款变化；搜索质量基准虽领先，但具体业务语料（尤其中文内容源）的覆盖与排序建议先以免费档实测再定。
