Supervisor-geführte Agent-Teams mit ausgewählter KI erstellen

Erstellen Sie ein von einem Vorgesetzten geführtes Select AI-Agent-Team, das mehrstufige Anforderungen an spezialisierte Mitarbeiter-Agents leitet und eine koordinierte Antwort zurückgibt.

Ein Select AI Supervisor-Agent ist das Select AI agent-Objekt, das ein von einem Supervisor geführtes Agent-Team zur Laufzeit steuert. Das Supervisor-Agent-Objekt empfängt den Benutzer-Prompt, wählt das Worker-Agent-Aufgabenpaar aus, das jede Unteraufgabe verarbeiten soll, übergibt den erforderlichen Kontext, wartet auf dieses Worker-Ergebnis und wählt weiterhin das nächste Agent-Aufgabenpaar aus, bis es eine endgültige Antwort zurückgeben kann.

Die folgende Abbildung zeigt das Agent-Muster "AI-Supervisor auswählen". Beschreibung von select-ai-supervisor-agent-pattern.png

Wann ein Supervisor-Agent verwendet wird

Verwenden Sie das Vorgesetztenmuster, wenn das Team die entsprechenden Mitarbeiter oder die Ausführungsreihenfolge zur Laufzeit bestimmen muss. Ein von einem Vorgesetzten geführtes Team kann helfen, wenn für eine Anforderung verschiedene Mitarbeiter in unterschiedlichen Bestellungen erforderlich sind, je nach Intent des Benutzers und den Zwischenergebnissen. Der Vorgesetzte entscheidet, welches Mitarbeiter-Agent-Task-Paar als nächstes anruft, übergibt eine in sich geschlossene Unteraufgabe, wartet auf das Ergebnis und fährt fort, bis er eine koordinierte endgültige Antwort erstellen kann.

Ein Supervisor-Agent eignet sich für:

Informationen zu Select AI Supervisor Agent Teams

Erfahren Sie, wie ein Select AI-Supervisor-Agentteam Mitarbeiter koordiniert, die Aufgabenweiterleitung steuert, den Kontext beibehält und eine letzte Antwort zurückgibt.

Ein Supervisor-Agent-Team ist ein Orchestrierungsmuster für ein Select AI-Agent-Team. In diesem Team wird ein Select AI Agent-Objekt als Supervisor identifiziert, indem das Attribut supervisor auf true und die Teamnamen, die das Objekt im Attribut supervisor_agent enthalten, gesetzt werden. Mitarbeiter-Agents behalten fokussierte Zuständigkeiten, wie Kontosuche, Zahlungsabruf, Berichtsgenerierung oder Benachrichtigungszustellung. Das Objekt "Supervisor-Agent" entscheidet, welcher Mitarbeiter angerufen werden soll, bereitet eine in sich geschlossene Anforderung für diesen Mitarbeiter vor und fügt das Mitarbeiterergebnis wieder in den Kontext des Vorgesetzten ein.

Die Verarbeitung der Unteraufgabe ist sequenziell: Eine Mitarbeiterunteraufgabe muss abgeschlossen sein, bevor der Vorgesetzte die nächste Unteraufgabe delegiert. Der Vorgesetzte wartet auf das Mitarbeiterergebnis, fügt das Ergebnis dem Kontext des Vorgesetzten hinzu und entscheidet dann, ob er einen anderen Mitarbeiter anruft, weitere Informationen anfordert, einen Mitarbeiterfehler erklärt oder die endgültige Antwort zurückgibt. Mitarbeiter-Agents verwenden separate Unterhaltungsthreads, sodass der Vorgesetzte in jeder delegierten Anforderung ausreichend Kontext enthalten muss.

Mit diesem Feature werden Supervisor-bezogene Attribute zu vorhandenen DBMS_CLOUD_AI_AGENT-APIs hinzugefügt. Verwenden Sie das Agent-Attribut supervisor, um ein Select AI-Agent-Objekt als Supervisor zu markieren. Verwenden Sie das Teamattribut supervisor_agent, um das Supervisor-Agent-Objekt für ein Team zu benennen. Ein beaufsichtigtes Team enthält ein Supervisor-Agent-Objekt und mindestens ein Worker-Agent-Aufgabenpaar. Das Teamattribut agents listet die für die Delegierung verfügbaren Worker-Agent-Aufgabenpaare auf. Jede Mitarbeiteraufgabe kann ihre konfigurierten Tools verwenden. Das Supervisor-Agent-Objekt wird an Worker-Agent-Task-Paare delegiert. Das von Oracle verwaltete Delegierungstool ist nicht vom Benutzer konfigurierbar.

