Richtlinien für Agent-Tools in Generative AI Agents

Verstehen Sie die Eigenschaften und Verantwortlichkeiten eines Supervisor-Agents und seiner Mitarbeiter-Agents.

• Der Supervisor-Agent und ein Mitarbeiter-Agent können zu verschiedenen Mandanten gehören.

• Ein Mitarbeiter-Agent kann ein Agent mit einem beliebigen Tooltyp (z.B. RAG-Tool) oder einer Kombination von Tooltypen (z.B. RAG- und Funktionstools) sein, solange der Agent mit einem aktiven Agent-Endpunkt verknüpft ist.

• Der Agent, der als Agent-Tool konfiguriert ist, kann unabhängig arbeiten und in einen Supervisor-Agent integriert werden.

• Zusätzliche Tools (wie RAG und SQL) können in den Supervisor-Agent mit Mitarbeiter-Agents aufgenommen werden.

• Der Supervisor-Agent ist verantwortlich für:

  • Sessionverwaltung und Abfrageweiterleitung

  • Aggregieren von Antworten von Mitarbeitern oder Tools

  • Verwalten einer globalen Chathistorie

• Ein Mitarbeiter ist verantwortlich für:

  • Bearbeitung von Abfragen, die für seine Spezialisierung relevant sind (z.B. HR)
  • Verwalten einer lokalisierten Chathistorie, die mit der globalen Session verknüpft ist.

• Metriken und Abrechnung werden für den Supervisor-Agent, Mitarbeiter-Agents und Tools separat abgewickelt.

Ein mögliches Datenfluss-Szenario mit Antworten mehrerer Mitarbeiter-Agents kann wie folgt beschrieben werden:

1. Ein Benutzer sendet in einer Chatsession eine Abfrage an den Supervisor-Agent. Die Abfrage umfasst mehrere Spezialisierungen.
2. Der Supervisor-Agent teilt die Abfrage auf und delegiert die Unterabfragen basierend auf der Routinglogik an die relevanten Mitarbeiter-Agents.
3. Jeder Mitarbeiter-Agent verarbeitet seine Unterabfrage mit seinem Sessionkontext. Die Mitarbeiter-Agents geben ihre Antworten an den Supervisor-Agent zurück.
4. Der Supervisor-Agent aggregiert und formatiert die Antworten in einer konsolidierten Ausgabe und sendet die Ausgabe an den Benutzer.

Der Workflow zur Implementierung von Mitarbeiter-Agents und Supervisor-Agents lautet:

1. Die erforderlichen OCI Identity and Access Management-(IAM-)Policys verstehen und hinzufügen Siehe IAM-Policys.
2. Erstellen Sie die Mitarbeiter-Agents mit einem beliebigen Tool. Wenn Sie Hilfe benötigen, lesen Sie Agent erstellen.
3. Stellen Sie sicher, dass jedem Mitarbeiter-Agent ein Agent-Endpunkt zugeordnet ist, der aktiv und für die Session aktiviert ist. Wenn Sie Hilfe benötigen, lesen Sie Details eines Endpunkts abrufen.
4. Erstellen Sie den Supervisor-Agent. Verwenden Sie den Typ Agent-Tool, um die Mitarbeiter-Agents hinzuzufügen. Weitere Informationen finden Sie unter Agent-Tool erstellen.
5. Stellen Sie sicher, dass der Agent-Endpunkt für den Supervisor-Agent für die Session aktiviert ist. Wenn Sie Hilfe benötigen, lesen Sie Details eines Endpunkts abrufen.

Stellen Sie sicher, dass Sie Benutzern Zugriff auf alle Generative AI Agents-Ressourcen erteilen, wie unter Policys hinzufügen, bevor Sie den Service verwenden können beschrieben.

Prüfen Sie auch die folgenden Abschnitte.

Dynamische Gruppe und Policys

Sie müssen eine dynamische Gruppe mit der Berechtigung zum Verwalten von genai-agent-family hinzufügen.

1. Erstellen Sie eine dynamische Gruppe, und fügen Sie die folgende Vergleichsregel hinzu.

   ALL {resource.type='genaiagent'}

   Weitere Informationen finden Sie unter Dynamische Gruppe erstellen.

