Créer des équipes d'agents dirigées par un superviseur avec Select AI

Créez une équipe d'agents Select AI dirigée par un superviseur qui achemine les demandes en plusieurs étapes vers des agents de travail spécialisés et renvoie une réponse coordonnée.

Un agent de superviseur Select AI est l'objet Select AI agent qui contrôle une équipe d'agents dirigée par un superviseur lors de l'exécution. L'objet agent superviseur reçoit l'invite utilisateur, sélectionne la paire agent-tâche de processus actif qui doit gérer chaque sous-tâche, transmet le contexte requis, attend le résultat de ce processus actif et continue de sélectionner la paire agent-tâche suivante jusqu'à ce qu'il puisse renvoyer une réponse finale.

L'image suivante illustre le modèle d'agent de superviseur Select AI. Description de select-ai-supervisor-agent-pattern.png

Quand utiliser un agent superviseur

Utilisez le modèle de superviseur lorsque l'équipe doit déterminer les salariés appropriés ou exécuter l'ordre au moment de l'exécution. Une équipe dirigée par un superviseur peut vous aider lorsqu'une demande nécessite des salariés différents, dans des ordres différents, en fonction de l'intention de l'utilisateur et des résultats intermédiaires. Le superviseur décide quelle paire agent-tâche de salarié appeler ensuite, passe une sous-tâche autonome, attend le résultat et continue jusqu'à ce qu'il puisse produire une réponse finale coordonnée.

Un agent de supervision convient pour :

Workflows couvrant des domaines professionnels ou techniques distincts.
Demandes nécessitant des agents, des outils ou des sources de données différents.
Equipes d'agents qui ont besoin d'un point d'entrée unique pour le routage et la coordination des demandes.
Workflows dans lesquels le superviseur doit gérer la séquence d'interaction et consolider les réponses de sous-agent.

A propos de Select AI Supervisor Agent Teams

Comprenez comment une équipe d'agents de superviseur Select AI coordonne les agents des salariés, contrôle le routage des tâches, préserve le contexte et renvoie une réponse finale.

Une équipe d'agent superviseur est un modèle d'orchestration pour une équipe d'agent Select AI. Dans cette équipe, un objet d'agent Select AI est identifié en tant que superviseur en définissant son attribut supervisor sur true et les noms d'équipe de cet objet dans l'attribut supervisor_agent. Les agents du salarié conservent des responsabilités ciblées, telles que la recherche de compte, l'extraction des paiements, la génération de rapports ou la transmission de notifications. L'objet agent superviseur détermine le salarié à appeler, prépare une demande autonome pour ce salarié et ajoute le résultat du salarié dans le contexte du superviseur.

Le traitement des sous-tâches est séquentiel : une sous-tâche de salarié doit se terminer avant que le superviseur délègue la sous-tâche suivante. Le superviseur attend le résultat du salarié, ajoute le résultat au contexte du superviseur, puis décide s'il doit appeler un autre salarié, demander des informations supplémentaires, expliquer l'échec d'un salarié ou renvoyer la réponse finale. Les agents de salariés utilisent des threads de conversation distincts, de sorte que le superviseur doit inclure suffisamment de contexte dans chaque demande déléguée.

La fonctionnalité ajoute des attributs liés au superviseur aux API DBMS_CLOUD_AI_AGENT existantes. Utilisez l'attribut d'agent supervisor pour marquer un objet d'agent Select AI comme superviseur. Utilisez l'attribut d'équipe supervisor_agent pour nommer cet objet d'agent superviseur pour une équipe. Une équipe supervisée contient un objet agent superviseur et une ou plusieurs paires agent-tâche de salarié. L'attribut d'équipe agents répertorie les paires agent-tâche de processus actif disponibles pour la délégation. Chaque tâche de salarié peut utiliser ses outils configurés. L'objet agent superviseur délègue aux paires agent-tâche de processus actif. L'outil de délégation géré par Oracle n'est pas configurable par l'utilisateur.

Reportez-vous à Exemple : création et exécution d'une équipe de superviseur du support client pour obtenir un exemple complet d'utilisation d'un agent de superviseur.

