Directives relatives aux outils d'agent dans les agents d'IA générative

Comprendre les propriétés et les responsabilités d'un agent superviseur et de ses agents collaborateurs.

• L'agent superviseur et un agent collaborateur peuvent appartenir à différentes locations.

• Un agent collaborateur peut être un agent avec n'importe quel type d'outil (comme l'outil RAG) ou une combinaison de types d'outils (comme les outils d'appel RAG et Fonction), à condition que l'agent soit associé à un point d'extrémité d'agent actif.

• L'agent configuré en tant qu'outil Agent peut fonctionner de manière indépendante et être intégré à un agent superviseur.

• Des outils supplémentaires (tels que RAG et SQL) peuvent être inclus dans l'agent superviseur avec les agents collaborateurs.

• L'agent superviseur est responsable des tâches suivantes :

  • Gestion des sessions et routage des interrogations

  • Agréger les réponses des agents ou outils collaborateurs

  • Gestion d'un historique de clavardage global

• Un agent collaborateur est responsable de :

  • Traitement des interrogations pertinentes à sa spécialisation (par exemple, RH)
  • Mise à jour d'un historique de clavardage localisé lié à la session globale.

• Les mesures et la facturation sont traitées séparément pour l'agent superviseur, les agents collaborateurs et les outils.

Un scénario de flux de données possible impliquant des réponses de plusieurs agents collaborateurs peut être décrit comme suit :

1. Un utilisateur envoie une interrogation à l'agent superviseur dans une session de clavardage. L'interrogation couvre plusieurs spécialisations.
2. L'agent superviseur fractionne l'interrogation et délègue les sous-interrogations aux agents collaborateurs concernés en fonction de la logique d'acheminement.
3. Chaque agent collaborateur traite sa sous-interrogation à l'aide de son contexte de session. Les agents collaborateurs renvoient leurs réponses à l'agent superviseur.
4. L'agent superviseur regroupe et formate les réponses dans une sortie consolidée, et envoie la sortie à l'utilisateur.

Le flux des travaux de mise en oeuvre des agents collaborateurs et d'un agent superviseur est le suivant :

1. Comprendre et ajouter les politiques de gestion des identités et des accès (IAM) OCI requises. Voir Politiques IAM.
2. Créez les agents collaborateurs à l'aide de n'importe quel outil. Si vous avez besoin d'aide, voir Création d'un agent.
3. Assurez-vous que chaque agent collaborateur est associé à un point d'extrémité d'agent actif et activé pour la session. Si vous avez besoin d'aide, voir Obtention des détails d'un point d'extrémité.
4. Créez l'agent superviseur. Utilisez le type d'outil Agent pour ajouter les agents collaborateurs. Si vous avez besoin d'aide, voir Création d'un outil d'agent.
5. Assurez-vous que le point d'extrémité de l'agent superviseur est activé pour la session. Si vous avez besoin d'aide, voir Obtention des détails d'un point d'extrémité.

Assurez-vous d'accorder aux utilisateurs l'accès à toutes les ressources des agents d'IA générative, comme décrit sous Ajout de politiques avant de pouvoir utiliser le service.

Consultez également les sections suivantes.

Groupe dynamique et politique

Vous devez ajouter un groupe dynamique autorisé à gérer genai-agent-family.

1. Créer un groupe dynamique et ajouter la règle de correspondance suivante.

   ALL {resource.type='genaiagent'}

   Si vous avez besoin d'aide, voir Création d'un groupe dynamique.

2. Autorisez le groupe dynamique.

   • Écrivez la politique suivante, qui peut être utilisée avec le domaine d'identité par défaut :

     allow dynamic-group <dynamic-group-name> 
     to manage genai-agent-family in tenancy
     

   • Utilisez la politique suivante avec un domaine d'identité non par défaut, en fournissant le nom de domaine Oracle Identity Cloud Service (IDCS) et le nom de groupe dynamique :

     allow dynamic-group '<idcs-domain-name>/<dynamic-group-name>' 
     to manage genai-agent-family in tenancy
     

   Voir À propos des types de ressource des agents d'intelligence artificielle générative pour affecter des autorisations basées sur des types de ressource individuels au lieu du type de ressource agrégé.

Accès interlocation

Pour utiliser un point d'extrémité d'agent provenant d'une autre location, certaines politiques doivent être configurées dans la location cible et dans la location où vous créez l'outil Agent. Collectez les informations suivantes :

• Nom et OCID de la location cible. La location cible est la location qui a le point d'extrémité d'agent actif à utiliser.
• Nom et OCID de la location où vous créez un outil d'agent.
• Nom et OCID du groupe dynamique.

Écrivez les énoncés de politique interlocation suivants. S'il y a lieu, utilisez le formulaire '<idcs-domain-name>/<dynamic-group-name>' dans la syntaxe pour une utilisation dans un domaine d'identité qui n'est pas par défaut.

Dans la location où vous créez un outil Agent :

<target-tenancy> est la location qui contient le point d'extrémité d'agent actif à utiliser.

Define tenancy <target-tenancy> as <target-tenancy-ocid>

Endorse dynamic-group <dynamic-group-name> to manage genai-agent-family in tenancy <target-tenancy>

Dans la location cible :

<this-tenancy> est la location où vous créez un outil d'agent.

Define tenancy <this-tenancy> as <this-tenancy-ocid>

Define dynamic-group <dynamic-group-name> as <dynamic-group-ocid>

Admit dynamic-group <dynamic-group-name> of tenancy <this-tenancy> to manage genai-agent-family in tenancy

Si vous avez besoin d'aide, voir Politiques d'accès interlocation dans la documentation pour OCI IAM avec domaines d'identité.

Un outil Agent ne prend en charge qu'un agent dont le point d'extrémité est activé pour la session.

Lorsque la session est activée sur un point d'extrémité d'agent pour conserver le contexte d'une session de clavardage, les agents d'intelligence artificielle générative créent un ID session et conservent la session d'agent pour la conversation interactive. Pendant la session, le contexte et la continuité sont maintenus pour fournir des réponses cohérentes et significatives tout au long de la conversation.

Pour un agent collaborateur qui doit être configuré dans un agent superviseur, assurez-vous que l'agent n'a qu'un point d'extrémité d'agent basé sur une session. L'agent superviseur doit également être associé uniquement à un point d'extrémité d'agent pour lequel la session est activée.

Par défaut, lorsque vous utilisez la console pour créer un agent et que vous choisissez de créer automatiquement le point d'extrémité de l'agent en même temps, la session est activée sur le point d'extrémité de l'agent créé avec l'agent. Pour vérification, vous pouvez voir les détails du point d'extrémité dans l'agent.

Si vous créez manuellement un point d'extrémité d'agent, assurez-vous que l'option Activer la session est sélectionnée si le point d'extrémité doit être configuré avec un outil d'agent.

Avant de créer un outil Agent, collectez les informations suivantes :

• Nom de l'agent à ajouter en tant qu'outil.
• Nom du point d'extrémité d'agent actif basé sur une session pour cet agent. Créez un point d'extrémité d'agent si l'agent n'a pas de point d'extrémité actif que vous pouvez utiliser. Si vous avez besoin d'aide, voir Création d'un point d'extrémité.
• Si le point d'extrémité de l'agent se trouve dans une location différente de celle où vous créez l'outil Agent, obtenez l'OCID du point d'extrémité de l'agent. Si vous avez besoin d'aide, voir Obtention des détails d'un point d'extrémité.