Инструмент веб-поиска (`web_search`)

В этом документе описывается инструмент web_search, предназначенный для выполнения веб-поиска с использованием нескольких поставщиков услуг.

Описание

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

Поддерживаемые поставщики

DashScope (официальный, бесплатный) — автоматически доступен пользователям Qwen с аутентификацией через OAuth (200 запросов/минуту, 1000 запросов/день)
Tavily — высококачественный API поиска с встроенной генерацией ответов
Google Custom Search — JSON API пользовательского поиска Google

Аргументы

web_search принимает два аргумента:

query (строка, обязательный): поисковый запрос
provider (строка, необязательный): конкретный поставщик для использования ("dashscope", "tavily", "google")
- Если не указан, используется поставщик по умолчанию из конфигурации

Конфигурация

Способ 1: Файл настроек (рекомендуется)

Добавьте в файл settings.json:


{
  "webSearch": {
    "provider": [
      { "type": "dashscope" },
      { "type": "tavily", "apiKey": "tvly-xxxxx" },
      {
        "type": "google",
        "apiKey": "your-google-api-key",
        "searchEngineId": "your-search-engine-id"
      }
    ],
    "default": "dashscope"
  }
}

Примечания:

Для DashScope ключ API не требуется (официальный бесплатный сервис).
Пользователи Qwen с OAuth: DashScope автоматически добавляется в список провайдеров, даже если он не указан явно.
Настройте дополнительных провайдеров (Tavily, Google), если вы хотите использовать их вместе с DashScope.
Укажите параметр default, чтобы задать провайдера, используемого по умолчанию (если не задан, приоритет определяется в порядке: Tavily > Google > DashScope).

Способ 2: Переменные окружения

Установите переменные окружения в оболочке или в файле .env:


 
# Tavily
export TAVILY_API_KEY="tvly-xxxxx"
 
# Google
export GOOGLE_API_KEY="ваш-ключ-api"
export GOOGLE_SEARCH_ENGINE_ID="ваш-id-поисковой-системы"

Способ 3: Аргументы командной строки

Передайте ключи API при запуске Qwen Code:


 
# Tavily
qwen --tavily-api-key tvly-xxxxx
 
# Google
qwen --google-api-key ваш-ключ --google-search-engine-id ваш-id
 
# Укажите поставщика по умолчанию
qwen --web-search-default tavily

Обратная совместимость (устаревший способ)

⚠️ УСТАРЕВШИЙ: Устаревшая конфигурация tavilyApiKey по-прежнему поддерживается для обратной совместимости, но считается устаревшей:


{
  "advanced": {
    "tavilyApiKey": "tvly-xxxxx" // ⚠️ Устаревший способ
  }
}

Важно: Эта конфигурация устарела и будет удалена в одной из будущих версий. Пожалуйста, перейдите на новый формат конфигурации webSearch, показанный выше. Старая конфигурация автоматически настроит Tavily как поставщика, однако мы настоятельно рекомендуем обновить вашу конфигурацию.

Отключение веб-поиска

Если вы хотите отключить функцию веб-поиска, исключите инструмент web_search в файле settings.json:


{
  "tools": {
    "exclude": ["web_search"]
  }
}

Примечание: Для применения этого параметра требуется перезапуск Qwen Code. После отключения инструмент web_search станет недоступен модели, даже если настроены поставщики веб-поиска.

Примеры использования

Базовый поиск (с использованием поставщика по умолчанию)


web_search(query="последние достижения в области ИИ")

Поиск с указанием конкретного поставщика


web_search(query="последние достижения в области ИИ", provider="tavily")

Примеры из реального мира


web_search(query="погода в Сан-Франциско сегодня")
web_search(query="последняя LTS-версия Node.js", provider="google")
web_search(query="лучшие практики для React 19", provider="dashscope")

Сведения о поставщиках

DashScope (официальный)

Стоимость: Бесплатно
Аутентификация: Доступен автоматически при использовании аутентификации Qwen через OAuth
Конфигурация: Ключ API не требуется; автоматически добавляется в список провайдеров для пользователей Qwen с OAuth
Квота: 200 запросов/минуту, 1000 запросов/день
Рекомендуется для: Общих запросов; всегда доступен как резервный вариант для пользователей Qwen с OAuth
Автоматическая регистрация: Если вы используете аутентификацию Qwen через OAuth, DashScope автоматически добавляется в ваш список провайдеров, даже если вы не настраивали его явно

Tavily

Стоимость: Требуется ключ API (платный сервис с бесплатным тарифным планом)
Регистрация: https://tavily.com
Возможности: Высококачественные результаты с ответами, сгенерированными ИИ
Рекомендуется для: Исследований, исчерпывающих ответов со ссылками на источники

Google Custom Search

Стоимость: Доступен бесплатный тариф (100 запросов в день)
Настройка:
1. Включите API Custom Search в Google Cloud Console
2. Создайте поисковую систему Custom Search по адресу https://programmablesearchengine.google.com
Возможности: Качество поиска Google
Рекомендуется для: Конкретных, фактологических запросов

Важные замечания

Формат ответа: Возвращается краткий ответ с нумерованными ссылками на источники
Ссылки на источники: Добавляются в виде нумерованного списка: [1], [2] и т. д.
Несколько провайдеров: Если один из провайдеров не сработал, укажите другой вручную с помощью параметра provider
Доступность DashScope: Автоматически доступен для пользователей Qwen с OAuth — дополнительная настройка не требуется
Выбор провайдера по умолчанию: Система автоматически выбирает провайдера по умолчанию в зависимости от доступности:
1. Ваша явно заданная конфигурация default (наивысший приоритет)
2. Аргумент CLI --web-search-default
3. Первый доступный провайдер по приоритету: Tavily > Google > DashScope

Устранение неполадок

Инструмент недоступен?

Для пользователей Qwen с OAuth: инструмент автоматически регистрируется у провайдера DashScope, дополнительная настройка не требуется
Для других типов аутентификации: убедитесь, что настроен хотя бы один провайдер (Tavily или Google)
Для Tavily/Google: проверьте корректность ваших API-ключей

Ошибки, специфичные для провайдера?

Используйте параметр provider, чтобы попробовать другой поисковый провайдер
Проверьте лимиты использования API и ограничения частоты запросов
Убедитесь, что API-ключи правильно указаны в конфигурации

Нужна помощь?

Проверьте свою конфигурацию: запустите qwen и воспользуйтесь диалоговым окном настроек
Просмотрите текущие настройки в файле ~/.qwen-code/settings.json (macOS/Linux) или %USERPROFILE%\.qwen-code\settings.json (Windows)

Инструмент веб-поиска (web_search)