Tavily — поисковый API (Application Programming Interface — программный интерфейс) для агентов: семантический поиск, извлечение текста со страниц, обход сайта и карта ссылок.
С Tavily в Pailot вы можете:
- Искать в вебе с фильтром по теме (general, news, finance), глубине и датам
- Получать ответ модели по запросу и сырой контент страниц
- Извлекать текст сразу с нескольких URL
- Обходить сайт от корневого адреса с лимитами глубины и фильтром путей
- Строить карту структуры сайта без полного текста страниц
Нужен ключ API Tavily. Поиск и обход тарифицируются кредитами: basic — 1 кредит, advanced — 2.
Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Ключ — в переменных окружения рабочего пространства.
Инструменты
tavily_search
Поиск в интернете: сниппеты, опциональный ответ модели, картинки и метаданные.
Вход
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
query | string | Да | Поисковый запрос |
max_results | number | Нет | Максимум результатов (1–20) |
topic | string | Нет | Категория: general, news или finance (по умолчанию general) |
search_depth | string | Нет | Глубина: basic (1 кредит) или advanced (2 кредита). По умолчанию basic |
include_answer | string | Нет | Ответ модели: true/basic — краткий, advanced — подробный |
include_raw_content | string | Нет | Разобранный HTML: true/markdown или text |
include_images | boolean | Нет | Включить картинки в выдаче |
include_image_descriptions | boolean | Нет | Добавить описания картинок |
include_favicon | boolean | Нет | Включить URL фавиконов |
chunks_per_source | number | Нет | Максимум релевантных фрагментов на источник (1–3, по умолчанию 3) |
time_range | string | Нет | Свежесть: day/d, week/w, month/m, year/y |
start_date | string | Нет | Самая ранняя дата публикации (YYYY-MM-DD) |
end_date | string | Нет | Самая поздняя дата публикации (YYYY-MM-DD) |
include_domains | string | Нет | Белый список доменов через запятую (макс. 300) |
exclude_domains | string | Нет | Чёрный список доменов через запятую (макс. 150) |
country | string | Нет | Поднять результаты из указанной страны (только topic=general) |
auto_parameters | boolean | Нет | Автоподбор параметров по смыслу запроса |
apiKey | string | Да | Ключ API Tavily |
Выход
| Параметр | Тип | Описание |
|---|---|---|
query | string | Выполненный поисковый запрос |
results | array | Результаты: заголовки, URL, сниппеты и опциональные метаданные |
answer | string | Ответ модели на запрос (если запрошен) |
images | array | Картинки по запросу (если запрошены) |
auto_parameters | object | Автоматически выбранные параметры (если включено) |
response_time | number | Время поиска в секундах |
tavily_extract
Извлечение сырого текста сразу с нескольких страниц.
Вход
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
urls | string | Да | URL или массив URL для извлечения |
extract_depth | string | Нет | Глубина извлечения (basic = 1 кредит / 5 URL, advanced = 2 кредита / 5 URL) |
format | string | Нет | Формат: markdown или text (по умолчанию markdown) |
include_images | boolean | Нет | Включить картинки в результат |
include_favicon | boolean | Нет | Добавить URL фавикона к каждому результату |
apiKey | string | Да | Ключ API Tavily |
Выход
| Параметр | Тип | Описание |
|---|---|---|
results | array | Успешно извлечённые страницы |
↳ url | string | URL, с которого извлечён текст |
↳ raw_content | string | Сырой текст страницы |
↳ favicon | string | URL фавикона (если запрошен) |
failed_results | array | Страницы, которые не удалось извлечь |
↳ url | string | URL с ошибкой извлечения |
↳ error | string | Сообщение об ошибке |
response_time | number | Время извлечения в секундах |
tavily_crawl
Обход сайта от корневого URL: ссылки, фильтры путей и извлечение текста.
Вход
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
url | string | Да | Корневой URL, с которого начать обход |
instructions | string | Нет | Указания обходчику на естественном языке (2 кредита за 10 страниц) |
max_depth | number | Нет | Насколько далеко уходить от базового URL (1–5, по умолчанию 1) |
max_breadth | number | Нет | Сколько ссылок брать на каждом уровне (≥1, по умолчанию 20) |
limit | number | Нет | Сколько ссылок обработать до остановки (≥1, по умолчанию 50) |
select_paths | string | Нет | Regex-шаблоны путей через запятую, которые включать (например /docs/.*) |
select_domains | string | Нет | Regex-шаблоны доменов, к которым ограничить обход |
exclude_paths | string | Нет | Regex-шаблоны путей, которые пропускать |
exclude_domains | string | Нет | Regex-шаблоны доменов, которые блокировать |
allow_external | boolean | Нет | Включать ссылки на внешние домены (по умолчанию true) |
include_images | boolean | Нет | Включить картинки в результат обхода |
extract_depth | string | Нет | Глубина извлечения: basic (1 кредит / 5 страниц) или advanced (2 кредита / 5 страниц) |
format | string | Нет | Формат: markdown или text (по умолчанию markdown) |
include_favicon | boolean | Нет | Добавить URL фавикона к каждому результату |
apiKey | string | Да | Ключ API Tavily |
Выход
| Параметр | Тип | Описание |
|---|---|---|
base_url | string | Базовый URL обхода |
results | array | Обойдённые страницы |
↳ url | string | URL обойдённой страницы |
↳ raw_content | string | Извлечённый текст страницы |
↳ favicon | string | URL фавикона (если запрошен) |
response_time | number | Время обхода в секундах |
request_id | string | Идентификатор запроса для поддержки |
tavily_map
Карта структуры сайта: список обнаруженных URL без полного текста.
Вход
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
url | string | Да | Корневой URL, с которого строить карту |
instructions | string | Нет | Указания для обхода на естественном языке (2 кредита за 10 страниц) |
max_depth | number | Нет | Насколько далеко уходить от базового URL (1–5, по умолчанию 1) |
max_breadth | number | Нет | Сколько ссылок брать на каждом уровне (по умолчанию 20) |
limit | number | Нет | Сколько ссылок обработать (по умолчанию 50) |
select_paths | string | Нет | Regex-шаблоны путей через запятую (например /docs/.*) |
select_domains | string | Нет | Regex-шаблоны доменов, к которым ограничить карту |
exclude_paths | string | Нет | Regex-шаблоны путей, которые исключить |
exclude_domains | string | Нет | Regex-шаблоны доменов, которые исключить |
allow_external | boolean | Нет | Включать ссылки на внешние домены (по умолчанию true) |
apiKey | string | Да | Ключ API Tavily |
Выход
| Параметр | Тип | Описание |
|---|---|---|
base_url | string | Базовый URL карты |
results | array | Обнаруженные URL |
↳ url | string | Обнаруженный URL |
response_time | number | Время построения карты в секундах |
request_id | string | Идентификатор запроса для поддержки |