Ein End-to-End-Beispiel für die Verwendung eines Supervisor-Agents finden Sie unter Beispiel: Supervisor-Teams erstellen und ausführen.

AI Supervisor-Agent-Architektur auswählen

Ein beaufsichtigtes Select AI-Agent-Team wird als ein einzelnes Team mit einem Supervisor-Agentobjekt und einem oder mehreren Worker-Agent-Aufgabenpaaren ausgeführt. Die Teamdefinition benennt das Supervisor-Agent-Objekt in supervisor_agent. Die Worker-Liste benennt die Agent-Aufgabenpaare, an die der Supervisor delegieren kann. Tools werden für Mitarbeiteraufgaben konfiguriert, nicht für das Team.

In einem von einem Vorgesetzten geführten Team ist der Prozess weiterhin auf "Sequenziell" gesetzt, aber die konfigurierte Mitarbeiterreihenfolge ist nicht der Workflowplan. Der Vorgesetzte wählt dynamisch jeweils ein Agent-Task-Paar für einen Mitarbeiter aus, wartet auf das Ergebnis und entscheidet dann, ob ein anderer Mitarbeiter benötigt wird.

Das Supervisor-Agent-Objekt verwendet intern ein von Oracle verwaltetes Delegationstool, um es an ein Worker-Agent-Aufgabenpaar zu delegieren. Das Delegationstool ist Teil des Supervisor-Ausführungsmodells und wird nicht als vom Benutzer konfigurierbares Teamattribut aufgeführt.

Der Supervisor ist Eigentümer der Gesamtanforderung und wird in einem eigenen Unterhaltungsthread ausgeführt. Jeder Worker-Agent wird in einem separaten Unterhaltungsthread ausgeführt. Ein Mitarbeiter erbt nicht den vollständigen Kontext des Vorgesetzten. Der Vorgesetzte muss für jeden Mitarbeiter eine in sich geschlossene Unteraufgabenanforderung erstellen. Der Mitarbeiter gibt nur sein Endergebnis an den Vorgesetzten zurück. Der Supervisor fügt das zurückgegebene Ergebnis seinem eigenen Kontext hinzu und entscheidet über die nächste Aktion.

Beschreibung des Bildes folgt

Phase Eingabe Wird verarbeitet Ausgabe
Anforderungsweiterleitung Benutzeranforderung in natürlicher Sprache an das Team weitergeleitet Das beaufsichtigte Team aktiviert zuerst den Supervisor-Agent. Supervisor-Unterhaltungsthread wird für die Anforderung gestartet.
Vorgesetztenbegründungsschleife Benutzeranfrage und aktueller Vorgesetztenkontext Der Vorgesetzte entscheidet, ob er genügend Informationen zur Beantwortung hat oder eine Unteraufgabe delegieren muss. Letzte Antwort oder ein delegierter Mitarbeiterantrag.
Aufgabendelegation Ausgewähltes Worker-Agent-Aufgabenpaar und in sich abgeschlossener Unteraufgabenkontext Der Supervisor ruft das von Oracle verwaltete Delegierungstool für das ausgewählte Worker-Agent-Task-Paar auf und wartet. Worker-Aufgabe beginnt in einem eigenen Unterhaltungsthread.
Aufgabenverarbeitung Konfiguration von delegierten Unteraufgaben und Mitarbeiteraufgaben Der Mitarbeiter verwendet die für seine Aufgabe konfigurierten Tools. Wenn eine Benutzereingabe erforderlich ist, wartet das Team auf die Benutzerantwort. Mitarbeiterergebnis, Mitarbeiterfehlerergebnis oder Human-Input-Anforderung.
Fortsetzung des Vorgesetzten Mitarbeiterergebnis, Fehlerergebnis oder Benutzerantwort zurückgegeben Der Supervisor fügt das zurückgegebene Ergebnis zu seinem Kontext hinzu und setzt die Argumentation fort. Der Fehler folgt demselben Rückgabepfad wie der Erfolg. Der Vorgesetzte entscheidet, ob er es erneut versucht, einen anderen Mitarbeiter anruft, weitere Informationen anfordert, den Fehler erklärt oder die endgültige Antwort zurückgibt.  

Laufzeitverhalten in Teams mit Vorgesetzten

Erfahren Sie, wie Supervisor-geführte Teams für Benutzereingaben anhalten, Mitarbeiterfehler behandeln und in sich geschlossenen Kontext zwischen Supervisor- und Mitarbeitergesprächen übergeben.