Sélectionner l'architecture de l'agent du superviseur AI

Une équipe d'agent Select AI supervisée s'exécute en tant qu'équipe unique avec un objet d'agent superviseur et une ou plusieurs paires agent-tâche de salarié. La définition de l'équipe nomme l'objet agent superviseur dans supervisor_agent. La liste des salariés nomme les paires agent-tâche auxquelles le superviseur peut déléguer. Les outils sont configurés sur les tâches des salariés et non sur l'équipe.

Dans une équipe dirigée par un superviseur, le processus est toujours défini sur séquentiel, mais l'ordre des salariés configuré n'est pas le plan de workflow. Le superviseur sélectionne dynamiquement une paire agent-tâche de salarié à la fois, attend le résultat, puis décide si un autre salarié est nécessaire.

L'objet agent superviseur utilise un outil de délégation géré par Oracle en interne pour déléguer à une paire agent-tâche de processus actif. L'outil de délégation fait partie du modèle d'exécution du superviseur et n'est pas répertorié comme attribut d'équipe configurable par l'utilisateur.

Le superviseur est propriétaire de la demande globale et s'exécute dans son propre fil de conversation. Chaque agent de processus actif s'exécute dans un thread de conversation distinct. Un salarié n'hérite pas du contexte de superviseur complet. Le superviseur doit créer une demande de sous-tâche autonome pour chaque salarié. Le salarié ne renvoie que son résultat final au superviseur. Le superviseur ajoute le résultat renvoyé à son propre contexte et décide de l'action suivante.

La description de l'image suit

Phase	Entrée	Traitement	Sortie
Soumission de demande	Demande utilisateur en langage naturel soumise à l'équipe	L'équipe supervisée active d'abord l'agent superviseur.	Le thread de conversation du superviseur démarre pour la demande.
Boucle de raisonnement du superviseur	Demande utilisateur et contexte du superviseur actuel	Le superviseur décide s'il dispose de suffisamment d'informations pour répondre ou s'il doit déléguer une sous-tâche.	Réponse finale ou une demande de salarié déléguée.
Délégation de tâche	Paire agent-tâche de salarié sélectionnée et contexte de sous-tâche autonome	Le superviseur appelle l'outil de délégation géré par Oracle pour la paire agent-tâche de processus actif sélectionnée et attend.	La tâche du salarié démarre dans son propre fil de conversation.
Traitement des tâches	Configuration des tâches de sous-tâche déléguée et de salarié	Le salarié utilise les outils configurés sur sa tâche. S'il a besoin d'une entrée utilisateur, l'équipe attend la réponse de l'utilisateur.	Résultat du salarié, résultat de l'échec du salarié ou demande d'entrée humaine.
Suite du superviseur	Résultat du salarié renvoyé, résultat d'échec ou réponse utilisateur	Le superviseur ajoute le résultat renvoyé à son contexte et poursuit le raisonnement. L'échec suit le même chemin de retour que la réussite ; le superviseur décide de réessayer, d'appeler un autre salarié, de demander plus d'informations, d'expliquer l'échec ou de renvoyer la réponse finale.

Comportement d'exécution dans les équipes dirigées par un superviseur

Découvrez comment les équipes dirigées par un superviseur s'interrompent pour les entrées utilisateur, gèrent les échecs des salariés et transmettent un contexte autonome entre les conversations entre les superviseurs et les salariés.

Gestion des entrées humaines

Lorsqu'un salarié demande une intervention humaine, l'ensemble de l'équipe dirigée par le superviseur s'interrompt en attendant la réponse de l'utilisateur. L'utilisateur continue dans la même conversation pour fournir les informations demandées.

Une fois que l'utilisateur a répondu, le salarié reprend, termine la tâche et renvoie le résultat au superviseur. Le superviseur décide ensuite s'il doit déléguer une autre sous-tâche ou renvoyer la réponse finale.

Gestion des échecs

Les échecs de processus actif suivent le même chemin de retour que les résultats obtenus. Le superviseur reçoit le résultat de l'échec et décide de l'action suivante, telle que relancer la tâche, appeler une autre paire agent-tâche, demander une entrée supplémentaire ou renvoyer une réponse finale.

