Attacher / créer des sous-agent

Overview

Les sous-agents vous permettent de créer une architecture multi-agent en connectant des agents spécialisés à un agent parent orchestrateur. Au lieu de confier l'intégralité des tâches à un seul agent généraliste, l'agent parent délègue des missions précises à des sous-agents configurés pour des rôles dédiés.

Cette structure optimise les opérations complexes en établissant un système visuel et modulaire où les agents s'exécutent de manière autonome ou en parallèle. Chaque sous-agent agit comme un outil intelligent que l'agent parent appelle automatiquement en fonction de critères définis.

Quand utiliser les sous-agents

Utilisez les sous-agents lorsque les tâches requièrent des instructions spécialisées, des bases de connaissances distinctes ou des outils indépendants qui surchargeraient un prompt unique.

• Projets complexes à étapes multiples : Répartissez la recherche, la rédaction, l'analyse de données et la mise en page entre plusieurs spécialistes plutôt qu'un seul agent généraliste.

• Traitement en parallèle : Exécutez plusieurs requêtes ou sous-tâches simultanément pour réduire le temps de réponse lors de flux de travail lourds.

• Réutilisabilité modulaire : Créez des agents spécialisés (recherche web, génération d'images, tri d'e-mails) une seule fois et rattachez-les à différents agents parents.

• Ségrégation stricte des domaines : Maintenez des frontières opérationnelles et des permissions claires entre différentes bases de données internes et outils.

Note : Les sous-agents ne peuvent pas être mentionnés avec @ dans le chat. Ils sont déclenchés automatiquement par l'agent parent dès que le contexte de la demande correspond aux critères d'invocation configurés.

Prérequis

• Accès à la section Agents dans Swiftask

• Un agent existant servant d'orchestrateur (agent parent)

• Autorisations requises pour afficher et utiliser les agents cibles à attacher

• Droits de configuration des agents dans l'espace de travail

Guide étape par étape

Accéder à la section Sous-agents

1. Rendez-vous dans la section Agents du menu latéral gauche et cliquez sur l'icône de configuration de votre agent parent.

2. Dans le menu de configuration sous Agent Instruction, sélectionnez Sub agents.

1. Le canevas interactif s'ouvre, affichant votre agent racine et les boutons de gestion dans l'en-tête.

Attacher un agent existant en tant que sous-agent

1. Cliquez sur le bouton + Attach sub agent en haut à droite.

1. Renseignez les champs suivants dans la fenêtre modale :

   • Keep sub agent discussion in the same session :

     • Activé : Le sous-agent conserve et mémorise l'historique de discussion au fil des requêtes.

     • Désactivé : Chaque requête est traitée comme une conversation entièrement nouvelle.(Note : Cette fonctionnalité de session partagée fera l'objet d'une documentation détaillée dédiée).

   • Name : Saisissez un nom de compétence explicite pour le sous-agent (ex. Internet web search pro).

   • When to use this sub agent : Définissez des critères d'invocation clairs précisant dans quelles conditions l'agent parent doit déléguer la tâche à ce sous-agent (ex. use this agent to do advanced web search).

2. Cliquez sur le champ Target agent pour rechercher et sélectionner un agent existant dans votre espace de travail ou parmi les modèles disponibles.

3. Cliquez sur Attach sub agent pour valider. Le sous-agent apparaît immédiatement relié au nœud parent sur le canevas visuel.

Créer un nouveau sous-agent

1. Cliquez sur le bouton + Create sub agent dans l'en-tête supérieur.

2. Swiftask vous redirige dans une nouvelle fenêtre vers l'interface standard de création et configuration d'agent.

3. Configurez les instructions, le modèle LLM, les compétences et les sources de connaissances de votre nouvel agent, puis enregistrez.

4. Une fois créé, l'agent est automatiquement rattaché et intégré à l'arborescence visuelle de votre agent parent en tant que sous-agent.

Naviguer dans l'arbre hiérarchique et les sous-agents imbriqués

