Instructions 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 (tel que l'outil RAG) ou une combinaison de types d'outil (tels que les outils d'appel RAG et Fonction), à condition que l'agent soit associé à une adresse d'agent actif.

• L'agent configuré en tant qu'outil Agent peut fonctionner indépendamment et être intégré dans 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 de :

  • Gestion des sessions et routage des requêtes

  • Agrégation des réponses des agents ou outils collaborateurs

  • Tenir à jour un historique global des discussions

• Un agent collaborateur est responsable de :

  • Gérer les requêtes relatives à sa spécialisation (par exemple, RH)
  • Tenir à jour un historique de discussion localisé lié à la session globale.

• Les mesures et la facturation sont géré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 requête à l'agent superviseur dans une session de discussion. La requête couvre plusieurs spécialisations.
2. L'agent superviseur divise la requête et délègue les sous-requêtes 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 agrège et formate les réponses dans une sortie consolidée, puis envoie la sortie à l'utilisateur.

Le workflow d'implémentation des agents collaborateurs et d'un agent superviseur est le suivant :

1. Découvrez et ajoutez les stratégies OCI Identity and Access Management (IAM) requises. Reportez-vous à Stratégies IAM.
2. Créez les agents collaborateurs à l'aide de n'importe quel outil. Si vous avez besoin d'aide, reportez-vous à Création d'un agent.
3. Assurez-vous que chaque agent collaborateur est associé à une adresse d'agent active et activée pour la session. Si vous avez besoin d'aide, reportez-vous à Obtention des détails d'une adresse.
4. Créez l'agent superviseur. Utilisez le type d'outil Agent pour ajouter les agents collaborateurs. Pour obtenir de l'aide, reportez-vous à Création d'un outil d'agent.
5. Assurez-vous que l'adresse d'agent de l'agent superviseur est activée pour la session. Si vous avez besoin d'aide, reportez-vous à Obtention des détails d'une adresse.

Veillez à accorder aux utilisateurs l'accès à toutes les ressources des agents d'IA générative, comme décrit dans Ajout de stratégies pour pouvoir utiliser le service.

Consultez également les sections suivantes.

Groupes dynamiques et stratégie

Vous devez ajouter un groupe dynamique avec le droit d'accès permettant de gérer genai-agent-family.

1. Créez un groupe dynamique et ajoutez la règle suivante de mise en correspondance.

   ALL {resource.type='genaiagent'}

   Si vous avez besoin d'aide, reportez-vous à Création d'un groupe dynamique.

2. Accordez un droit d'accès au groupe dynamique.

   • Ecrivez la stratégie 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 stratégie suivante avec un domaine d'identité non par défaut, en indiquant 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
     

   Reportez-vous à A propos des types de ressource d'agents d'IA générative pour affecter des droits d'accès en fonction de types de ressource individuels au lieu du type de ressource agrégé.

Accès inter-location

Pour utiliser une adresse d'agent provenant d'une autre location, certaines stratégies doivent être configurées dans la location cible et dans la location dans laquelle vous créez l'outil d'agent. Collectez les informations suivantes :

• Nom et OCID de la location cible. La location cible est la location dont l'adresse d'agent actif doit être utilisée.
• Nom et OCID de la location dans laquelle vous créez un outil d'agent.
• Nom et OCID du groupe dynamique.

Ecrivez les instructions de stratégie inter-locations suivantes. Le cas échéant, 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 dans laquelle vous créez un outil d'agent :

<target-tenancy> est la location dont l'adresse d'agent actif doit être utilisée.

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 dans laquelle 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, reportez-vous à Stratégies d'accès inter-location dans la documentation d'OCI IAM avec des domaines d'identité.

Un outil d'agent ne prend en charge qu'un agent dont la session est activée.

Lorsque la session est activée sur une adresse d'agent pour conserver le contexte d'une session de discussion, les agents d'IA générative créent un ID de session et persistent dans 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 dispose uniquement d'une adresse d'agent basée sur une session. L'agent superviseur doit également être associé uniquement à une adresse d'agent pour laquelle 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 l'adresse d'agent en même temps, la session est activée sur l'adresse d'agent créée avec l'agent. Pour vérifier, vous pouvez afficher les détails de l'adresse dans l'agent.

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

Avant de créer un outil d'agent, rassemblez les informations suivantes :

• Nom de l'agent à ajouter en tant qu'outil.
• Nom de l'adresse d'agent active basée sur une session pour cet agent. Créez une adresse d'agent si l'agent n'a pas d'adresse active que vous pouvez utiliser. Si vous avez besoin d'aide, reportez-vous à Création d'une adresse.
• Si l'adresse d'agent se trouve dans une location différente de celle dans laquelle vous créez l'outil d'agent, obtenez l'OCID de l'adresse d'agent. Si vous avez besoin d'aide, reportez-vous à Obtention des détails d'une adresse.