Modèle de transmission de contexte

Chaque salarié opère dans son propre fil de conversation et n'hérite pas du contexte de superviseur complet. Le superviseur doit fournir une demande de sous-tâche autonome qui inclut toutes les informations requises pour que le salarié puisse terminer la tâche.

Cas d'utilisation pour l'agent superviseur

Appliquez des équipes Select AI dirigées par un superviseur lorsqu'une demande peut nécessiter plusieurs agents spécialisés, un routage conditionnel ou une réponse intermédiaire.

Répondez à une demande d'assistance client nécessitant des détails de compte, un historique des paiements et une réponse combinée finale.
Acheminer une invite d'analyse de données vers le salarié approprié en fonction de la source de données, puis combiner les résultats du salarié en une seule réponse.
Demandez à un salarié de se mettre en pause pour une confirmation humaine avant d'envoyer une notification ou d'effectuer une business action.
Utilisez une équipe de superviseur pour les demandes qui nécessitent parfois un salarié et plusieurs salariés dans l'ordre.
Suivre les transferts de responsabilité des salariés et les résultats renvoyés pour l'audit, les tests et le dépannage.

Avantages

Utilisez les équipes dirigées par un superviseur pour acheminer les demandes en plusieurs étapes, concentrer les agents des collaborateurs et enregistrer les chemins de délégation pour l'activité de structure d'agent Select AI.

Acheminement dynamique des tâches : le superviseur sélectionne le salarié suivant en fonction de la demande en cours et du contexte renvoyé.
Conception de processus actif ciblée : chaque processus actif gère une zone de tâche limitée, ce qui facilite la gestion des invites et des mises en correspondance d'outils.
Contrôle de contexte : le superviseur transmet uniquement le contexte nécessaire pour chaque sous-tâche de salarié.
Traçabilité : les vues d'historique d'équipe et de tâche peuvent afficher le chemin de délégation et les résultats de salarié renvoyés.
Croissance incrémentielle de l'équipe : ajoutez de nouveaux agents de salariés pour de nouvelles tâches sans repenser chaque salarié existant.

Comment utiliser Select AI Supervisor Agent Teams

Créez l'agent pour qu'il serve de superviseur et le désigne comme superviseur, créez des agents de salarié, ajoutez le superviseur aux attributs de l'équipe et exécutez des invites utilisateur pour l'équipe.

Accordez les privilèges requis. L'utilisateur de base de données doit disposer du privilège EXECUTE sur DBMS_CLOUD_AI_AGENT, avoir accès aux informations d'identification requises et aux listes de contrôle d'accès réseau requises pour les appels de fournisseur externe. Pour plus d'informations, reportez-vous à Prérequis pour l'utilisation de Select AI Agent.
Créez les outils utilisés par les agents actifs, tels que les fonctions PL/SQL pour les tâches de recherche, de mise à jour, de notification ou de reporting. Pour plus d'informations, reportez-vous à Package DBMS_CLOUD_AI_AGENT et à Exemples d'utilisation de Select AI Agent.
Créer des agents et des tâches de salarié. Conservez chaque rôle de salarié spécifique afin que le superviseur puisse sélectionner le salarié approprié pour chaque sous-tâche. Reportez-vous à Procédure CREATE_TASK et à Procédure CREATE_AGENT.
Créez un agent superviseur avec l'attribut supervisor défini sur true. Reportez-vous à la section CREATE_AGENT Attributes.
Créez l'équipe avec supervisor_agent défini sur le nom de l'agent superviseur et agents défini sur les paires agent-tâche de processus actif. Reportez-vous à Procédure CREATE_TEAM.
Définissez l'équipe de la session et soumettez des invites de langage naturel avec la structure Select AI Agent. Reportez-vous à SET_TEAM Function.
Consultez les vues d'historique pour confirmer le routage des salariés, les résultats renvoyés, les échecs des salariés et les états d'attente d'entrée humaine. Si une tâche de salarié demande une entrée humaine, l'équipe s'interrompt jusqu'à ce que l'utilisateur réponde. Toute l'équipe dirigée par le superviseur s'arrête pendant cette période. Continuez la même conversation pour fournir l'entrée demandée. Une fois que l'utilisateur a répondu, le salarié reprend, termine la tâche et renvoie le résultat au superviseur. Le superviseur décide ensuite de l'action suivante. Reportez-vous à la section DBMS_CLOUD_AI_AGENT Views.

