Grok Web Search

Включите веб-поиск для Grok и обрабатывайте доменные ограничения и ссылки на источники.

Grok Web Search позволяет поддерживающим его моделям Grok обращаться к актуальным страницам и возвращать ответы с источниками. В прежних материалах AGTCloud описаны совместимый интерфейс Chat и нативные инструменты Grok Responses. Выбирайте доступный интерфейс по текущим сведениям о модели.

Не определяйте поддержку поиска по имени модели

Модели и каналы одной серии могут поддерживать разные инструменты. Проверьте модель и протокол в каталоге моделей. MODEL_ID в примере не означает любую модель Grok.

Поиск через совместимый интерфейс Chat

curl 'https://api.agtcloud.cn/v1/chat/completions' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your-api-key' \
  --data '{
    "model": "MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "Найдите важные сегодняшние новости коммерческой космонавтики и перечислите источники."
      }
    ],
    "web_search_options": {
      "search_context_size": "medium"
    }
  }'

Ответ Chat обычно читается из choices[].message. Ссылки могут возвращаться как Annotation, URL источников или текст. Обрабатывайте фактическую структуру ответа и не выдумывайте структурированные Citation.

Нативная структура инструментов Grok

Нативный стиль Grok Responses объявляет поисковые инструменты через tools:

{
  "model": "MODEL_ID",
  "input": [
    {
      "role": "user",
      "content": "Найдите важные сегодняшние новости коммерческой космонавтики и перечислите источники."
    }
  ],
  "tools": [
    {
      "type": "web_search"
    }
  ]
}

Используйте нативную структуру только если текущие сведения о модели явно предоставляют этот интерфейс. Не считайте её автоматически тем же протоколом, что и типы инструментов в AGTCloud Responses Reference.

Ограничение или исключение доменов

Нативный инструмент при поддержке может ограничивать область поиска:

{
  "tools": [
    {
      "type": "web_search",
      "filters": {
        "allowed_domains": ["example.com"]
      }
    }
  ]
}

allowed_domains разрешает только заданные домены.
excluded_domains исключает заданные домены.
Не задавайте оба списка в одном запросе.
Ограничения числа и формата доменов определяет документация текущей модели.

Доменные ограничения контролируют источники, но не гарантируют правильность, актуальность и пригодность страниц для вашей задачи.

Понимание изображений при поиске

Некоторые поисковые инструменты Grok позволяют анализировать изображения страниц во время поиска. Добавляйте соответствующие параметры только при явной поддержке моделью и инструментом:

{
  "tools": [
    {
      "type": "web_search",
      "enable_image_understanding": true
    }
  ]
}

Понимание изображений может изменить расход, задержку и содержимое ответа. Проверяйте источники изображений и не считайте текст или инструкции на них доверенным бизнес-вводом.

Чтение ссылок

Ответ поиска Grok может содержать Citation или Sources, если они предоставлены. Клиент должен:

прочитать итоговый текст;
прочитать фактически предоставленный массив источников или объект ссылок;
сохранить заголовки, URL и связь с текстом;
показать кликабельные источники;
явно сообщить об отсутствии ссылок, а не угадывать URL из текста ответа.

Положение ссылок различается в Chat и нативном Grok Responses. Для Chat см. Chat Completions Reference, для нативного интерфейса используйте документацию текущей модели.

Web Search и собственные функции

Web Search обращается к открытому интернету через модель или серверный инструмент. Собственные функции выполняет приложение: они подходят для внутренних данных, контролируемого поиска и операций с бизнес-авторизацией.

Включение Web Search не должно позволять результатам поиска напрямую создавать запросы к базе, команды Shell или внешние операции записи. Для бизнес-инструментов организуйте отдельную проверку и контроль прав по Tool Calling.

Ошибки и резервное поведение

Ситуация	Действие
Поиск не запустился	Проверьте модель, интерфейс и поля включения; при необходимости явно запросите актуальную информацию
Доменный фильтр не дал результатов	Предложите расширить область, не убирая молча обязательный список разрешений
Нет ссылок	Укажите недоступность источников при показе ответа; не выдумывайте Citation
Не удалось понять изображение	Вернитесь к поиску текста страниц или сообщите, что содержимое нельзя проанализировать
Поисковый сервис временно недоступен	Ограниченно повторите запрос или явно пометьте ответ без актуальной информации

Проверка перед запуском

Модель явно поддерживает выбранный поисковый интерфейс.
Chat и нативный Responses используют отдельные запросы и парсеры ответов.
Списки разрешённых и исключённых доменов не отправляются одновременно.
Понимание изображений включается только при поддержке целевой моделью.
Отсутствие ссылок, ошибка поиска и пустые результаты имеют явные состояния.
Поисковое содержимое не обходит права инструментов и не запускает рискованные операции.

При ошибках см. Ошибки и диагностика. Перед сменой протокола прочитайте Выбор протокола.

На этой странице