Инструмент задач (task)
В этом документе описывается инструмент task для Qwen Code.
Описание
Используйте task, чтобы запустить специализированного подагентов для автономного выполнения сложных многошаговых задач. Инструмент задач делегирует работу специализированным агентам, которые могут работать независимо и имеют доступ к собственному набору инструментов, что позволяет выполнять задачи параллельно и применять узкоспециализированные знания.
Аргументы
task принимает следующие аргументы:
description(строка, обязательный): Краткое описание задачи (3–5 слов) для удобства отображения пользователю и отслеживания.prompt(строка, обязательный): Подробное задание для подагента. Должно содержать исчерпывающие инструкции для автономного выполнения.subagent_type(строка, обязательный): Тип специализированного агента, используемого для этой задачи. Должен соответствовать одному из доступных настроенных подагентов.
Как использовать task с Qwen Code
Инструмент Task динамически загружает доступные подагенты из вашей конфигурации и делегирует им задачи. Каждый подагент работает независимо и может использовать собственный набор инструментов, что обеспечивает специализированную экспертизу и параллельное выполнение.
При использовании инструмента Task подагент:
- Получает запрос задачи с полной автономией
- Выполняет задачу с помощью доступных ему инструментов
- Возвращает финальное сообщение с результатом
- Завершает работу (подагенты не сохраняют состояние и предназначены для однократного использования)
Использование:
task(description="Краткое описание задачи", prompt="Подробные инструкции по выполнению задачи для подагента", subagent_type="имя_агента")Доступные подагенты
Доступные подагенты зависят от вашей конфигурации. Типичные типы подагентов могут включать:
- general-purpose — для сложных многошаговых задач, требующих использования различных инструментов
- code-reviewer — для проверки и анализа качества кода
- test-runner — для запуска тестов и анализа результатов
- documentation-writer — для создания и обновления документации
Список доступных подагентов можно просмотреть с помощью команды /agents в Qwen Code.
Возможности инструмента «Задача»
Обновления хода выполнения в реальном времени
Инструмент «Задача» предоставляет обновления в реальном времени, отображающие:
- Статус выполнения подагента
- Отдельные вызовы инструментов, выполняемые подагентом
- Результаты вызовов инструментов и возможные ошибки
- Общий прогресс выполнения задачи и статус завершения
Параллельное выполнение
Вы можете одновременно запустить несколько подагентов, вызвав инструмент «Задача» несколько раз в одном сообщении. Это позволяет выполнять задачи параллельно и повышает общую эффективность.
Специализированная экспертиза
Каждый подагент можно настроить следующим образом:
- Разрешения на доступ к конкретным инструментам
- Специализированные системные подсказки и инструкции
- Пользовательские конфигурации моделей
- Знания и возможности, специфичные для определённой предметной области
Примеры использования task
Делегирование задачи агенту общего назначения
task(
description="Рефакторинг кода",
prompt="Пожалуйста, выполните рефакторинг модуля аутентификации в src/auth/, заменив колбэки на современные конструкции async/await. Убедитесь, что все тесты по-прежнему проходят, и обновите соответствующую документацию.",
subagent_type="general-purpose"
)Выполнение параллельных задач
Запуск проверки кода и выполнения тестов параллельно
task( description=“Проверка кода”, prompt=“Проверьте недавние изменения в модуле управления пользователями на соответствие требованиям качества кода, безопасности и лучшим практикам.”, subagent_type=“code-reviewer” )
task( description=“Запуск тестов”, prompt=“Выполните полный набор тестов и проанализируйте возможные сбои. Предоставьте сводку по охвату кода тестами и рекомендации по её улучшению.”, subagent_type=“test-runner” )
### Генерация документации
task( description=“Обновление документации”, prompt=“Создайте подробную документацию API для вновь реализованных REST-эндпоинтов в модуле заказов. Включите примеры запросов и ответов, а также коды ошибок.”, subagent_type=“documentation-writer” )
## Когда использовать инструмент Task
Используйте инструмент Task в следующих случаях:
1. **Сложные многошаговые задачи** — задачи, требующие выполнения нескольких операций, которые могут быть обработаны автономно
2. **Специализированная экспертиза** — задачи, выигрывающие от предметно-ориентированных знаний или инструментов
3. **Параллельное выполнение** — когда у вас есть несколько независимых задач, которые можно запустить одновременно
4. **Необходимость делегирования** — когда вы хотите передать всю задачу целиком, а не контролировать каждый её шаг
5. **Ресурсоёмкие операции** — задачи, которые могут занять значительное время или потребовать больших вычислительных ресурсов
## Когда НЕ следует использовать инструмент Task
Не используйте инструмент Task для:
- **Простых одношаговых операций** — используйте прямые инструменты, например Read, Edit и т. д.
- **Интерактивных задач** — задач, требующих двустороннего взаимодействия
- **Чтения конкретных файлов** — для лучшей производительности используйте инструмент Read напрямую
- **Простых поисковых операций** — используйте инструменты Grep или Glob напрямую
## Важные замечания
- **Безсостоянное выполнение**: Каждый вызов подагентов независим и не сохраняет память о предыдущих выполнениях
- **Единая коммуникация**: Подагенты возвращают одно финальное сообщение с результатом — непрерывного взаимодействия нет
- **Исчерпывающие промпты**: Ваш промпт должен содержать весь необходимый контекст и инструкции для автономного выполнения
- **Доступ к инструментам**: Подагенты имеют доступ только к тем инструментам, которые настроены в их конкретной конфигурации
- **Параллельное выполнение**: Несколько подагентов могут выполняться одновременно для повышения эффективности
- **Зависимость от конфигурации**: Доступные типы подагентов зависят от вашей системной конфигурации
## Конфигурация
Подагенты настраиваются через систему конфигурации агентов Qwen Code. Используйте команду `/agents`, чтобы:
- Просматривать доступные подагенты
- Создавать новые конфигурации подагентов
- Изменять существующие настройки подагентов
- Назначать разрешения и возможности для инструментов
Дополнительную информацию о настройке подагентов см. в документации по подагентам.