Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Subagents: déléguer des tâches spécialisées

Les 5 van 14 Bijgewerkt op 2 november 2026 Gevorderd
Op deze pagina
  1. Le principe de délégation
  2. Configuration d’un sous-agent
  3. Cas d’usage concrets
  4. Concevoir un bon sous-agent
  5. Règles imposées par Vibe
  6. Belangrijkste punten

Leçon mise à jour le 2 novembre 2026. Les fichiers d’exemple d’agents utilisent désormais les clés documentées par Vibe : instructions (et non system_prompt), active_model (et non model), des blocs [tools.<tool>] pour les approbations (la clé auto_approve n’existe pas dans un fichier d’agent), et les noms réels des outils (edit, et non edit_file ; pas d’outil list_dir). Rappel de la leçon 3 : safety est un indicateur visuel, pas une permission. Source : Référence de configuration.

Le principe de délégation

Dans les projets complexes, certaines tâches sont indépendantes les unes des autres : analyser la sécurité d’un fichier pendant qu’un autre processus génère des tests. Au lieu de tout traiter séquentiellement, Mistral Vibe vous permet de déléguer des tâches à des sous-agents. Un sous-agent est un agent qui s’exécute de manière indépendante, accomplit sa mission et renvoie un résultat textuel à l’agent principal. Il ne peut pas poser de questions à l’utilisateur : il doit être totalement autonome.

Cette contrainte est la clé de tout ce qui suit et mérite d’être détaillée. Un sous-agent s’exécute dans son propre contexte, sans accès à la conversation en cours ; il ignore tout de ce que vous avez expliqué à l’agent principal il y a cinq minutes. Il ne peut pas utiliser ask_user_question et doit gérer les ambiguïtés seul. Il renvoie du texte que l’agent principal intègre ensuite à sa réponse. Parce qu’il est coupé de l’échange, il n’a de sens que lorsqu’il est conçu pour une tâche spécifique et bien définie.

Configuration d’un sous-agent

Pour transformer un agent en sous-agent, ajoutez le champ agent_type = "subagent" au fichier .toml. Le reste de la configuration suit les règles habituelles des agents personnalisés.

# ~/.vibe/agents/test-generator.toml
display_name = "Générateur de tests"
description = "Génère des tests unitaires pour des fonctions données."
agent_type = "subagent"
safety = "neutral"
active_model = "codestral"  # alias déclaré dans config.toml (Leçon 2)

instructions = """
Vous recevez du code source. Générez des tests unitaires complets :
- Tests de cas nominaux
- Tests de cas limites (null, undefined, chaînes vides)
- Tests d'erreurs attendues
Framework : utilisez le framework de test du projet (Jest, Vitest, Pytest...).
Renvoyez uniquement le code de test, prêt à être copié.
"""

enabled_tools = [
  "read_file",
  "grep",
]

Notez l’absence de ask_user_question dans les outils : ce n’est pas un oubli. Un sous-agent ne peut pas demander de clarification, et l’instruction système compense cette impossibilité en spécifiant à l’avance le framework de test à utiliser et le format exact de la réponse.

Cas d’usage concrets

Le premier avantage est le travail en parallèle. L’agent principal peut assigner simultanément plusieurs tâches à différents sous-agents, chacun travaillant de son côté avant de renvoyer son résultat.

Agent principal
├── Sous-agent "test-generator" → génère les tests
├── Sous-agent "doc-writer" → rédige la documentation
└── Sous-agent "security-checker" → analyse les vulnérabilités

Le deuxième avantage concerne les tâches hautement spécialisées. Certaines nécessitent une instruction système radicalement différente de celle de l’agent principal ; plutôt que de surcharger un seul agent avec des instructions contradictoires, vous déléguez. L’optimiseur SQL ci-dessous en est un bon exemple : son prompt ne parle que d’index, de plans d’exécution et de requêtes N+1, ce qui n’aurait aucun sens dans un agent généraliste.

# ~/.vibe/agents/sql-optimizer.toml
display_name = "Optimiseur SQL"
description = "Analyse et optimise les requêtes SQL."
agent_type = "subagent"
safety = "safe"
active_model = "mistral-medium-3.5"  # modèle intégré à Vibe

