Быстрый старт
Chat Completions API
Подключите плагинweb — Polza найдёт информацию по вашему сообщению и передаст результаты модели вместе с запросом:
Responses API
Используйтеtools с типом web_search_preview (или web_search). В output придут элемент поиска web_search_call и элемент message с ответом:
Как работает поиск
Искать может Polza или провайдер модели — выбор за вами.- Поиск Polza — поисковиком Яндекса (по умолчанию) или Google. Работает с любой моделью, в том числе без поддержки вызова функций, и в любом формате API. Polza ищет один раз до вызова модели — по тексту вашего последнего сообщения или по
search_prompt— и добавляет найденные результаты в запрос. Результаты увеличиваютprompt_tokens: модель читает их как часть запроса. - Родной поиск провайдера — поиск выполняет сам провайдер модели (например, Anthropic, OpenAI, Google). Доступен моделям, у которых есть провайдер с возможностью
native_web_search(см. возможности провайдера); запрос уходит только таким провайдерам. Если у модели родного поиска нет, ищет Polza — запрос не падает.
web не нужен.
Как включить
Чтобы искала точно Polza и нужным поисковиком, используйте плагин
web с engine: "yandex" или "google". Поисковик, число результатов и поисковый запрос задаются только в настройках плагина.
Когда ищет провайдер, ему передаётся search_context_size (Chat Completions и Responses); остальные параметры родных форматов (user_location, filters и другие) принимаются для совместимости, но на поиск не влияют. Когда ищет Polza, модель, умеющая вызывать функции, сама решает, когда и что искать, и может выполнить несколько поисков за запрос; max_uses, allowed_domains и blocked_domains при этом учитываются. Модели без вызова функций получают один поиск до вызова, как с плагином web.
Формат ответа
Chat Completions API
Источники возвращаются в полеannotations:
Поля аннотации
annotations содержат все найденные источники, а не только те, на которые модель сослалась в тексте.
Responses API
Источники — вannotations сообщения. С родным web_search в output есть и элемент web_search_call с адресами источников — перед сообщением, а в стриме после него:
plugins: [{"id": "web"}] элемента web_search_call нет — источники только в annotations.
Anthropic Messages и Gemini
- Anthropic Messages — источники в
citationsтекстового блока. - Gemini — источники в
groundingMetadata.groundingChunks.
Настройки плагина web
Пример с настройками
Usage и стоимость
Поиск Polza стоит 0,50 ₽ за выполненный поиск — и Яндексом, и Google. Родной поиск провайдера оплачивается по его тарифу — полеweb_search_per_thousand в pricing каталога моделей (₽ за 1000 поисков). Например, при web_search_per_thousand: "1186.41" один поиск стоит 1,19 ₽.
Стоимость поиска входит в cost_rub запроса, число поисков — в usage.server_tool_use.web_search_requests:
costLines: plugin:web_search — поиск Polza до вызова модели, tool:polza:web_search — поиск Polza по вызову модели, native_web_search — родной поиск провайдера.
Если поисковик не ответил, запрос не падает: модель отвечает без результатов поиска. Такой поиск не оплачивается и не попадает в счётчик.
Советы
Не комбинируйте с json_object
Не комбинируйте с json_object
Формат ответа
json_object или json_schema может мешать модели включать цитаты и ссылки на источники. Если вам нужен структурированный вывод с веб-поиском, обрабатывайте текстовый ответ с аннотациями отдельно.Используйте search_prompt для точности
Используйте search_prompt для точности
Плагин
web ищет текст вашего последнего сообщения. Если сообщение длинное или вопрос многосоставный, задайте точный поисковый запрос в search_prompt.Проверяйте annotations
Проверяйте annotations
Наличие
url_citation в annotations подтверждает, что поиск был выполнен и его результаты попали к модели. Если annotations пуст — поиск ничего не нашёл или поисковик не ответил.Комбинация с изображениями
Комбинация с изображениями
Веб-поиск можно комбинировать с отправкой изображений. Например, отправьте фото продукта и попросите найти актуальные цены — задайте название товара в
search_prompt.Следующие шаги
Плагины
Все доступные плагины и их настройки
Tool Calling
Вызов функций для получения данных
Responses API
Документация Responses API
Chat Completions
Основы работы с Chat Completions API