Перейти к основному содержанию
Polza.AI добавляет веб-поиск к любой модели — от GPT-5 до Claude и Gemini: ищет сама Яндексом или Google либо передаёт поиск провайдеру модели, если он умеет искать. Модель получает актуальные данные из интернета, а вы — ответ со ссылками на источники.

Быстрый старт

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 — запрос не падает.
Модели Perplexity ищут в интернете всегда, на каждый запрос: для них плагин 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_schema может мешать модели включать цитаты и ссылки на источники. Если вам нужен структурированный вывод с веб-поиском, обрабатывайте текстовый ответ с аннотациями отдельно.
Плагин web ищет текст вашего последнего сообщения. Если сообщение длинное или вопрос многосоставный, задайте точный поисковый запрос в search_prompt.
Наличие url_citation в annotations подтверждает, что поиск был выполнен и его результаты попали к модели. Если annotations пуст — поиск ничего не нашёл или поисковик не ответил.
Веб-поиск можно комбинировать с отправкой изображений. Например, отправьте фото продукта и попросите найти актуальные цены — задайте название товара в search_prompt.

Следующие шаги

Плагины

Все доступные плагины и их настройки

Tool Calling

Вызов функций для получения данных

Responses API

Документация Responses API

Chat Completions

Основы работы с Chat Completions API