Gemini CLI Subagents

Qu'est-ce que Gemini CLI subagents ?

Les subagents sont des agents experts spécialisés qui fonctionnent aux côtés de votre session principale Gemini CLI. Lorsque vous confiez à Gemini CLI une tâche large ou complexe, l'agent principal peut déléguer des sous-tâches spécifiques à lsubagent le plus pertinent, agissant comme un orchestrateur.

Chaque subagent s'exécute de manière isolée avec sa propre fenêtre de contexte séparée, des instructions système personnalisées et un ensemble d'outils sélectionnés. Leur travail — potentiellement impliquant de nombreux appels d'outils, recherches ou exécutions de tests — est consolidé en une seule réponse renvoyée à la session principale.

Fonctionnalités principales

• Délégation à des experts spécialisés : Gemini CLI peut décomposer une grande tâche en sous-tâches et les router vers des subagents ciblés.
• Environnements d'exécution isolés : Chaque subagent s'exécute avec sa propre fenêtre de contexte, instructions système et outils sélectionnés, évitant de surcharger la session principale.
• Consolidation des outils et du contexte : Les étapes intermédiaires effectuées par les subagents sont consolidées en une seule réponse pour l'agent principal.
• Exécution parallèle de subagents : Gemini CLI prend en charge l'exécution simultanée de plusieurs subagents (soit différents subagents, soit plusieurs instances du même subagent).
• Définitions personnalisées de subagents : Vous pouvez créer vos propres subagents à l'aide de fichiers Markdown simples avec YAML frontmatter.

Comment utiliser Gemini CLI subagents

1. Créez une définition de subagent à l'aide d'un fichier Markdown (.md) avec YAML frontmatter spécifiant des champs tels que name, description, tools et model (comme dans l'exemple fourni pour un « frontend-specialist »).
2. Ajoutez la définition dans l'un des emplacements pris en charge :
   • Pour les workflows personnels : ~/.gemini/agents
   • Pour le partage d'équipe/projet : .gemini/agents
   • Pour les extensions : incluez les fichiers Markdown de définition d'agent dans le répertoire agents/ de l'extension.
3. Utilisez Gemini CLI comme d'habitude : fournissez votre tâche globale dans la session principale Gemini CLI ; Gemini CLI peut alors dispatcher des subagents pour gérer les sous-tâches pertinentes.
4. (Si nécessaire) exécutez le travail en parallèle : lorsque les tâches se divisent naturellement en plusieurs pistes de recherche/refactorisation/tests indépendantes, Gemini CLI peut dispatcher plusieurs subagents simultanément.

Cas d'utilisation

• Recherche sur plusieurs sujets : Déléguez des fils de recherche séparés à différents subagents et exécutez-les en parallèle, puis recevez les sorties consolidées dans la session principale.
• Refactorisation de plusieurs composants : Divisez une refactorisation en tâches distinctes au niveau des composants et laissez des subagents spécialisés travailler sur chaque domaine sans remplir la fenêtre de contexte principale.
• Exploration et analyse de code : Utilisez des subagents experts pour examiner des sections de code et renvoyer des résumés ou résultats formatés, tandis que l'agent principal maintient la prise de décision et la synthèse finale.
• Tests et validation : Déchargez des séquences d'étapes liées aux tests (qui peuvent impliquer de nombreux appels d'outils) vers des subagents pour que la session principale reste réactive.
• Automatisation spécifique aux workflows avec des personas personnalisés : Créez un agent spécialiste réutilisable (par ex., un persona frontend/UI-UX) pour imposer une approche cohérente et une utilisation d'outils pour des workflows de projet répétés.

FAQ

En quoi les subagents diffèrent-ils de la session principale Gemini CLI ?
Les subagents sont des agents experts spécialisés qui s'exécutent aux côtés de votre session principale. Ils fonctionnent de manière isolée avec leur propre fenêtre de contexte, instructions système et outils, puis renvoient des résultats consolidés.

Gemini CLI peut-il exécuter plus d'un subagent à la fois ?
Oui. Gemini CLI prend en charge l'exécution parallèle, y compris le lancement de plusieurs subagents ou de plusieurs instances du même subagent simultanément.

Comment configurer des subagents personnalisés ?
Les subagents personnalisés sont définis avec des fichiers Markdown (.md) incluant un YAML frontmatter. Vous pouvez les placer dans ~/.gemini/agents pour un usage personnel, .gemini/agents pour un partage au niveau du projet, ou le répertoire agents/ d'une extension.

Que devient le travail intermédiaire effectué par les subagents ?
Les subagents peuvent exécuter de nombreux appels d'outils, recherches de fichiers ou exécutions de tests, mais leur exécution est consolidée en une seule réponse renvoyée à l'agent principal.

Les subagents ont-ils leurs propres outils et instructions système ?
Oui. Chaque subagent s'exécute avec son propre ensemble d'outils sélectionnés et des instructions système personnalisées, distincts de la session principale.

Alternatives

• Prompting mono-agent sans délégation : Vous pouvez demander à Gemini CLI de tout gérer dans un seul contexte. Cela évite la configuration d’agents personnalisés, mais peut nécessiter des prompts plus longs ou souffrir d’une croissance du contexte.
• Fractionnement manuel du workflow : Vous pouvez exécuter des prompts séparés et indépendants pour chaque sous-tâche, puis fusionner les résultats vous-même. Cela peut imiter la délégation, mais vous gérez l’orchestration et la consolidation.
• Frameworks multi-agents généralistes : Les approches multi-agents basées sur des outils ou frameworks peuvent aussi router les tâches vers des rôles spécialisés, bien que le workflow et la configuration diffèrent des définitions de sous-agents et du modèle d’isolation de Gemini CLI.
• Rôles d’agents basés sur chat (non sous-agents) : Si votre cas d’usage est principalement une assistance basée sur des rôles plutôt qu’une exécution parallèle d’outils isolée, un simple prompting de rôles peut suffire, avec moins de contrôle sur l’isolation et les sorties consolidées des sous-travaux.