instructions = """
Analysez les requêtes SQL fournies :
1. Identifiez les problèmes de performance (N+1, scan complet, index manquant)
2. Proposez des requêtes optimisées
3. Suggérez des index à créer
Renvoyez un rapport structuré avec un avant/après pour chaque requête.
"""

enabled_tools = ["read_file", "grep"]

Le troisième avantage, moins évident, est l’isolation de sécurité. Un sous-agent avec safety = "safe" ne peut pas modifier de fichiers, même si l’agent principal s’exécute en mode destructive : les permissions ne se transmettent pas vers le bas. Vous pouvez donc travailler en mode permissif tout en confiant des analyses à des sous-agents restreints qui n’ont aucun moyen d’agir sur le dépôt.

# Sous-agent qui peut UNIQUEMENT lire
agent_type = "subagent"
safety = "safe"
enabled_tools = ["read_file", "grep"]

[tools.read_file]
permission = "always"

[tools.grep]
permission = "always"

Vibe fournit également un sous-agent intégré nommé explore, qu’il utilise automatiquement lorsqu’il doit parcourir votre base de code pour répondre à une question. Il fonctionne en lecture seule et renvoie un résumé de ses découvertes — exactement le modèle que vous reproduisez avec vos propres sous-agents.

Concevoir un bon sous-agent

Tout repose sur l’autonomie de l’instruction système : elle doit contenir toutes les instructions nécessaires pour que le sous-agent aille au bout sans jamais poser de question. Cela implique d’anticiper les cas où les choses tournent mal et d’écrire exactement ce que l’agent doit faire dans ces situations, comme dans l’exemple suivant.

instructions = """
Analysez TOUS les fichiers TypeScript du projet.
Si un fichier est introuvable, passez au suivant.
Si le framework de test n'est pas identifiable, utilisez Vitest par défaut.
Renvoyez toujours un résultat, même partiel.
"""

Deux réflexes complètent ce travail. Donnez au sous-agent strictement les outils dont il a besoin — un sous-agent d’analyse n’a pas besoin de write_file — et spécifiez le format de sortie attendu dans l’instruction système. L’agent principal doit pouvoir exploiter le résultat sans ambiguïté : c’est lui, et non vous, qui lira ce texte en premier.

Règles imposées par Vibe

La documentation de Vibe spécifie plusieurs règles qu’il convient de connaître avant de concevoir vos sous-agents :

  • un sous-agent renvoie uniquement du texte à l’agent principal et ne peut pas poser de questions à l’utilisateur ;
  • il ne peut utiliser que les outils intégrés autorisés par son fichier, jamais d’outils MCP, de connecteurs ou de plugins, et jamais avec des permissions plus larges que l’agent parent : ses blocs [tools.<tool>] peuvent le restreindre davantage, mais pas l’étendre ;
  • sa description est obligatoire : elle indique à l’agent quand l’utiliser ; un fichier sans description est signalé plutôt que chargé ;
  • il s’exécute sur son active_model, ou sur le modèle de session si aucun n’est défini ;
  • l’agent principal le lance via la délégation, en utilisant l’outil task ; il n’est pas sélectionné avec --agent ;
  • par défaut, jusqu’à 32 sous-agents peuvent exister et s’exécuter simultanément (max_subagents, max_concurrent_subagents), et enable_subagents = false dans config.toml interdit toute délégation.

Sans sous-agent personnalisé, l’agent peut toujours lancer un sous-agent générique équipé de ses propres instructions et outils.

Belangrijkste punten

  • Un sous-agent est un agent indépendant qui ne peut pas interagir avec l’utilisateur
  • Configurez-le avec agent_type = "subagent" dans le fichier .toml
  • Les sous-agents sont idéaux pour le travail en parallèle et les tâches spécialisées
  • Ils offrent une isolation de sécurité naturelle
  • Les instructions doivent être totalement autonomes : aucune question n’est autorisée
  • Spécifiez toujours un format de sortie clair dans le prompt