📖 Sommaire
- Qu’est-ce qu’un sous-agent ?
- Créer votre propre équipe d’experts
- L’exécution parallèle : Le multiplicateur de force
- Comment utiliser les sous-agents ?
L’automatisation du développement via l’IA franchit un nouveau cap avec l’introduction des sous-agents dans Gemini CLI. Si vous utilisez déjà Gemini CLI pour vos tâches quotidiennes, vous savez que confier des missions complexes à un agent généraliste peut parfois encombrer sa fenêtre de contexte ou diluer son efficacité. C’est ici que les sous-agents entrent en jeu, agissant comme une équipe d’experts à votre disposition.
Qu’est-ce qu’un sous-agent ?
Dans Gemini CLI, l’agent principal avec lequel vous interagissez agit désormais comme un orchestrateur stratégique. Lorsque vous lui soumettez une tâche vaste ou complexe, il peut déléguer des sous-tâches spécifiques au sous-agent le plus qualifié pour le travail.
Un sous-agent est un agent spécialisé qui opère de manière totalement isolée. Il possède :
- Sa propre fenêtre de contexte.
- Ses propres instructions système.
- Un ensemble d’outils (Tools) et de serveurs MCP (Model Context Protocol) restreint et pertinent.
L’exécution complète du sous-agent (qui peut impliquer des dizaines d’appels d’outils, des recherches de fichiers ou l’exécution de tests) est consolidée en une seule réponse formatée renvoyée à l’agent principal.
Les avantages clés :
- Maintien du cap : L’agent principal reste concentré sur l’objectif global et la prise de décision, sans être noyé dans les détails d’implémentation.
- Prévention de la pollution du contexte : Le contexte de votre session principale reste propre et rapide (“lean”), car seules les conclusions des sous-agents y sont intégrées.
- Vitesse accrue : La capacité d’exécuter des sous-agents en parallèle accélère drastiquement les phases de recherche, d’analyse ou de test.
Créer votre propre équipe d’experts
La véritable puissance de cette mise à jour réside dans la possibilité de créer des sous-agents personnalisés. Vous pouvez définir des membres d’équipe virtuels pour automatiser des workflows spécifiques, faire respecter vos standards de code, ou adopter une “persona” adaptée à votre projet.
La configuration est simplissime : il suffit de créer un fichier Markdown (.md) contenant un en-tête YAML (Frontmatter).
Vous pouvez les définir :
- Globalement : dans
~/.gemini/agents/pour votre usage personnel. - Localement : dans
.gemini/agents/à la racine de votre dépôt pour les partager avec votre équipe.
Exemple : Un spécialiste Frontend
Voici comment définir un agent expert en architectures web modernes :
name: frontend-specialist
description: Spécialiste frontend pour la création d'applications web performantes, accessibles et scalables.
tools:
- read_file
- grep_search
- glob
- list_directory
- web_fetch
- google_web_search
model: inherit
Vous êtes un spécialiste Frontend Senior et Architecte UI/UX. Votre objectif est de concevoir et d'implémenter des interfaces utilisateur exceptionnelles, esthétiques et fonctionnellement robustes.
### Principes Fondamentaux :
- **Architecture & Scalabilité :** Conception modulaire. Expert en développement orienté composants et micro-frontends.
- **Performance :** Priorité à la rapidité (Core Web Vitals, SSR, SSG).
- **Accessibilité :** Interfaces inclusives par défaut (WCAG 2.1+, ARIA).
Votre rôle est strictement d'analyser, de signaler les points d'amélioration et de faire des suggestions stratégiques. Ne modifiez pas le code vous-même, faites uniquement des suggestions.
En sauvegardant ce fichier sous .gemini/agents/frontend-specialist.md, votre agent principal peut instantanément faire appel à cet expert.
L’exécution parallèle : Le multiplicateur de force
Gemini CLI ne se contente pas d’enchaîner les sous-agents ; il peut les faire travailler simultanément.
Si vous devez analyser cinq composants distincts ou faire des recherches sur plusieurs sujets, vous pouvez demander à Gemini CLI d’exécuter l’agent frontend-specialist sur chaque élément en parallèle.

⚠️ Attention : L’exécution parallèle pour des tâches impliquant l’écriture ou la modification de code doit être utilisée avec précaution pour éviter les conflits de fichiers. De plus, cela consomme vos quotas de requêtes beaucoup plus rapidement.
Comment utiliser les sous-agents ?
Gemini CLI est fourni avec plusieurs sous-agents prêts à l’emploi :
generalist: Un agent polyvalent, idéal pour les tâches itératives intenses sans polluer votre contexte principal.cli_help: L’expert de la documentation Gemini CLI, pour répondre à vos questions sur l’outil lui-même.codebase_investigator: Un enquêteur spécialisé dans l’exploration de code, l’analyse des causes de bugs et la cartographie d’architecture.
Routage automatique ou manuel
Par défaut, Gemini CLI achemine automatiquement les tâches vers les sous-agents appropriés en lisant leur description. Mais vous pouvez aussi forcer l’intervention d’un expert spécifique en utilisant la syntaxe @agent dans votre prompt :
- “@frontend-specialist Peux-tu passer en revue le composant Header et suggérer des améliorations d’accessibilité ?”
- “@codebase_investigator Cartographie le flux d’authentification de l’application.”
Pour voir tous vos agents disponibles à tout moment, tapez simplement /agents dans votre console Gemini CLI.
L’arrivée des sous-agents transforme Gemini CLI d’un simple assistant en un véritable manager de projet capable de diriger une équipe d’experts. C’est une évolution majeure pour gérer des bases de code toujours plus complexes de manière structurée et efficace.
Sources :