Zugriff auf generative KI-Agents erhalten

Benutzern Zugriff auf generative KI-Agents wie Agents, Wissensdatenbanken, Datenquellen, Datenaufnahmejobs, Agent-Sessions, Agent-Arbeitsanforderungen und Endpunkte gewähren

• Um Zugriff auf alle generativen KI-Agents im gesamten Mandanten zu erhalten, verwenden Sie die folgende Policy:

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

• Um Zugriff auf alle generativen KI-Agents in Ihrem Compartment zu erhalten, verwenden Sie die folgende Policy:

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

Wenn sich die Datendateien für Ihren Agent in OCI Object Storage-Buckets befinden, benötigen Sie die Berechtigung, diese Dateien im Generative AI-Agents-Service aufzulisten und auszuwählen.

• So erteilen Sie Benutzern die Berechtigung, Object Storage-Dateien zu ihren Wissensdatenbanken hinzuzufügen:

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

Bitten Sie einen Administrator, die Beispiele in Object Storage sichern zu prüfen und Policys hinzuzufügen, die für Sie gelten, wie Policys, um das versehentliche Löschen von Buckets mit Schulungsdaten zu vermeiden.

Um große Mengen an Inhalt aus OCI Object Storage aufzunehmen, führen Sie die folgenden Schritte aus, um Resource Principals für Datenaufnahmejobs zu erstellen, die länger als 24 Stunden ausgeführt werden können.

1. Führen Sie die Schritte unter Dynamische Gruppe erstellen mit den folgenden Besonderheiten für die Abgleichsregel aus:
   1. Wählen Sie im Abschnitt Übereinstimmungsregeln die Option Übereinstimmung mit unten definierten Regeln aus.
   2. Geben Sie die folgende Vergleichsregel ein.

      ALL {resource.type='genaiagentdataingestionjob'}

      Der Ressourcentyp genaiagentdataingestionjob ist der Resource Principal für Datenaufnahmejobs. Die vorherige Übereinstimmungsregel bedeutet, dass diese dynamische Gruppe die Jobressource für die Datenaufnahme von Generative AI Agents darstellt.

      Um die Mitgliedschaft einer dynamischen Gruppe auf Datenaufnahmejobs zu beschränken, die in einem bestimmten Compartment erstellt wurden, verwenden Sie anstelle der vorherigen Vergleichsregel Folgendes:

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

   3. Lassen Sie zu, dass diese dynamische Gruppe auf Object Storage-Objekte in einem angegebenen Compartment zugreift.

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

      Sie können die Policys mit weiteren Bedingungen weiter einschränken. Beispiele:

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

      Weitere Beispiele zum Schreiben von Policys finden Sie unter Object Storage sichern.

      Hinweis
      
      Sie können den Zugriff auf Object Storage mit Bedingungen wie Bucket-Namen, Compartments und Tags einschränken. Das Einschränken des Zugriffs durch Angabe eines Objektnamens oder Präfixes in einer Policy wie target.object.name wird nicht unterstützt, und der Datenaufnahmejob verläuft möglicherweise nicht erfolgreich.

Wenn sich Ihre Daten im Oracle Database-Vektorspeicher oder in OCI Search mit OpenSearch befinden, führen Sie die folgenden Aufgaben aus:

1. Führen Sie für Oracle Database-Daten die Aufgaben unter Oracle Database-Richtlinien für generative KI-Agents des RAG-Tools aus.
2. Führen Sie für OCI Search mit OpenSearch-Daten die Aufgaben in RAG Tool OCI Search with OpenSearch Guidelines for Generative AI Agents aus.
3. Führen Sie die Schritte unter Dynamische Gruppe erstellen mit den folgenden Besonderheiten für die Abgleichsregel aus:
   1. Wählen Sie im Abschnitt Übereinstimmungsregeln die Option Übereinstimmung mit unten definierten Regeln aus.
   2. Geben Sie die folgende Vergleichsregel ein.

      ALL {resource.type='genaiagent'}

      Der Ressourcentyp genaiagent ist der Resource Principal für Agents. Die vorhergehende Übereinstimmungsregel bedeutet, dass diese dynamische Gruppe die Agent-Ressource für generative AI-Agents darstellt.

   3. Lassen Sie zu, dass diese dynamische Gruppe mit dem Oracle Database-Vektorspeicher oder der OCI-Suche mit dem OpenSearch-Secret auf OCI Vault-Secrets im Compartment zugreift.

      Schreiben Sie die folgende Policy, die mit der Standardidentitätsdomain verwendet werden kann:

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

      Verwenden Sie die folgende Policy mit einer Identitätsdomain, die nicht standardmäßig ist, und geben Sie den Oracle Identity Cloud Service-(IDCS-)Domainnamen und den Namen der dynamischen Gruppe an:

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

Wenn sich Ihre Daten in Oracle Database 23ai befinden, ermöglichen Sie der dynamischen Gruppe, die Sie für den Servicezugriff auf OCI Vault erstellt haben, den Zugriff auf auch OCI-Datenbanktools.

Schreiben Sie die folgende Policy, die mit der Standardidentitätsdomain verwendet werden kann:

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

Verwenden Sie die folgende Policy mit einer Identitätsdomain, die nicht standardmäßig ist, und geben Sie den Oracle Identity Cloud Service-(IDCS-)Domainnamen und den Namen der dynamischen Gruppe an:

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

Beispiel:

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

Beispiel:

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

Beispiel:

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

Beispiel:

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

Beispiel:

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

Beispiel:

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

Beispiel:

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

Beispiel:

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