Accesso agli agenti di intelligenza artificiale generativa

Consente agli utenti di accedere alle risorse degli agenti di intelligenza artificiale generativa, ad esempio agenti, knowledge base, origini dati, job di inclusione dati, sessioni agente, richieste di lavoro agente ed endpoint

• Per ottenere l'accesso a tutte le risorse degli agenti AI generativi nell'intera tenancy, utilizzare il criterio riportato di seguito.

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

• Per ottenere l'accesso a tutte le risorse degli agenti AI generativi nel compartimento, utilizzare il criterio riportato di seguito.

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

Se i file di dati per l'agente si trovano nei bucket di storage degli oggetti OCI, è necessario disporre dell'autorizzazione per elencare e selezionare tali file nell'ambito del servizio Agenti AI generativi.

• Per concedere agli utenti l'autorizzazione per aggiungere file di storage degli oggetti alle rispettive knowledge base, procedere come segue.

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

Chiedere a un amministratore di esaminare gli esempi in Protezione dello storage degli oggetti e aggiungere i criteri applicabili all'utente, ad esempio i criteri, per evitare l'eliminazione accidentale dei bucket che contengono dati di addestramento.

Per includere grandi quantità di contenuto da OCI Object Storage, attenersi alla procedura riportata di seguito per creare i principal delle risorse per i job di inclusione dei dati che potrebbero essere eseguiti per più di 24 ore.

1. Attenersi alla procedura descritta in Creazione di un gruppo dinamico con le specifiche riportate di seguito per la regola di corrispondenza.
   1. Nella sezione Regole di corrispondenza selezionare Corrispondenza con le regole definite di seguito.
   2. Immettere la seguente regola di corrispondenza.

      ALL {resource.type='genaiagentdataingestionjob'}

      Il tipo di risorsa genaiagentdataingestionjob è il principal risorsa per i job di inclusione dati. La regola di corrispondenza precedente indica che questo gruppo dinamico rappresenta la risorsa job di inclusione dei dati degli agenti AI generativi.

      Per limitare l'appartenenza al gruppo dinamico ai job di inclusione dati creati in un compartimento specifico, anziché alla regola di corrispondenza precedente, utilizzare la regola seguente:

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

   3. Consenti a questo gruppo dinamico di accedere agli oggetti di storage degli oggetti in un compartimento specificato.

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

      È possibile limitare ulteriormente i criteri con più condizioni. Ad esempio:

      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>'}
      

      Per ulteriori esempi sulla scrittura dei criteri, vedere Protezione dello storage degli oggetti.

      Nota
      
      Puoi limitare l'accesso allo storage degli oggetti, utilizzando condizioni che includono nomi di bucket, compartimenti e tag. La limitazione dell'accesso mediante la specifica di un nome oggetto o di un prefisso in un criterio, ad esempio target.object.name, non è supportata e il job di inclusione dati potrebbe non riuscire.

Se i dati si trovano nell'area di memorizzazione vettoriale di Oracle Database o nella ricerca OCI con OpenSearch, eseguire i task riportati di seguito.

1. Per i dati di Oracle Database, eseguire i task riportati in RAG Tool Oracle Database Guidelines for Generative AI Agents.
2. Per la ricerca OCI con dati OpenSearch, eseguire i task in Ricerca OCI dello strumento RAG con OpenSearch Guidelines for Generative AI Agents.
3. Attenersi alla procedura descritta in Creazione di un gruppo dinamico con le specifiche riportate di seguito per la regola di corrispondenza.
   1. Nella sezione Regole di corrispondenza selezionare Corrispondenza con le regole definite di seguito.
   2. Immettere la seguente regola di corrispondenza.

      ALL {resource.type='genaiagent'}

      Il tipo di risorsa genaiagent è il principal risorsa per gli agenti. La regola di corrispondenza precedente indica che questo gruppo dinamico rappresenta la risorsa agente Agenti AI generativi.

   3. Consenti a questo gruppo dinamico di accedere ai segreti di OCI Vault nel compartimento con l'area di memorizzazione vettoriale di Oracle Database o con OCI Search con segreto OpenSearch.

      Scrivere il criterio seguente, che può essere utilizzato con il dominio di Identity predefinito:

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

      Utilizzare il criterio seguente con un dominio di Identity non predefinito, fornendo il nome del dominio Oracle Identity Cloud Service (IDCS) e il nome del gruppo dinamico:

      allow dynamic-group '<idcs-domain-name>/<dynamic-group-name>' 
      to read secret-bundle in compartment <compartment-name>
      

Se i tuoi dati si trovano in Oracle Database 23ai, consenti al gruppo dinamico, creato per l'accesso al servizio a OCI Vault, di accedere anche agli strumenti di database OCI.

Scrivere il criterio seguente, che può essere utilizzato con il dominio di Identity predefinito:

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

Utilizzare il criterio seguente con un dominio di Identity non predefinito, fornendo il nome del dominio Oracle Identity Cloud Service (IDCS) e il nome del gruppo dinamico:

allow dynamic-group '<idcs-domain-name>/<dynamic-group-name>' 
to read database-tools-family in compartment <compartment-name>

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

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

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

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

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

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

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