Création de sous-agents (SpawnAgentTool)

Présentation

Le SpawnAgentTool permet à l'agent principal de créer des sous-agents temporaires pour exécuter des tâches spécialisées. Chaque sous-agent reçoit un prompt, travaille de manière autonome avec ses propres outils, puis renvoie un rapport structuré accompagné de métriques (durée, jetons consommés).

Ce mécanisme suit le principe « Prompt entrant, Rapport sortant » : le sous-agent ne partage ni mémoire, ni contexte, ni état avec l'agent principal. Il constitue une unité d'exécution indépendante.

Présentation

Le SpawnAgentTool permet à l'agent principal de créer des sous-agents temporaires pour exécuter des tâches spécialisées de manière autonome.

Créer

L'agent principal fournit un nom et un prompt complet

Exécuter

Le sous-agent travaille en autonomie avec ses outils

Rapporter

Rapport Markdown structuré avec métriques de jetons

Principe « Prompt entrant, Rapport sortant » : le sous-agent ne partage ni mémoire, ni contexte, ni état avec l'agent principal. Le prompt est sa seule entrée, le rapport sa seule sortie.

Opérations disponibles

Trois opérations pour gérer le cycle de vie des sous-agents.

spawn Créer un sous-agent

Crée et exécute un sous-agent temporaire. L'opération est bloquante : l'agent principal attend le rapport avant de continuer.

name obligatoire
Nom du sous-agent
prompt obligatoire
Prompt complet — seule entrée du sous-agent
tools optionnel
Outils autorisés (défaut : ceux du parent sans délégation)
provider / model optionnel
Fournisseur et modèle LLM — résolution des capacités depuis la base de données
mcp_servers optionnel
Serveurs MCP accessibles
system_prompt optionnel
Prompt système personnalisé (remplace le prompt par défaut)
Outils disponibles par défaut
MemoryTool TodoTool CalculatorTool UserQuestionTool FileManagerTool ReadSkillTool
list_children Lister les sous-agents

Affiche tous les sous-agents (en cours et terminés) avec leur statut et le nombre de créneaux restants.

terminate Arrêter un sous-agent

Force l'arrêt d'un sous-agent en cours via son identifiant (child_id). Le statut passe à « annulé ».

Cycle de vie du sous-agent

Chaque sous-agent passe par l'un des cinq statuts suivants au cours de son exécution.

En attente pending

Créé, en attente de validation

En cours running

Exécution active

Terminé completed

Rapport disponible

Erreur error

Échec d'exécution

Annulé cancelled

Arrêté par le parent ou délai dépassé

Validation interactive

Avant chaque création de sous-agent, le système peut demander l'approbation de l'utilisateur.

Quand ?

Selon le mode de validation configuré : automatique, manuel ou sélectif. La création est classée en risque moyen.

Que voit l'utilisateur ?

Nom du sous-agent, aperçu du prompt (200 premiers caractères), liste des outils et serveurs MCP demandés.

Délai de réponse

60 secondes maximum. Vérification toutes les 500 millisecondes. Passé ce délai, la création est annulée.

Contraintes et limites

Règles d'utilisation imposées par le système multi-agents.

Hiérarchie à un niveau

Les sous-agents ne peuvent pas créer d'autres sous-agents. Seul l'agent principal a accès aux outils de délégation.

Maximum 15 sous-agents

Un flux de travail peut contenir au plus 15 sous-agents au total (actifs et terminés confondus).

Isolation complète

Aucun partage de mémoire, contexte ou état. Le sous-agent ne connaît que son prompt.

Paramètre
Valeur
Sous-agents par flux de travail
15 maximum
Délai d'inactivité
300 secondes (5 minutes)
Tentatives en cas d'échec
3 (intervalle exponentiel : 500 ms → 1 s → 2 s)
Taille maximale du rapport
5 000 caractères (tronqué au-delà)
Disjoncteur
3 échecs → ouverture, 60 s de repos
Le prompt doit être complet et autonome. Le sous-agent n'a accès ni à l'historique de conversation ni aux messages précédents. Incluez toutes les informations nécessaires directement dans le prompt.

Résultat et affichage

Le sous-agent retourne un rapport structuré accompagné de métriques de performance.

Rapport Markdown

Document structuré contenant les résultats, observations et recommandations du sous-agent. Tronqué à 5 000 caractères si nécessaire.

Métriques

Durée d'exécution en millisecondes, jetons en entrée et en sortie, identifiant du sous-agent.

Affichage dans la conversation
Config Analyst 3.2s
Rapport d'analyse de configuration — 4 fichiers analysés, 2 problèmes détectés...
Cliquez sur l'en-tête pour voir le rapport complet et les métriques

Cas d'utilisation

Analyse de code

Examiner un ensemble de fichiers source pour détecter des problèmes ou des vulnérabilités.

Recherche documentaire

Déléguer la lecture et la synthèse de documents volumineux à un sous-agent spécialisé.

Validation croisée

Vérifier les résultats d'une première analyse en les soumettant à un sous-agent indépendant.

Tâche sur fichiers

Confier une opération isolée (lecture, audit) sans exposer le contexte complet.

Comparaison avec les autres outils

Zileo Chat propose trois outils de délégation complémentaires.

SpawnAgent
DelegateTask
ParallelTasks
Sous-agents créés
1
1
Plusieurs
Exécution
Séquentielle
Séquentielle
Parallèle
Outils personnalisables
Niveau de risque
Moyen
Moyen
Élevé
Cas d'usage
Tâche unique spécialisée
Délégation ciblée
Tâches indépendantes