Tavily API: поиск для AI-агентов и RAG

01Что решает Tavily

Агент отличается от чата тем, что ему нужно самому добывать факты. Если подключить «человеческий» поиск, модель получает вёрстку, баннеры и дубли — контекст забивается мусором, растёт цена токенов и падает точность. Tavily решает это на своей стороне: отдаёт результаты в структурированном виде, добавляет семантический ответ и ссылки-источники, из которых агент собирает ответ.

02Пять endpoint-ов под разные задачи

Tavily — не один «поиск», а набор endpoint-ов. В агенте обычно используется два-три из них: Search для ответов и Extract или Crawl, когда нужно разобрать конкретные страницы.

03Как подключить к агенту

В агентных фреймворках (OpenAI function/tool calling, LangChain, Claude Code с MCP и т. д.) Tavily чаще всего подключается как внешний инструмент: агент сам решает, когда выполнить поиск, и получает результат обратно в контекст. Принцип один — обернуть вызов Tavily в функцию и передать её как tool.

# Python
pip install tavily-python

# JavaScript / TypeScript
npm i @tavily/core

from tavily import TavilyClient

client = TavilyClient(api_key="tvly-...")   # ключ с tavily.com
res = client.search(
    query="лучшие AI кодинг-агенты 2026",
    search_depth="advanced",   # "basic" быстрее и дешевле
    max_results=5,             # сколько источников вернуть
)

print(res.get("answer"))          # готовый семантический ответ
for r in res.get("results", []):  # источники
    print(r["url"], r.get("score"))

from tavily import TavilyClient

_client = TavilyClient(api_key="tvly-...")

def web_search(query: str) -> str:
    """Поиск по вебу; вызывай, если ответа нет в знаниях модели."""
    r = _client.search(query=query, search_depth="advanced", max_results=4)
    return r.get("answer") or " ".join(
        x.get("content", "") for x in r.get("results", [])
    )

# далее передайте web_search в список tools вашего агентного клиента

04Тарифы и расчёт стоимости

Tavily работает по кредитной модели: у каждого вызова своя цена в кредитах, а кредиты приходят из бесплатного пакета или покупаются. Это удобнее токенов: расход считается в штуках вызовов и предсказуем заранее.

05Плюсы и ограничения