Le canevas des sous-agents offre une vue graphique montrant les liens hiérarchiques et les chaînes d'agents imbriquées.

1. Utilisez les commandes de navigation en bas à gauche (+, -, plein écran) ou cliquez et glissez pour explorer le canevas.

2. Si un agent rattaché possède déjà ses propres sous-agents, Swiftask déploie et affiche automatiquement l'arborescence complète à plusieurs niveaux.

3. Vous pouvez connecter plusieurs sous-agents afin de créer des branches de traitement parallèles sous un même orchestrateur.

Gérer les sous-agents dans l'onglet Compétences

1. Dans le menu de configuration de l'agent à gauche, cliquez sur Skills.

2. Les sous-agents rattachés apparaissent dans la liste Active skills avec un badge de délégation.

3. Cliquez sur l'icône œil pour consulter les détails du sous-agent ou sur l'icône corbeille pour détacher le sous-agent de l'agent parent.

Suivre l'exécution en parallèle via le volet latéral en direct

1. Ouvrez le Chat et soumettez une demande à votre agent parent nécessitant la réalisation de plusieurs sous-tâches.

2. Lorsque plusieurs sous-agents s'exécutent en parallèle, leur progression s'affiche sous le cheminement de pensée avec un indicateur d'état actif.

3. Survolez la carte d'un sous-agent actif pour faire apparaître la mention Watch this agent work, puis cliquez dessus.

1. Un volet latéral dédié intitulé Agent conversation s'ouvre à droite, affichant en temps réel le raisonnement interne, les appels d'outils et les résultats du sous-agent.

Cas d'utilisation pratiques

Synthèse d'étude de marché : Un agent directeur reçoit une demande d'analyse stratégique complexe, délègue simultanément 3 axes d'investigation à un sous-agent Perplexity Deep Search, puis synthétise les résultats en un rapport exécutif consolidé.

Chaîne de production de contenu : Un agent éditorial pilote la rédaction en sollicitant un sous-agent spécialisé en copywriting, commande des visuels à un sous-agent de génération d'images, puis transmet le tout à un sous-agent de relecture.

Aiguillage du support client : Un agent de tri analyse l'intention d'un ticket utilisateur et l'oriente vers des sous-agents dédiés à la facturation, à la résolution technique ou à la gestion de compte.

Conseils et bonnes pratiques

• Critères d'invocation précis : Définissez des instructions claires et ciblées dans le champ « When to use this sub agent » afin que le parent sache exactement quand déléguer.

• Responsabilité unique : Attribuez une mission spécifique à chaque sous-agent pour maximiser la précision et maîtriser la consommation de tokens.

• Inspection des flux d'exécution : Consultez le volet latéral en temps réel pendant vos tests pour valider la transmission du contexte et la qualité des résultats intermédiaires.

• Éviter les dépendances circulaires : Veillez à ce que vos arborescences d'agents restent linéaires ou hiérarchiques et sans boucles pour préserver la réactivité.

Dépannage

Le sous-agent n'est jamais sollicité par l'agent parentCause : Les critères d'invocation sont trop vagues ou entrent en contradiction avec le prompt de l'agent parent.Solution : Modifiez le champ « When to use this sub agent » en indiquant des mots-clés de déclenchement explicites et des cas d'usage concrets.

Impossible de mentionner un sous-agent avec @ dans le chatCause : Les sous-agents sont configurés comme des compétences internes déléguées à l'agent parent et ne peuvent pas être interpellés directement dans la même conversation.Solution : Laissez l'agent parent déléguer la requête automatiquement, ou conversez directement avec le sous-agent en le choisissant dans le sélecteur d'agents.

Le sous-agent n'exécute pas les compétences requisesCause : Permissions manquantes, connecteurs non authentifiés ou base de connaissances non indexée au niveau de l'agent enfant.Solution : Ouvrez directement la configuration du sous-agent pour vérifier que ses outils et sources de données sont correctement paramétrés.

Ressources additionnelles

• Agent configuration guide

• Skills overview

• Lock agent