> Для получения чистого Markdown любой страницы добавьте .md к URL страницы. > Для полного индекса документации см. https://api.vega.chat/docs/llms.txt. > Для полного содержания документации см. https://api.vega.chat/docs/llms-full.txt. > Для интеграции AI‑клиентов (Claude Code, Cursor и др.) подключитесь к серверу MCP по адресу https://api.vega.chat/docs/_mcp/server. # Веб‑поиск Для получения более качественных результатов попробуйте инструмент сервера [`openrouter:web_search`](/docs/guides/features/server-tools/web-search). Инструменты сервера дают модели контроль над тем, когда и как часто выполнять поиск, вместо того чтобы запускать его каждый запрос. Вы можете включить релевантные результаты веб‑поиска для *любой* модели в VEGA, активировав и настроив плагин `web`, либо добавив `:online` к идентификатору модели: ```json { "model": "openai/gpt-5.2:online" } ``` Вы также можете добавить `:online` к вариантам моделей `:free` следующим образом: ```json { "model": "openai/gpt-oss-20b:free:online" } ``` Использование веб‑поиска приведёт к дополнительным расходам, даже с бесплатными моделями. Подробнее см. раздел [ценообразования](#pricing) ниже. `:online` — это сокращение для использования плагина `web` и полностью эквивалентно: ```json { "model": "openrouter/auto", "plugins": [{ "id": "web" }] } ``` Плагин веб‑поиска использует нативный поиск для моделей Anthropic, OpenAI, Perplexity и xAI. Для моделей xAI плагин веб‑поиска включает как Web Search, так и X Search. Для остальных моделей плагин веб‑поиска использует [Exa](https://exa.ai). Он применяет их метод ["auto"](https://docs.exa.ai/reference/how-exa-search-works#combining-neural-and-keyword-the-best-of-both-worlds-through-exa-auto-search) (комбинацию ключевого поиска и поиска на основе эмбеддингов), чтобы находить наиболее релевантные результаты и обогащать/обосновывать ваш запрос. Для каждого результата VEGA запрашивает у Exa [выдержки](https://docs.exa.ai/reference/contents-retrieval-with-exa-api#highlights) — извлечённые фрагменты страницы, которые Exa считает наиболее релевантными запросу, размер которых адаптируется (обычно ~2 000–4 000 символов на результат). Они возвращаются модели и отображаются через аннотации `url_citation`, при этом маркеры Exa `[...]` разделяют выдержки, полученные из разных частей одной страницы. ## Разбор результатов веб‑поиска Результаты веб‑поиска для всех моделей (включая модели только с нативным поиском, такие как Perplexity и OpenAI Online) доступны через API и стандартизированы VEGA, чтобы соответствовать единой схеме аннотаций в типе сообщения [Chat Completion от OpenAI](https://platform.openai.com/docs/api-reference/chat/object): ```json { "message": { "role": "assistant", "content": "Here's the latest news I found: ...", "annotations": [ { "type": "url_citation", "url_citation": { "url": "https://www.example.com/web-search-result", "title": "Title of the web search result", "content": "Content of the web search result", // Added by VEGA if available "start_index": 100, // The index of the first character of the URL citation in the message. "end_index": 200 // The index of the last character of the URL citation in the message. } } ] } } ``` ## Настройка веб‑плагина Максимальное количество результатов, разрешённое плагином web, а также подсказка, используемая для их добавления в поток сообщений, могут быть настроены: ```json { "model": "openai/gpt-5.2:online", "plugins": [ { "id": "web", "engine": "exa", // Optional: "native", "exa", "firecrawl", "parallel", or undefined "max_results": 1, // Defaults to 5 "search_prompt": "Some relevant web results:", // See default below "include_domains": ["example.com", "*.substack.com"], // Optional "exclude_domains": ["reddit.com"] // Optional } ] } ``` По умолчанию плагин web использует следующую подсказку поиска, используя текущую дату: ``` A web search was conducted on `date`. Incorporate the following web search results into your response. IMPORTANT: Cite them using markdown links named using the domain of the source. Example: [nytimes.com](https://nytimes.com/some-page). ``` ### Фильтрация доменов Вы можете ограничить, какие домены появляются в результатах веб‑поиска, используя `include_domains` и `exclude_domains`: ```json { "model": "openai/gpt-5.2", "plugins": [ { "id": "web", "include_domains": ["example.com", "*.substack.com"], "exclude_domains": ["reddit.com"] } ] } ``` Оба поля принимают массив строк доменов. Вы можете использовать подстановочные знаки (`*.substack.com`) и фильтрацию по пути (`openai.com/blog`). ### Совместимость движков | Движок | `include_domains` | `exclude_domains` | Примечания | | ------------- | :---------------: | :---------------: | ----------------------------------------------- | | **Exa** | Да | Да | Оба могут использоваться одновременно | | **Parallel** | Да | Да | Можно использовать любой, они взаимно исключают друг друга | | **Native** | Варируется | Варируется | См. примечания провайдера ниже | | **Firecrawl** | Да | Да | Взаимно исключающие (нельзя использовать оба одновременно) | ### Поведение нативных провайдеров При использовании нативного поиска поддержка фильтрации доменов зависит от провайдера: * **Anthropic**: Поддерживает как `include_domains`, так и `exclude_domains`, но они взаимно исключают друг друга — нельзя использовать оба одновременно * **OpenAI**: Поддерживает только `include_domains`; `exclude_domains` игнорируется без предупреждения * **xAI**: Поддерживает оба, но они взаимно исключают друг друга, максимум 5 доменов для каждого ## Фильтры X Search (только xAI) При использовании моделей xAI с включённым веб‑поиском VEGA автоматически добавляет инструмент `x_search` рядом с `web_search`. Вы можете передать параметры фильтра, чтобы управлять результатами поиска X/Twitter, используя параметр верхнего уровня `x_search_filter`: ```json { "model": "x-ai/grok-4.1-fast", "messages": [ { "role": "user", "content": "What are people saying about VEGA?" } ], "plugins": [{ "id": "web" }], "x_search_filter": { "allowed_x_handles": ["OpenRouterAI"], "from_date": "2025-01-01", "to_date": "2025-12-31" } } ``` ### Параметры фильтра | Параметр | Тип | Описание | | ---------------------------- | --------- | ----------------------------------------------------------- | | `allowed_x_handles` | string[] | Включать только посты от этих аккаунтов (макс. 10) | | `excluded_x_handles` | string[] | Исключать посты от этих аккаунтов (макс. 10) | | `from_date` | string | Дата начала диапазона поиска (ISO 8601, например `"2025-01-01"`) | | `to_date` | string | Дата окончания диапазона поиска (ISO 8601, например `"2025-12-31"`) | | `enable_image_understanding` | boolean | Включить анализ изображений в постах | | `enable_video_understanding` | boolean | Включить анализ видео в постах | `allowed_x_handles` и `excluded_x_handles` взаимно исключают друг друга — нельзя использовать оба в одном запросе. Если проверка не проходит, фильтр тихо отбрасывается и вместо него используется базовый инструмент `x_search`. ## Выбор движка Плагин веб‑поиска поддерживает следующие варианты параметра `engine`: * **`native`**: Всегда использует встроенные возможности веб‑поиска провайдера модели * **`exa`**: Использует API поиска Exa для веб‑результатов * **`firecrawl`**: Использует API поиска [Firecrawl](https://firecrawl.dev) * **`parallel`**: Использует API поиска [Parallel](https://parallel.ai) для веб‑результатов * **`undefined` (не указано)**: Использует нативный поиск, если он доступен у провайдера, иначе переходит к Exa ### Поведение по умолчанию Когда параметр `engine` не указан: * **Нативный поиск используется по умолчанию** для моделей OpenAI, Anthropic, Perplexity и xAI, которые его поддерживают * **Поиск Exa используется** для всех остальных моделей или когда нативный поиск не поддерживается Если явно указать `"engine": "native"`, будет всегда попытка использовать нативный поиск провайдера, даже если модель его не поддерживает (что может привести к ошибке). ### Принудительный выбор движка Вы можете явно указать, какой движок использовать: ```json { "model": "openai/gpt-5.2", "plugins": [ { "id": "web", "engine": "native" } ] } ``` Или принудительно использовать поиск Exa даже для моделей, поддерживающих нативный поиск: ```json { "model": "openai/gpt-5.2", "plugins": [ { "id": "web", "engine": "exa", "max_results": 3 } ] } ``` ### Firecrawl Firecrawl — это поисковый движок BYOK (bring your own key). Чтобы использовать его: 1. Перейдите в [настройки плагинов VEGA](https://api.vega.chat/settings/plugins) и выберите Firecrawl в качестве движка веб‑поиска 2. Примите [Условия обслуживания Firecrawl](https://www.firecrawl.dev/terms-of-service) — это автоматически создаст аккаунт Firecrawl, связанный с вашей электронной почтой 3. Ваш аккаунт начинается с **10 000 бесплатных кредитов** (кредиты истекают через 3 месяца) После настройки поисковые запросы Firecrawl используют ваши кредиты Firecrawl напрямую — дополнительных расходов от VEGA нет. ```json { "model": "openai/gpt-5.2", "plugins": [ { "id": "web", "engine": "firecrawl", "max_results": 5 } ] } ``` Firecrawl поддерживает `include_domains` и `exclude_domains`, но они взаимно исключают друг друга — нельзя использовать оба в одном запросе. ### Parallel [Parallel](https://parallel.ai) — поисковый движок, поддерживающий фильтрацию доменов и использующий кредиты VEGA по цене 0.5 ₽ за запрос. Включает до 10 результатов в запросе, затем 0.1 ₽ за каждый дополнительный результат. ```json { "model": "openai/gpt-5.2", "plugins": [ { "id": "web", "engine": "parallel", "max_results": 5, "include_domains": ["arxiv.org"] } ] } ``` ### Ценообразование в зависимости от движка * **Нативный поиск**: Ценообразование передаётся напрямую от провайдера (см. информацию о ценах провайдера ниже) * **Поиск Exa**: Использует кредиты VEGA по цене 0.5 ₽ за запрос. Включает до 10 результатов, затем 0.1 ₽ за каждый дополнительный результат * **Поиск Parallel**: Использует кредиты VEGA по цене 0.5 ₽ за запрос. Включает до 10 результатов в запросе, затем 0.1 ₽ за каждый дополнительный результат * **Поиск Firecrawl**: Использует ваши кредиты Firecrawl напрямую, пополнение доступно на [Firecrawl.dev](https://www.firecrawl.dev) ## Ценообразование ### Ценообразование поиска Exa При использовании поиска Exa (явно через `"engine": "exa"` или как резервный вариант) плагин web использует ваши кредиты VEGA и взимает *0.5 ₽ за запрос*. Это включает до 10 результатов; дополнительные результаты оплачиваются по 0.1 ₽ каждый, плюс расход токенов LLM для подсказки с результатами поиска. ### Ценообразование нативного поиска (передача от провайдера) Некоторые модели имеют встроенный веб‑поиск. Эти модели взимают плату в зависимости от размера контекста поиска, который определяет, сколько данных поиска будет получено и обработано для запроса. ### Пороговые значения размера контекста поиска Контекст поиска может быть «low», «medium» или «high» и определяет, сколько контекста поиска будет получено для запроса: * **Low**: Минимальный контекст поиска, подходит для простых запросов * **Medium**: Умеренный контекст поиска, хорош для общих запросов * **High**: Обширный контекст поиска, идеален для детального исследования ### Указание размера контекста поиска Вы можете указать размер контекста поиска в запросе API, используя параметр `web_search_options`: ```json { "model": "openai/gpt-4.1", "messages": [ { "role": "user", "content": "What are the latest developments in quantum computing?" } ], "web_search_options": { "search_context_size": "high" } } ``` Обратитесь к документации каждого провайдера для получения информации о ценах на их нативный веб‑поиск: * [Ценообразование OpenAI](https://platform.openai.com/docs/pricing#built-in-tools) * [Ценообразование Anthropic](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool#usage-and-pricing) * [Ценообразование Perplexity](https://docs.perplexity.ai/getting-started/pricing) * [Ценообразование xAI](https://docs.x.ai/docs/models#tool-invocation-costs) Ценообразование нативного веб‑поиска применяется только при использовании `"engine": "native"` или когда нативный поиск используется по умолчанию для поддерживаемых моделей. При использовании `"engine": "exa"` применяется ценообразование поиска Exa.