N'incluez pas le superviseur sélectionné dans le tableau du processus actif agents. Le superviseur contrôle l'équipe, tandis que la table externe répertorie uniquement les paires agent-tâche de salarié disponibles pour la délégation. Une tâche de salarié peut utiliser ses propres outils configurés ; l'attribut d'équipe ne répertorie pas les noms des outils.

Remarque : les équipes dirigées par un superviseur traitent les sous-tâches de salarié de manière séquentielle. Le superviseur attend le résultat de chaque salarié avant de déléguer une autre sous-tâche. L'exécution parallèle des processus actifs ne fait pas partie de cette version.

Configurations d'équipe d'agent superviseur autorisées

Passez en revue les configurations prises en charge et les conseils pour définir les superviseurs, les paires agent-tâche de salarié, les outils et le traitement dans une équipe d'agents Select AI.

Configuration	Autorisé ?	Conseils
`supervisor_agent` nomme un agent créé avec `supervisor` défini sur `true`.	Oui	Utilisez ce modèle pour les équipes supervisées.
Le superviseur sélectionné est également répertorié dans le tableau `agents` du processus actif.	Non	Un agent désigné comme superviseur ne peut pas être inclus dans la table externe des salariés. La validation de conception rejette les agents activés par le superviseur dans le tableau `agents`.
Le même agent de processus actif est affecté à plusieurs tâches	Oui	Le même agent peut effectuer plusieurs tâches en affectant le même agent à différents noms de tâche.
Les outils sont répertoriés dans le tableau team `agents`	Non	Définissez des outils sur les tâches à l'aide de `CREATE_TASK`. L'attribut team répertorie les paires agent-tâche de salarié, et non les noms d'outil.
`supervisor_agent` nomme un agent qui n'a pas `"supervisor": true`.	Non	Sélectionnez un agent avec `supervisor` défini sur `true`. Si l'agent nommé n'est pas un superviseur, la création ou la validation de l'équipe échoue ; vérifiez les détails de l'erreur de base de données renvoyée.
Plusieurs superviseurs sont définis pour une équipe	Non	Une équipe supporte exactement un superviseur. Définissez un agent unique avec `"supervisor": true` et référencez-le dans `supervisor_agent`.
Un superviseur délègue à une autre équipe dirigée par un superviseur	Non	La délégation du superviseur au superviseur n'est pas prise en charge dans cette version. Un superviseur ne peut déléguer qu'aux agents du même groupe.
Un agent désigné comme superviseur dans une équipe peut être utilisé comme salarié dans une autre équipe	Oui	Vous pouvez réutiliser le même agent superviseur dans plusieurs équipes avec des rôles différents (superviseur ou salarié). Définissez le rôle via la configuration de l'équipe.

Remarque :

La structure n'impose pas un nombre maximal de tours de conversation. Pour une exécution de tâche, la structure limite les tentatives pour les appels d'outil ayant échoué à 10 tentatives par tâche.
Le cadre n'introduit pas de nouvelles vues pour la surveillance. Vous pouvez consulter l'historique d'exécution des équipes, des tâches et des outils à l'aide des vues d'historique de structure Select AI Agent existantes. Pour plus d'informations, reportez-vous à la section DBMS_CLOUD_AI_AGENT History Views.

Dépannage des équipes dirigées par un superviseur

Identifiez les causes et les correctifs probables des problèmes courants de configuration, de délégation, de contexte, de notification et d'entrée humaine de l'équipe dirigée par le superviseur Select AI.

Echec de la création de l'équipe

Problème : la création de l'équipe échoue.

Cause probable : supervisor_agent ne nomme pas un agent avec "supervisor": true.

Corriger : recréez l'agent avec l'attribut superviseur, puis recréez l'équipe.

Le superviseur appelle le mauvais travailleur

Problème : le superviseur appelle le mauvais salarié.

