Skip to Content
Руководство для разработчиковИнструментыВведение

Инструменты Qwen Code

Qwen Code включает встроенные инструменты, которые модель использует для взаимодействия с вашей локальной средой, получения информации и выполнения действий. Эти инструменты расширяют возможности CLI, позволяя ему выходить за рамки генерации текста и помогать в решении широкого круга задач.

Обзор инструментов Qwen Code

В контексте Qwen Code инструменты — это конкретные функции или модули, выполнение которых может запросить модель. Например, если вы попросите модель «Кратко перескажи содержимое my_document.txt», она, скорее всего, определит необходимость прочитать этот файл и запросит выполнение инструмента read_file.

Базовый компонент (packages/core) управляет этими инструментами, предоставляет их определения (схемы) модели, выполняет их по запросу и возвращает результаты модели для дальнейшей обработки в ответ, предназначенный для пользователя.

Эти инструменты предоставляют следующие возможности:

  • Доступ к локальной информации: Инструменты позволяют модели получать доступ к вашей локальной файловой системе, читать содержимое файлов, просматривать списки директорий и т. д.
  • Выполнение команд: С помощью таких инструментов, как run_shell_command, модель может запускать shell-команды (с соблюдением соответствующих мер безопасности и подтверждением пользователя).
  • Взаимодействие с веб-ресурсами: Инструменты могут получать содержимое по URL.
  • Выполнение действий: Инструменты могут изменять файлы, создавать новые или выполнять другие действия в вашей системе (как правило, также с использованием механизмов защиты).
  • Привязка ответов к контексту: Используя инструменты для получения актуальных или специфических локальных данных, модель формирует более точные и релевантные ответы, основанные на вашем реальном контексте.

Как использовать инструменты Qwen Code

Чтобы использовать инструменты Qwen Code, отправьте запрос в CLI. Процесс работает следующим образом:

  1. Вы отправляете запрос в CLI.
  2. CLI передает запрос в ядро.
  3. Ядро вместе с вашим запросом и историей диалога отправляет список доступных инструментов и их описания/схемы в настроенный API модели.
  4. Модель анализирует ваш запрос. Если она определяет, что требуется инструмент, её ответ будет содержать запрос на выполнение конкретного инструмента с определёнными параметрами.
  5. Ядро получает этот запрос, проверяет его и (часто после подтверждения пользователя для чувствительных операций) выполняет инструмент.
  6. Результат работы инструмента отправляется обратно модели.
  7. Модель использует результат работы инструмента для формирования итогового ответа, который затем через ядро возвращается в CLI и отображается вам.

В CLI обычно отображаются сообщения, указывающие на вызов инструмента, а также на успешность или сбой его выполнения.

Безопасность и подтверждение

Многие инструменты, особенно те, которые могут изменять файловую систему или выполнять команды (write_file, edit, run_shell_command), разработаны с учётом безопасности. Qwen Code обычно:

  • Требует подтверждения: Запрашивает разрешение перед выполнением потенциально чувствительных операций, показывая, какое действие будет выполнено.
  • Использует песочницу (sandboxing): Все инструменты подчиняются ограничениям, налагаемым песочницей (см. Изоляция в Qwen Code). Это означает, что при работе в песочнице любые инструменты (включая MCP-серверы), которые вы хотите использовать, должны быть доступны внутри среды песочницы. Например, чтобы запустить MCP-сервер через npx, исполняемый файл npx должен быть установлен в Docker-образе песочницы или быть доступен в окружении sandbox-exec.

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

Подробнее об инструментах Qwen Code

Встроенные инструменты Qwen Code можно разделить на следующие категории:

Кроме того, эти инструменты включают:

Last updated on
Java SDK (альфа-версия)Файловая система