Human Input-Verarbeitung

Wenn ein Mitarbeiter menschliche Eingaben anfordert, wird das gesamte vom Vorgesetzten geleitete Team angehalten, während auf die Benutzerantwort gewartet wird. Der Benutzer fährt in derselben Konversation fort, um die angeforderten Informationen bereitzustellen.

Nachdem der Benutzer geantwortet hat, wird der Mitarbeiter fortgesetzt, die Aufgabe abgeschlossen und das Ergebnis an den Vorgesetzten zurückgegeben. Der Vorgesetzte entscheidet dann, ob er eine weitere Unteraufgabe delegiert oder die endgültige Antwort zurückgibt.

Fehlerbehandlung

Worker-Fehler folgen demselben Rückgabepfad wie erfolgreiche Ergebnisse. Der Vorgesetzte erhält das Fehlerergebnis und entscheidet über die nächste Aktion, z.B. die Wiederholung der Aufgabe, den Aufruf eines anderen Worker-Agent-Aufgabenpaares, die Anforderung zusätzlicher Eingaben oder die Rückgabe einer endgültigen Antwort.

Kontextübergabemodell

Jeder Mitarbeiter arbeitet in seinem eigenen Konversationsthread und erbt nicht den vollständigen Kontext des Vorgesetzten. Der Vorgesetzte muss eine in sich geschlossene Unteraufgabenanforderung bereitstellen, die alle erforderlichen Informationen enthält, damit der Mitarbeiter die Aufgabe abschließen kann.

Anwendungsfälle für Supervisor-Agent

Wenden Sie von Vorgesetzten geführte KI-Teams an, wenn eine Anforderung mehrere spezialisierte Agents, bedingtes Routing oder eine zwischengespeicherte Antwort erfordern kann.

Leistungen

Verwenden Sie von Vorgesetzten geführte Teams, um mehrstufige Anforderungen weiterzuleiten, Mitarbeiter-Agents im Fokus zu halten und Delegierungspfade für Select AI Agent Framework-Aktivitäten aufzuzeichnen.

So verwenden Sie ausgewählte KI-Supervisor-Agentteams

Erstellen Sie den Agent, der als Supervisor dient, und bestimmen Sie ihn als Supervisor, erstellen Sie Mitarbeiter-Agents, fügen Sie den Supervisor den Teamattributen hinzu, und führen Sie Benutzer-Prompts für das Team aus.

  1. Erteilen Sie die erforderlichen Berechtigungen. Der Datenbankbenutzer muss über die Berechtigung EXECUTE für DBMS_CLOUD_AI_AGENT, den Zugriff auf die erforderlichen Zugangsdaten und die erforderlichen Netzwerk-ACLs für externe Provideraufrufe verfügen. Weitere Informationen finden Sie unter Voraussetzungen für die Verwendung von Select AI Agent.
  2. Erstellen Sie die Tools, die Worker-Agents verwenden, wie PL/SQL-Funktionen für Lookup-, Update-, Benachrichtigungs- oder Reportingaufgaben. Weitere Informationen finden Sie unter DBMS_CLOUD_AI_AGENT Package und Beispiele für die Verwendung von Select AI Agent.
  3. Mitarbeiter-Agents und -Aufgaben erstellen Halten Sie jede Mitarbeiterrolle spezifisch, damit der Vorgesetzte den richtigen Mitarbeiter für jede Unteraufgabe auswählen kann. Siehe Prozedur CREATE_TASK und Prozedur CREATE_AGENT.
  4. Erstellen Sie einen Supervisor-Agent, bei dem das Attribut supervisor auf true gesetzt ist. Siehe CREATE_AGENT Attribute.
  5. Erstellen Sie das Team, bei dem supervisor_agent auf den Namen des Supervisor-Agent und agents auf die Worker-Agent-Aufgabenpaare gesetzt ist. Siehe Prozedur CREATE_TEAM.
  6. Legen Sie das Team für die Session fest, und leiten Sie Eingabeaufforderungen in natürlicher Sprache mit dem Select AI Agent-Framework weiter. Siehe SET_TEAM-Funktion.
  7. Prüfen Sie Historienansichten, um Mitarbeiterweiterleitung, zurückgegebene Ergebnisse, Mitarbeiterfehler und menschliche Eingaben zu bestätigen. Wenn eine Mitarbeiteraufgabe menschliche Eingaben anfordert, wird das Team angehalten, bis der Benutzer antwortet. Während dieser Zeit pausiert das gesamte vom Vorgesetzten geführte Team. Setzen Sie dieselbe Unterhaltung fort, um die angeforderte Eingabe anzugeben. Nachdem der Benutzer geantwortet hat, wird der Mitarbeiter fortgesetzt, die Aufgabe abgeschlossen und das Ergebnis an den Vorgesetzten zurückgegeben. Der Vorgesetzte entscheidet dann über die nächste Aktion. Siehe DBMS_CLOUD_AI_AGENT Ansichten.

