Qwen Web Search

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

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

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

Поисковый интерфейс должен явно поддерживаться моделью

Название серии Qwen не доказывает доступность enable_search, Responses Web Search или выбора поисковой системы. Проверьте модель и протокол в каталоге моделей.

Поиск через Chat

В прежней документации основной путь Qwen Chat использовал enable_search:

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": "Какая сегодня погода в Ханчжоу? Укажите источники."
      }
    ],
    "enable_search": true
  }'

enable_search — расширенное поле модели или канала, а не общий параметр всех моделей Chat. Если SDK не содержит такого поля, используйте обычный HTTP-запрос или механизм дополнительных параметров SDK, руководствуясь документацией модели.

Встроенный поиск через Responses

Если модель поддерживает Responses Web Search, используйте структуру встроенного инструмента:

curl 'https://api.agtcloud.cn/v1/responses' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your-api-key' \
  --data '{
    "model": "MODEL_ID",
    "tools": [
      {
        "type": "web_search_preview"
      }
    ],
    "input": "Какая сегодня погода в Ханчжоу? Укажите источники."
  }'

Результат Responses может содержать web_search_call, текстовый Output Item и url_citation. Полная структура приведена в Responses Reference.

Выбор поисковой системы или Provider

Нативный поисковый фреймворк Qwen может поддерживать разных Provider. Это возможность конкретной модели, Agent-фреймворка или канала, а не единое поле AGTCloud Chat.

Если документация текущей модели явно предоставляет выбор Provider:

Стандартный Provider уменьшает настройки и сохраняет серверное резервное поведение.
Явный Provider подходит при конкретных требованиях к источникам, качеству поиска или нормативным ограничениям.
Учётные данные и права Provider храните на сервере, не в Prompt или браузерном коде.
Автоматическая смена недоступного Provider зависит от реализации инструмента; клиент всё равно должен обрабатывать ошибки.

Не превращайте имена поисковых систем и их стандартный порядок из старой документации в долгосрочное обещание платформы.

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

Разные интерфейсы могут возвращать:

Интерфейс	Ответ	Ссылки
Расширение Chat	`choices[].message.content`	Annotation, ссылки или нумерованные источники из ответа
Responses	Message Output Item	`url_citation` в `annotations`
Нативный поисковый фреймворк	Ответ фреймворка	Нумерованный список или объекты источников от Provider

Если текст использует номера [1], [2], клиент должен получить соответствующие URL источников: нельзя показывать только номера без целевых ссылок.

{
  "answer": "Сегодня в Ханчжоу ожидаются кратковременные дожди.[1]",
  "sources": [
    {
      "index": 1,
      "title": "Название источника",
      "url": "https://example.com/weather"
    }
  ]
}

Пример показывает возможные внутренние данные приложения для отображения, а не фиксированную Schema ответа AGTCloud API.

Нативный поиск и собственные функции

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

Текст собственного инструмента автоматически не получает доверенную Citation. Возвращайте также метаданные источников и сохраняйте связь ответа с ними в итоговом интерфейсе.

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

Ситуация	Действие
`enable_search` отклонён	Проверьте поддержку расширенного поля моделью и каналом либо выберите зарегистрированный интерфейс Responses
Поиск не запустился	Проверьте необходимость актуальных данных и фактическую передачу поля включения вышестоящему сервису
У номера нет URL источника	Не делайте его кликабельным; сообщите об отсутствии полных сведений об источниках
Provider недоступен	Смените его по правилам инструмента или ограниченно повторите запрос; не перебирайте Provider бесконечно
Результаты противоречат друг другу	Покажите источники и даты, не позволяйте модели скрывать важные расхождения

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

Модель явно поддерживает enable_search или выбранный инструмент Responses.
SDK не отбрасывает расширенные поля молча.
Chat, Responses и нативный поиск используют отдельные парсеры.
Номера ссылок связаны с реальными заголовками и URL.
Настройки и учётные данные Provider не попадают в клиентский Prompt.
Отсутствие результатов, ошибки поиска и недоступные источники имеют явное резервное поведение.

Общие поля Chat см. в Chat Completions Reference. При ошибках см. Ошибки и диагностика.