Gemini CLI Subagents

Что такое субагенты Gemini CLI?

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

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

Ключевые возможности

• Делегирование специализированным экспертам: Gemini CLI может разбивать крупную задачу на подзадачи и направлять их целевым субагентам.
• Изолированные среды выполнения: Каждый субагент работает со своим контекстным окном, системными инструкциями и подобранными инструментами, что помогает избежать перегрузки основной сессии.
• Консолидация инструментов и контекста: Промежуточные шаги, выполненные субагентами, объединяются в один ответ для основного агента.
• Параллельное выполнение субагентов: Gemini CLI поддерживает одновременный запуск нескольких субагентов (разных субагентов или нескольких экземпляров одного и того же).
• Настраиваемые определения субагентов: Вы можете создавать свои субагенты с помощью простых Markdown-файлов с YAML frontmatter.

Как использовать субагенты Gemini CLI

1. Создайте определение субагента с помощью Markdown-файла (.md) с YAML frontmatter, указывающим поля вроде name, description, tools и model (как в примере для «frontend-specialist»).
2. Добавьте определение в одно из поддерживаемых мест:
   • Для личных рабочих процессов: ~/.gemini/agents
   • Для совместного использования в команде/проекте: .gemini/agents
   • Для расширений: включите Markdown-файлы определений агентов в директорию agents/ расширения.
3. Используйте Gemini CLI как обычно: укажите общую задачу в основной сессии Gemini CLI; Gemini CLI затем запустит субагентов для обработки релевантных подзадач.
4. (При необходимости) выполняйте работу параллельно: когда задачи естественно делятся на несколько независимых направлений исследования/рефакторинга/тестирования, Gemini CLI может запустить несколько субагентов одновременно.

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

• Исследование по нескольким темам: Делегируйте отдельные исследовательские потоки разным субагентам и запускайте их параллельно, затем получайте консолидированные результаты в основной сессии.
• Рефакторинг нескольких компонентов: Разделите рефакторинг на отдельные задачи по компонентам и позвольте специализированным субагентам работать над каждой областью, не заполняя основное контекстное окно.
• Изучение и анализ кода: Используйте экспертных субагентов для исследования секций кода и возврата сводок или отформатированных результатов, пока основной агент поддерживает принятие решений и финальный синтез.
• Тестирование и валидация: Передайте последовательности тестовых шагов (которые могут включать множество вызовов инструментов) субагентам, чтобы основная сессия оставалась отзывчивой.
• Автоматизация для конкретных рабочих процессов с пользовательскими персонами: Создайте повторно используемого специалиста (например, персону frontend/UI-UX), чтобы обеспечить единый подход и использование инструментов для повторяющихся рабочих процессов проектов.

Часто задаваемые вопросы

Чем субагенты отличаются от основной сессии Gemini CLI?
Субагенты — это специализированные экспертные агенты, работающие параллельно с основной сессией. Они функционируют в изоляции со своим контекстным окном, системными инструкциями и инструментами, а затем возвращают консолидированные результаты.

Может ли Gemini CLI запускать несколько субагентов одновременно?
Да. Gemini CLI поддерживает параллельное выполнение, включая запуск нескольких субагентов или нескольких экземпляров одного и того же субагента одновременно.

Как настраиваются пользовательские субагенты?
Пользовательские субагенты определяются с помощью Markdown-файлов (.md) с YAML frontmatter. Их можно размещать в ~/.gemini/agents для личного использования, .gemini/agents для совместного использования на уровне проекта или в директории agents/ расширения.

Что происходит с промежуточной работой субагентов?
Субагенты могут выполнять множество вызовов инструментов, поисков файлов или тестовых запусков, но их выполнение консолидируется в единый ответ для основного агента.

Есть ли у субагентов свои инструменты и системные инструкции?
Да. Каждый субагент работает со своим подобранным набором инструментов и пользовательскими системными инструкциями, отличными от основной сессии.

Альтернативы

• Промптинг с одним агентом без делегирования: Вы можете попросить Gemini CLI обработать всё в одном контексте. Это избавляет от настройки пользовательских агентов, но может потребовать длинных промптов или страдать от роста контекста.
• Ручное разделение workflow: Вы можете запускать отдельные независимые промпты для каждой подзадачи и затем объединять результаты вручную. Это может имитировать делегирование, но вы сами занимаетесь оркестрацией и консолидацией.
• Универсальные фреймворки для мультиагентов: Подходы на основе инструментов или фреймворков для мультиагентов также могут направлять задачи специализированным ролям, хотя workflow и конфигурация будут отличаться от определений subagents и модели изоляции в Gemini CLI.
• Ролевые агенты на основе чата (не subagents): Если ваш сценарий в основном требует ролевой помощи, а не изолированного параллельного выполнения инструментов, вам может хватить простого ролевого промптинга с меньшим контролем над изоляцией и консолидированными выходами подзадач.