Инструмент Task (`task`)

В этом документе описывается инструмент task для Qwen Code.

Описание

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

Аргументы

task принимает следующие аргументы:

description (string, обязательно): Краткое описание задачи (3–5 слов) для отображения пользователю и отслеживания.
prompt (string, обязательно): Подробный промпт задачи для выполнения субагентом. Должен содержать исчерпывающие инструкции для автономного выполнения.
subagent_type (string, обязательно): Тип специализированного агента для данной задачи. Должен соответствовать одному из доступных настроенных субагентов.

Как использовать `task` в Qwen Code

Инструмент Task динамически загружает доступные субагенты из вашей конфигурации и делегирует им задачи. Каждый субагент работает независимо и может использовать собственный набор инструментов, что обеспечивает применение специализированных знаний и параллельное выполнение.

При использовании инструмента Task субагент:

Получит промпт задачи и будет работать полностью автономно
Выполнит задачу с помощью доступных ему инструментов
Вернёт итоговое сообщение с результатом
Завершит работу (субагенты не сохраняют состояние и предназначены для однократного использования)

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


task(description="Brief task description", prompt="Detailed task instructions for the subagent", subagent_type="agent_name")

Доступные субагенты

Список доступных субагентов зависит от вашей конфигурации. Типичные типы субагентов могут включать:

general-purpose: Для сложных многошаговых задач, требующих использования различных инструментов
code-reviewer: Для ревью и анализа качества кода
test-runner: Для запуска тестов и анализа результатов
documentation-writer: Для создания и обновления документации

Просмотреть доступные субагенты можно с помощью команды /agents в Qwen Code.

Возможности инструмента Task

Обновления прогресса в реальном времени

Инструмент Task предоставляет обновления в реальном времени, отображающие:

Статус выполнения субагента
Отдельные вызовы инструментов, выполняемые субагентом
Результаты вызовов инструментов и возникающие ошибки
Общий прогресс задачи и статус завершения

Параллельное выполнение

Вы можете запустить несколько субагентов одновременно, вызвав инструмент Task несколько раз в одном сообщении. Это обеспечивает параллельное выполнение задач и повышает эффективность.

Специализированные знания

Каждый субагент можно настроить с помощью:

Определённых прав доступа к инструментам
Специализированных системных промптов и инструкций
Пользовательских конфигураций моделей
Предметных знаний и возможностей

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

Делегирование задачи агенту общего назначения


task(
  description="Code refactoring",
  prompt="Please refactor the authentication module in src/auth/ to use modern async/await patterns instead of callbacks. Ensure all tests still pass and update any related documentation.",
  subagent_type="general-purpose"
)

Запуск параллельных задач


# Launch code review and test execution in parallel
task(
  description="Code review",
  prompt="Review the recent changes in the user management module for code quality, security issues, and best practices compliance.",
  subagent_type="code-reviewer"
)

task(
  description="Run tests",
  prompt="Execute the full test suite and analyze any failures. Provide a summary of test coverage and recommendations for improvement.",
  subagent_type="test-runner"
)

Генерация документации


task(
  description="Update docs",
  prompt="Generate comprehensive API documentation for the newly implemented REST endpoints in the orders module. Include request/response examples and error codes.",
  subagent_type="documentation-writer"
)

Когда использовать инструмент Task

Используйте инструмент Task, когда:

Сложные многошаговые задачи — задачи, требующие выполнения нескольких операций, которые можно обработать автономно
Специализированные знания — задачи, выигрывающие от применения предметных знаний или специализированных инструментов
Параллельное выполнение — когда есть несколько независимых задач, которые могут выполняться одновременно
Необходимость делегирования — когда вы хотите передать задачу целиком, а не управлять каждым шагом вручную
Ресурсоёмкие операции — задачи, которые могут занять значительное время или вычислительные ресурсы

Когда НЕ стоит использовать инструмент Task

Не используйте инструмент Task для:

Простых одношаговых операций — используйте прямые инструменты, такие как Read, Edit и т.д.
Интерактивных задач — задач, требующих двустороннего общения
Чтения конкретных файлов — используйте инструмент Read напрямую для лучшей производительности
Простого поиска — используйте инструменты Grep или Glob напрямую

Важные примечания

Выполнение без сохранения состояния: Каждый вызов субагента независим и не сохраняет память о предыдущих выполнениях
Однократная коммуникация: Субагенты возвращают одно итоговое сообщение с результатом — постоянное взаимодействие не поддерживается
Исчерпывающие промпты: Ваш промпт должен содержать весь необходимый контекст и инструкции для автономного выполнения
Доступ к инструментам: Субагенты имеют доступ только к тем инструментам, которые указаны в их конфигурации
Возможность параллельной работы: Несколько субагентов могут выполняться одновременно для повышения эффективности
Зависимость от конфигурации: Доступные типы субагентов зависят от настроек вашей системы

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

Субагенты настраиваются через систему конфигурации агентов в Qwen Code. Используйте команду /agents, чтобы:

Просмотреть доступные субагенты
Создать новые конфигурации субагентов
Изменить настройки существующих субагентов
Настроить права доступа к инструментам и возможности

Дополнительную информацию о настройке субагентов см. в документации по субагентам.

Инструмент Task (task)