Cause probable : les descriptions des tâches du salarié sont trop vagues ou se chevauchent.

Correction : rendez les instructions de tâche plus spécifiques et mutuellement exclusives. Le superviseur sélectionne les paires agent-tâche de salarié en fonction des noms d'agent, des noms de tâche, des descriptions et des instructions de tâche.

Utilisez les consignes suivantes lorsque vous définissez des tâches de salarié :

Définissez une limite de domaine claire pour chaque salarié.
Utilisez des noms de tâche spécifiques tels que ACCOUNT_MANAGEMENT_TASK ou PAYMENT_LOOKUP_TASK.
Evitez les chevauchements d'instructions entre les salariés.
Incluez les paramètres d'entrée attendus dans l'instruction de tâche.
Indiquez à quel moment le salarié doit demander une entrée humaine.
Définissez le format du résultat renvoyé au superviseur.

Contexte d'absence de salarié

Problème : un salarié n'a pas de contexte.

Cause probable : le superviseur n'a pas réussi suffisamment de détails dans la sous-tâche déléguée.

Correction : ajoutez des instructions indiquant au superviseur d'envoyer des sous-tâches autonomes. Définir un rôle de superviseur clair pour guider le comportement des délégations.

Par exemple :

{
  "profile_name": "<AI_PROFILE_NAME>",
  "supervisor": true,
  "role": "You orchestrate requests. Choose the appropriate worker agent-task pair for each subtask. Send self-contained requests with all required context. Return one concise final answer."
}

Le courriel n'est pas envoyé

Problème : le courriel n'est pas envoyé.

Cause probable : la configuration des informations d'identification, de l'ACL réseau, de l'expéditeur ou du destinataire est manquante ou incorrecte.

Correction : vérifiez les paramètres d'informations d'identification SMTP, d'ACL, d'expéditeur et de destinataire.

L'invite attend la saisie de l'utilisateur

Problème : l'invite attend la saisie par l'utilisateur.

Cause probable : un superviseur ou un salarié a demandé une confirmation humaine.

Correction : poursuivez la même conversation avec les informations demandées.

Comparer les modèles séquentiels de workflow et de superviseur

Sélectionnez le modèle d'équipe-agent Select AI approprié en fonction de la façon dont l'équipe doit sélectionner les salariés et coordonner les tâches.

Sélectionnez le modèle de workflow séquentiel lorsque l'équipe doit exécuter les paires agent-tâche configurées dans un ordre connu. Sélectionnez le modèle de responsable lorsque l'équipe doit sélectionner les salariés à l'exécution en fonction de la demande, des résultats intermédiaires, des échecs ou des demandes d'informations supplémentaires.

Caractéristique	Modèle de workflow séquentiel	Modèle de superviseur
Exécuter le plan	Corrigé. Le tableau `agents` définit l'ordre du workflow.	Variable. Le superviseur sélectionne le salarié suivant lors de l'exécution.
Point d'entrée	Première paire agent-tâche configurée.	Agent superviseur.
Sélection de tâche	L'équipe exécute les paires agent-tâche configurées dans l'ordre.	Le superviseur appelle un ou plusieurs salariés selon les besoins.
Transmission de contexte	Les dépendances de tâche transmettent la sortie de tâche précédente aux tâches en aval.	Le superviseur envoie à chaque salarié une sous-tâche autonome.
Idéal pour	Pipelines prévisibles avec étapes connues.	Demandes de variable nécessitant un routage ou une coordination conditionnels.
Exécutions parallèles	Non prise en charge. Les tâches sont exécutées une par une.	Non prise en charge. Les sous-tâches de salarié s'exécutent une par une.

Le tableau suivant présente les différences entre le modèle séquentiel et le modèle de superviseur qui peuvent vous aider à décider de votre workflow.

Modèle séquentiel	Modèle de superviseur
Workflow fixe	Orchestration dynamique
Chaque étape est exécutée dans l'ordre	Seules les étapes nécessaires sont exécutées
Bon pour les pipelines linéaires	Idéal pour les demandes d'entreprise de branchement
Moins de logique décisionnelle	Moins de logique de routage manuel, plus de jugement d'exécution