Nehmen Sie den ausgewählten Vorgesetzten nicht aus dem Array des Mitarbeiters agents auf. Der Supervisor kontrolliert das Team, während im Array nur Mitarbeiter-Agent-Aufgabenpaare aufgeführt werden, die für die Delegierung verfügbar sind. Eine Mitarbeiteraufgabe kann eigene konfigurierte Tools verwenden. Das Teamattribut listet keine Toolnamen auf.

Hinweis: Vorgesetzte Teams verarbeiten Mitarbeiterunteraufgaben sequenziell. Der Vorgesetzte wartet auf jedes Mitarbeiterergebnis, bevor er eine weitere Unteraufgabe delegiert. Parallele Worker-Ausführung ist nicht Teil dieses Release.

Zulässige Teamkonfigurationen für Supervisor-Agents

Prüfen Sie unterstützte Konfigurationen und Anleitungen zur Definition von Vorgesetzten, Mitarbeiter-Agent-Aufgabenpaaren, Tools und Verarbeitung in einem Select AI-Agent-Team.

Konfiguration Zulässig? Anleitung
supervisor_agent benennt einen Agent, der erstellt wurde, wobei supervisor auf true gesetzt ist Ja Verwenden Sie dieses Muster für beaufsichtigte Teams.
Der ausgewählte Vorgesetzte wird auch im Array agents des Mitarbeiters aufgeführt Nein Ein Agent, der als Vorgesetzter angegeben ist, kann nicht in das Array der Mitarbeiter aufgenommen werden. Bei der Designvalidierung werden Supervisor-fähige Agents im Array agents abgelehnt.
Dieselbe Mitarbeiter-Agent ist mehreren Aufgaben zugewiesen Ja Ein Agent kann mehrere Aufgaben ausführen, indem er denselben Agent verschiedenen Aufgabennamen zuweist.
Tools werden im Array agents des Teams aufgeführt Nein Definieren Sie Tools für Aufgaben mit CREATE_TASK. Das Teamattribut listet Mitarbeiter-Agent-Aufgabenpaare auf, nicht Toolnamen.
supervisor_agent benennt einen Agent, der nicht "supervisor": true enthält Nein Wählen Sie einen Agent aus, bei dem supervisor auf true gesetzt ist. Wenn der benannte Agent kein Supervisor ist, kann das Team nicht erstellt oder validiert werden. Prüfen Sie die zurückgegebenen Datenbankfehlerdetails.
Für ein Team sind mehrere Vorgesetzte definiert Nein Ein Team unterstützt genau einen Vorgesetzten. Definieren Sie einen einzelnen Agent mit "supervisor": true, und referenzieren Sie ihn in supervisor_agent.
Ein Vorgesetzter delegiert an ein anderes vom Vorgesetzten geführtes Team Nein Die Delegation von Vorgesetzten zu Vorgesetzten wird in diesem Release nicht unterstützt. Ein Vorgesetzter kann nur an Mitarbeiter-Agents im selben Team delegieren.
Ein Agent, der in einem Team als Vorgesetzter angegeben ist, kann als Mitarbeiter in einem anderen Team verwendet werden Ja Sie können denselben Supervisor-Agent in mehreren Teams mit verschiedenen Rollen (Supervisor oder Mitarbeiter) wiederverwenden. Definieren Sie die Rolle über die Teamkonfiguration.

Hinweis:

Fehlerbehebung für Teams mit Vorgesetzten

Identifizieren Sie mögliche Ursachen und Fehlerbehebungen für allgemeine Select AI Supervisor-geführte Teamkonfigurations-, Delegations-, Kontext-, Benachrichtigungs- und Human-Input-Probleme.

Teamerstellung nicht erfolgreich

Problem: Teamerstellung nicht erfolgreich.

Wahrscheinliche Ursache: supervisor_agent benennt keinen Agent mit "supervisor": true.

Beheben: Erstellen Sie den Agent mit dem Supervisor-Attribut neu, und erstellen Sie das Team dann erneut.

Der Vorgesetzte ruft den falschen Mitarbeiter auf

Problem: Der Vorgesetzte ruft den falschen Mitarbeiter an.

