Enregistrement et gestion des sous-agents

Aperçu

La page SubAgent (Settings → GWork Settings → SubAgent) sert à pré-enregistrer des sous-agents avec des configurations spécifiques. Les sous-agents pré-enregistrés sont automatiquement injectés dans le prompt système de l'Agent principal, et l'Agent principal leur délègue des tâches (via dispatch_sub_agent) lorsqu'il rencontre une tâche correspondante.

Page SubAgent

Tant que vous n'en avez créé aucun, la page affiche « No sub-agents registered yet » — l'outil dispatch_sub_agent n'est activé pour l'Agent principal qu'une fois qu'au moins un sous-agent existe.

Configuration d'un sous-agent

Cliquez sur + SubAgent pour ouvrir le formulaire Create sub-agent :

Champ	Description	Obligatoire
ID	Identifiant unique, p. ex. `code-reviewer`	Oui
Name	Nom affiché, p. ex. `Code Reviewer`	Oui
Description	Ce que fait le sous-agent. L'Agent principal la lit pour décider quand lui déléguer — restez précis et concis	Oui
System prompt	Chargé lors de la délégation ; constitue l'identité du sous-agent et influe directement sur la qualité de la tâche	Oui
Max turns	Nombre maximal de tours de boucle par délégation. Laissez vide pour utiliser la valeur par défaut de l'application (50)	Non
Can spawn sub-agents	Si ce sous-agent peut créer d'autres sous-agents	Non (activé par défaut)

Cliquez sur Save pour l'enregistrer. Les sous-agents héritent du modèle et des outils de l'Agent principal, sauf indication contraire dans le contexte de la tâche.

Opérations de gestion

Opération	Description
+ SubAgent	Créer un nouveau sous-agent pré-enregistré
Edit	Ouvrir un sous-agent existant et modifier sa configuration
Delete	Supprimer un sous-agent pré-enregistré

Interaction avec les conversations

Injection dans le prompt système : le Name et la Description de chaque sous-agent sont listés dans le prompt système de l'Agent principal
Correspondance automatique : l'Agent principal sélectionne le sous-agent approprié selon la sémantique de la tâche
Invocation manuelle : vous pouvez nommer un sous-agent dans votre message pour le solliciter explicitement

Les exécutions de sous-agents sont limitées par Max turns ici et par le Sub-agent timeout (minutes) dans Settings → Task Control (30 minutes par défaut ; le travail accompli est conservé lorsqu'un sous-agent est annulé).

Exemples de cas d'usage

Sous-agent	Description	Outils typiques
Code Reviewer	Examine le code pour la justesse, les performances et la sécurité	Read file, Search in files, Find files
Document Writer	Rédige et met en forme des documents	Write file, compétences docx / pptx
Research Assistant	Recherche et collecte des informations	Browser, compétence web-search
Data Analyst	Traite et analyse des données	Run command, Read file, Write file

Guide : créer un sous-agent pré-enregistré

Ouvrez App → ⚙ Settings → SubAgent
Cliquez sur + SubAgent
Renseignez :
- ID : code-reviewer
- Name : Code Reviewer
- Description : « Examine le code pour la justesse, les performances et la sécurité. Compétent en analyse de code multi-langages. »
- System prompt : « Vous êtes un relecteur de code senior. Analysez le code pour la justesse, les performances, la sécurité et la maintenabilité. Pour chaque problème, indiquez une sévérité (faible / moyenne / élevée) et une suggestion de correction. »
(Optionnel) définissez Max turns (p. ex. 30) et désactivez Can spawn sub-agents si une délégation supplémentaire n'est pas nécessaire
Cliquez sur Save

Impact concret de la profondeur de délégation

Paramètre	Signification	Impact sur le coût
Can spawn sub-agents : désactivé	Le sous-agent ne peut pas créer de sous-agents de niveau inférieur	Faible
Can spawn sub-agents : activé	Le sous-agent peut déléguer à son tour	Plus élevé — chaque niveau exécute sa propre boucle d'Agent et consomme ses propres tokens / crédits

Remarque : chaque niveau de sous-agent démarre une boucle d'Agent indépendante (50 tours par défaut). Une délégation profonde peut multiplier le coût d'une seule tâche ; laissez la délégation désactivée pour les rôles spécialisés simples.

Pré-enregistrement ou création automatique : comment choisir ?

Comparaison	Pré-enregistrement (`dispatch_sub_agent`)	Création automatique (`create_local_sub_agent`)
Configuration	Configuré à l'avance, une fois pour toutes	Créé temporairement par l'Agent à la demande, à chaque fois
Cohérence	Utilise la même configuration à chaque fois, avec des résultats stables	L'Agent peut attribuer des identités et des outils différents à chaque fois
Scénarios adaptés	Rôles professionnels utilisés fréquemment et de manière répétée	Décomposition ponctuelle de tâches temporaires
Prompt système	Automatiquement injecté dans l'Agent principal, qui sait donc qu'il peut l'utiliser	L'Agent décide lui-même d'en créer un ou non

Recommandation : si vous avez fréquemment besoin d'un certain type de tâche (revue de code, rédaction de documents ou analyse de données), créez un sous-agent pré-enregistré. Pour une décomposition occasionnelle de tâches temporaires, laissez simplement l'Agent en créer un automatiquement.

Documentation associée

Système de sous-agents — Utiliser les sous-agents dans les conversations
Gestion des outils — Outils disponibles pour les sous-agents
Moteur de boucle d'Agent — La boucle d'Agent utilisée par les sous-agents