2. Erteilen Sie der dynamischen Gruppe die Berechtigung.

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

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

   • Verwenden Sie die folgende Policy mit einer Identitätsdomain, die nicht der Standardwert ist, und geben Sie den Oracle Identity Cloud Service-(IDCS-)Domainnamen und den dynamischen Gruppennamen an:

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

   Informationen zum Zuweisen von Berechtigungen basierend auf einzelnen Ressourcentypen anstelle des aggregierten Ressourcentyps finden Sie unter Informationen zu Ressourcentypen für Generative AI Agents.

Mandantenübergreifender Zugriff

Um einen Agent-Endpunkt aus einem anderen Mandanten zu verwenden, müssen bestimmte Policys im Zielmandanten und im Mandanten eingerichtet werden, in dem Sie das Agent-Tool erstellen. Sammeln Sie die folgenden Informationen:

• Name und OCID des Zielmandanten. Zielmandant ist der Mandant mit dem aktiven Agent-Endpunkt, den Sie verwenden möchten.
• Name und OCID des Mandanten, in dem Sie ein Agent-Tool erstellen.
• Name und OCID der dynamischen Gruppe.

Schreiben Sie die folgenden mandantenübergreifenden Policy-Anweisungen. Verwenden Sie gegebenenfalls das Formular '<idcs-domain-name>/<dynamic-group-name>' in der Syntax zur Verwendung in einer Identitätsdomain, die nicht "Standard" ist.

In dem Mandanten, in dem Sie ein Agent-Tool erstellen:

<target-tenancy> ist der Mandant mit dem aktiven Agent-Endpunkt, den Sie verwenden möchten.

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

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

Im Zielmandanten:

<this-tenancy> ist der Mandant, in dem Sie ein Agent-Tool erstellen.

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

Wenn Sie Hilfe benötigen, finden Sie weitere Informationen unter Mandantenübergreifende Zugriffs-Policys in der Dokumentation für OCI IAM mit Identitätsdomains.

Ein Agent-Tool unterstützt nur einen Agent mit einem Agent-Endpunkt, für den die Session aktiviert ist.

Wenn die Session auf einem Agent-Endpunkt aktiviert ist, um den Kontext einer Chatsession beizubehalten, erstellt Generative AI Agents eine Session-ID und persistiert die Agent-Session für die interaktive Unterhaltung. Während der Session werden Kontext und Kontinuität beibehalten, um kohärente und aussagekräftige Antworten während der gesamten Unterhaltung bereitzustellen.

Stellen Sie für einen Mitarbeiter-Agent, der in einem Supervisor-Agent konfiguriert werden soll, sicher, dass der Agent nur über einen sessionbasierten Agent-Endpunkt verfügt. Der Supervisor-Agent darf auch nur mit einem Agent-Endpunkt verknüpft werden, für den die Session aktiviert ist.

Wenn Sie mit der Konsole einen Agent erstellen und den Agent-Endpunkt automatisch gleichzeitig erstellen, wird die Session standardmäßig auf dem Agent-Endpunkt aktiviert, der mit dem Agent erstellt wird. Zur Prüfung können Sie die Details des Endpunkts im Agent anzeigen.

Wenn Sie einen Agent-Endpunkt manuell erstellen, stellen Sie sicher, dass Session aktivieren ausgewählt ist, wenn der Endpunkt mit einem Agent-Tool konfiguriert werden soll.

Bevor Sie ein Agent-Tool erstellen, sammeln Sie die folgenden Informationen:

• Der Name des Agents, der als Tool hinzugefügt werden soll.
• Der Name des aktiven, sitzungsbasierten Agent-Endpunkts für diesen Agent. Erstellen Sie einen Agent-Endpunkt, wenn der Agent keinen aktiven Endpunkt hat, den Sie verwenden können. Wenn Sie Hilfe benötigen, lesen Sie Endpunkt erstellen.
• Wenn sich der Agent-Endpunkt in einem anderen Mandanten als der Mandant befindet, in dem Sie das Agent-Tool erstellen, rufen Sie die Agent-Endpunkt-OCID ab. Wenn Sie Hilfe benötigen, lesen Sie Details eines Endpunkts abrufen.