Accès aux agents d'intelligence artificielle générative

Donner aux utilisateurs l'accès aux ressources des agents d'IA génératifs telles que les agents, les bases de connaissances, les sources de données, les tâches d'ingestion de données, les sessions d'agent, les demandes de travail d'agent et les points d'extrémité

• Pour accéder à toutes les ressources des agents d'IA génératifs dans l'ensemble de la location, utilisez la politique suivante :

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

• Pour accéder à toutes les ressources des agents d'IA génératifs de votre compartiment, utilisez la politique suivante :

  allow group <genai-agent-administrators> to manage genai-agent-family in compartment <your-compartment-name>

Si les fichiers de données de votre agent se trouvent dans des seaux de stockage d'objets OCI, vous devez disposer d'une autorisation pour lister et sélectionner ces fichiers dans le service Agents d'intelligence artificielle génératifs.

• Pour autoriser les utilisateurs à ajouter des fichiers de stockage d'objets à leurs bases de connaissances :

  allow group <your-group-name> to manage object-family in compartment <compartment-with-bucket>

Demandez à un administrateur de réviser les exemples sous Sécurisation du stockage d'objets et d'ajouter des politiques qui s'appliquent à vous, telles que des politiques, pour éviter la suppression accidentelle de seaux contenant des données d'entraînement.

Pour ingérer de grandes quantités de contenu à partir du service de stockage d'objets pour OCI, suivez ces étapes pour créer des principaux de ressource pour les tâches d'ingestion de données qui peuvent s'exécuter plus de 24 heures.

1. Suivez les étapes sous Création d'un groupe dynamique avec les spécificités suivantes pour la règle de correspondance :
   1. Dans la section Règles de correspondance, sélectionnez Correspondance avec les règles définies ci-dessous.
   2. Entrez la règle de correspondance suivante.

      ALL {resource.type='genaiagentdataingestionjob'}

      Le type de ressource genaiagentdataingestionjob est le principal de ressource pour les tâches d'ingestion de données. La règle de correspondance précédente signifie que ce groupe dynamique représente la ressource de tâche d'ingestion de données des agents d'IA génératifs.

      Pour limiter l'appartenance à un groupe dynamique aux tâches d'ingestion de données créées dans un compartiment spécifique, au lieu de la règle de correspondance précédente, utilisez la suivante :

      ALL {resource.type = 'genaiagentdataingestionjob', 
      resource.compartment.id = '<compartment-ocid-for-ingestion-jobs>'}
      

   3. Autoriser ce groupe dynamique à accéder aux objets de stockage d'objets dans un compartiment spécifié.

      allow dynamic-group <dynamic-group-name> 
      to read objects in compartment <compartment-name-for-objects>
      

      Vous pouvez restreindre davantage les règles avec plus de conditions. Exemple :

      allow dynamic-group <dynamic-group-name> 
      to read objects in tenancy where all {target.compartment.id='<compartment_ocid>', 
      target.bucket.name=<bucket-name>, 
      target.bucket.tag.MyTagNamespace.TagKey='<MyTagValue>'}
      

      Pour plus d'exemples sur l'écriture de politiques, voir Sécurisation du stockage d'objets.

      Note
      
      Vous pouvez restreindre l'accès au stockage d'objets à l'aide de conditions qui incluent des noms de seau, des compartiments et des marqueurs. La restriction de l'accès en spécifiant un nom d'objet ou un préfixe dans une politique, par exemple target.object.name, n'est pas prise en charge et la tâche d'ingestion de données peut échouer.

Si vos données se trouvent dans le magasin de vecteurs Oracle Database ou dans la recherche OCI avec OpenSearch, effectuez les tâches suivantes :

1. Pour les données Oracle Database, effectuez les tâches décrites dans les Directives Oracle Database pour les agents d'IA générative de l'outil RAG.
2. Pour la recherche OCI avec les données OpenSearch, effectuez les tâches dans Recherche OCI avec OpenSearch directives pour les agents d'IA générative.
3. Suivez les étapes sous Création d'un groupe dynamique avec les spécificités suivantes pour la règle de correspondance :
   1. Dans la section Règles de correspondance, sélectionnez Correspondance avec les règles définies ci-dessous.
   2. Entrez la règle de correspondance suivante.

      ALL {resource.type='genaiagent'}

      Le type de ressource genaiagent est le principal de ressource pour les agents. La règle de correspondance précédente signifie que ce groupe dynamique représente la ressource d'agent Agents d'IA génératifs.

   3. Autorisez ce groupe dynamique à accéder aux clés secrètes de chambre forte OCI dans le compartiment avec votre magasin de vecteurs Oracle Database ou la recherche OCI avec la clé secrète OpenSearch.

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

      allow dynamic-group <dynamic-group-name> 
      to read secret-bundle in compartment <compartment-name>
      

      Utilisez la politique suivante avec un domaine d'identité pas 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 read secret-bundle in compartment <compartment-name>
      

Si vos données se trouvent dans Oracle Database 23ai, autorisez le groupe dynamique, que vous avez créé pour le service d'accès au service de chambre forte OCI, à accéder également aux outils de base de données OCI.

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

allow dynamic-group <dynamic-group-name> 
to read database-tools-family in compartment <compartment-name>

Utilisez la politique suivante avec un domaine d'identité pas 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 read database-tools-family in compartment <compartment-name>

Exemple :

allow group GenAI-agents-users to use genai-agent in compartment GenAI-agents-compartment

Exemple :

allow group GenAI-agents-users to manage genai-agent-knowledge-base in compartment GenAI-agents-compartment

Exemple :

allow group GenAI-agents-users to inspect genai-agent-data-source in compartment GenAI-agents-compartment

Exemple :

allow group GenAI-agents-users to inspect genai-agent-data-ingestion-job in compartment GenAI-agents-compartment

Exemple :

allow group GenAI-agents-users to manage genai-agent-endpoint in compartment GenAI-agents-compartment

Exemple :

allow group GenAI-agents-users to read genai-agent-work-request in compartment GenAI-agents-compartment

Exemple :

allow group GenAI-agents-users to manage genai-agent-session in compartment GenAI-agents-compartment

Exemple :

allow group GenAI-agents-users to use genai-agent-tool in compartment GenAI-agents-compartment