Wahrscheinlich: Die Aufgabenbeschreibungen der Mitarbeiter sind zu vage oder überschneiden sich.

Beheben: Machen Sie Aufgabenanweisungen spezifischer und schließen Sie sich gegenseitig aus. Der Supervisor wählt Mitarbeiter-Agent-Aufgabenpaare basierend auf Agent-Namen, Aufgabennamen, Beschreibungen und Aufgabenanweisungen aus.

Bei der Definition von Aufgaben für Mitarbeiter gelten folgende Richtlinien:

Einem Mitarbeiter fehlt der Kontext

Problem: Einem Worker fehlt Kontext.

Wahrscheinlich: Der Vorgesetzte hat in der delegierten Unteraufgabe nicht genügend Details übergeben.

Beheben: Fügen Sie Anweisungen hinzu, mit denen der Supervisor in sich geschlossene Unteraufgaben senden soll. Definieren Sie eine eindeutige Vorgesetztenrolle, um das Vertretungsverhalten zu steuern.

Beispiel:

{
  "profile_name": "<AI_PROFILE_NAME>",
  "supervisor": true,
  "role": "You orchestrate requests. Choose the appropriate worker agent-task pair for each subtask. Send self-contained requests with all required context. Return one concise final answer."
}

E-Mail wird nicht gesendet

Problem: E-Mail wird nicht gesendet.

Wahrscheinliche Ursache: Die Zugangsdaten-, Netzwerk-ACL-, Absender- oder Empfängerkonfiguration fehlt oder ist falsch.

Beheben: Prüfen Sie die SMTP-Zugangsdaten-, ACL-, Absender- und Empfängereinstellungen.

Der Prompt wartet auf Benutzereingabe

Problem: Der Prompt wartet auf die Benutzereingabe.

Wahrscheinliche Ursache: Ein Vorgesetzter oder Mitarbeiter hat eine menschliche Bestätigung angefordert.

Beheben: Setzen Sie dieselbe Unterhaltung mit den angeforderten Informationen fort.

Muster für sequenziellen Workflow und Vorgesetzten vergleichen

Wählen Sie das entsprechende Muster für das Select AI-Agentteam aus, je nachdem, wie das Team Mitarbeiter auswählen und Aufgaben koordinieren muss.

Wählen Sie das sequenzielle Workflowmuster aus, wenn das Team konfigurierte Agent-Task-Paare in einer bekannten Reihenfolge ausführen muss. Wählen Sie das Vorgesetztenmuster aus, wenn das Team Mitarbeiter zur Laufzeit basierend auf Anforderung, Zwischenergebnissen, Fehlern oder Anfragen nach weiteren Informationen auswählen muss.

Eigenschaft Sequenzielles Workflowmuster Vorgesetztenmuster
Plan ausführen Behoben. Das Array agents definiert die Workflowreihenfolge. Variable. Der Vorgesetzte wählt den nächsten Mitarbeiter zur Laufzeit aus.
Einstiegspunkt Das erste konfigurierte Agent-Task-Paar. Der Supervisor-Agent.
Aufgabenauswahl Das Team führt konfigurierte Agent-Aufgabenpaare in der Reihenfolge aus. Der Vorgesetzte ruft bei Bedarf einen oder mehrere Mitarbeiter an.
Kontextübergabe Aufgabenabhängigkeiten übergeben die vorherige Aufgabenausgabe an nachgelagerte Aufgaben. Der Vorgesetzte sendet jedem Mitarbeiter eine eigenständige Unteraufgabe.
Am besten geeignet für Vorhersehbare Pipelines mit bekannten Phasen. Variable Anforderungen, die bedingtes Routing oder Koordination erfordern.
Parallele Ausführungen Nicht unterstützt. Aufgaben werden nacheinander ausgeführt. Nicht unterstützt. Mitarbeiterunteraufgaben werden nacheinander ausgeführt.

Die folgende Tabelle enthält Unterschiede zwischen dem Muster "Sequenziell" und dem Muster "Supervisor", die Sie bei der Auswahl Ihres Workflows unterstützen können.

Sequenzmuster Vorgesetztenmuster
Fester Workflow Dynamische Orchestrierung
Jeder Schritt wird in der richtigen Reihenfolge ausgeführt Nur die erforderlichen Schritte werden ausgeführt
Gut für lineare Rohrleitungen Geeignet für Verzweigungen von Unternehmensanforderungen
Weniger Entscheidungslogik Weniger manuelle Routinglogik, mehr Laufzeitbewertung