Gründen einer Zusammenarbeit mehrerer Agenten - Amazon Bedrock

Gründen einer Zusammenarbeit mehrerer Agenten

Die Gründung einer Zusammenarbeit mehrerer Agenten umfasst die folgenden Schritte:

  1. Erstellen Sie Partner-Agenten und stellen Sie sie bereit. Achten Sie darauf, den jeweiligen Partner-Agenten so zu konfigurieren, dass eine bestimmte Aufgabe im Arbeitsablauf der Zusammenarbeit mehrerer Agenten implementiert wird.

  2. Erstellen Sie einen neuen Vorgesetzten-Agenten oder weisen Sie einem vorhandenen Agenten die Rolle des Vorgesetzten zu. Wenn Sie einen neuen Vorgesetzten-Agenten erstellen oder einen vorhandenen Agenten als Vorgesetzten-Agenten kennzeichnen, können Sie auch festlegen, wie der Vorgesetzten-Agent Informationen mehrerer Partner-Agenten verarbeiten soll.

    Sie können dem Vorgesetzten-Agenten die Aufgabe zuweisen, die Antworten der Partner-Agenten zu koordinieren oder die Informationen an den entsprechenden Partner-Agenten weiterzuleiten, um die endgültige Antwort zu senden. Wenn Sie dem Vorgesetzten-Agenten die Aufgabe der Informationsweiterleitung zuweisen, wird die Latenz reduziert.

  3. Verknüpfen Sie die Aliasversion der Partner-Agenten mit dem Vorgesetzten-Agenten.

    Anmerkung

    Sie können einem Vorgesetzten-Agenten derzeit maximal 10 Partner-Agenten zuweisen.

  4. Bereiten Sie Ihr Team für die Zusammenarbeit mehrerer Agenten vor und testen Sie es.

  5. Stellen Sie den Vorgesetzten-Agenten bereit und rufen Sie ihn auf.

Sie können die Zusammenarbeit mehrerer Agenten in der Amazon-Bedrock-Konsole mithilfe der APIs, der AWS-CLI oder des AWS SDK generieren. Um zu erfahren, wie Sie eine Zusammenarbeit mehrerer Agenten generieren, wählen Sie die Registerkarte für Ihre bevorzugte Methode aus und führen Sie dann die folgenden Schritte durch.

Console
Schritt 1: Erstellen von Partner-Agenten
Schritt 2: Erstellen eines neuen Vorgesetzten-Agenten oder Zuweisen der Vorgesetzten-Rolle zu einem vorhandenen Agenten

  1. Wenn Sie einen neuen Vorgesetzten-Agenten erstellen, führen Sie die Anleitungen unter Manuelles Erstellen und Konfigurieren von Agenten aus und fahren Sie dann mit dem nächsten Schritt fort.

    Wenn Sie bereits einen Agenten konfiguriert haben und ihm die Vorgesetzten-Rolle zuweisen möchten, fahren Sie mit dem nächsten Schritt fort.

  2. Wenn Sie sich nicht bereits im Agent Builder befinden, gehen Sie wie folgt vor:

    1. Melden Sie sich bei der AWS-Managementkonsole mit einer IAM-Identität an, die zur Verwendung der Amazon-Bedrock-Konsole berechtigt ist. Öffnen Sie dann die Amazon-Bedrock-Konsole unter https://console.aws.amazon.com/bedrock.

    2. Wählen Sie im linken Navigationsbereich die Option Agenten aus. Wählen Sie im Abschnitt Agenten einen Agenten aus.

    3. Wählen Sie In Agent Builder bearbeiten aus.

    4. Scrollen Sie im Agent Builder nach unten zum Abschnitt Zusammenarbeit mehrerer Agenten und wählen Sie Bearbeiten aus.

  3. Aktivieren Sie auf der Seite Zusammenarbeit mehrerer Agenten im Abschnitt Status der Zusammenarbeit die Option Zusammenarbeit mehrerer Agenten. Hierdurch wird der Agent als Vorgesetzten-Agent identifiziert.

  4. Legen Sie im Bereich Konfiguration der Zusammenarbeit fest, wie der Vorgesetzten-Agent Informationen mehrerer Partner-Agenten verarbeiten soll, um die endgültige Antwort zu koordinieren.

    1. Wenn der Vorgesetzten-Agent die Antworten der Partner-Agenten koordinieren soll, wählen Sie Vorgesetzter aus.

    2. Wenn der Vorgesetzten-Agent Informationen an den entsprechenden Partner-Agenten zum Senden der endgültigen Antwort weiterleiten soll, wählen Sie Vorgesetzter mit Routing aus.

    3. Fahren Sie mit den nächsten Schritten fort, um Partner-Agenten hinzuzufügen.

Schritt 3: Hinzufügen von Partner-Agenten

  1. Erweitern Sie den Bereich Partner-Agent und geben Sie die Informationen zum Partner-Agenten ein, den Sie für die Zusammenarbeit mehrerer Agenten erstellt haben.

    1. Wählen Sie im Bereich Partner-Agent einen Partner-Agenten und dann in der Dropdown-Liste die Option Alias des Agenten aus. Sie können Anzeigen auswählen, um die Details des Partner-Agenten anzuzeigen.

    2. Geben Sie unter Name des Partners einen alternativen Namen für Ihren Partner-Agenten ein. Dieser Name ersetzt nicht den ursprünglichen Namen dieses Agenten.

    3. Geben Sie unter Anleitungen zur Zusammenarbeit die Details ein, wann dieser Partner vom Vorgesetzten-Agenten eingesetzt werden soll.

    4. (Optional) Aktivieren Sie die Option Gesprächsverlauf aktivieren, wenn der Vorgesetzten-Agent den Kontext aus früheren Gesprächen für diesen Partner-Agenten freigeben soll. Wenn diese Option aktiviert ist, bezieht der Vorgesetzte den vollständigen Verlauf der aktuellen Sitzung mit ein, unter anderem auch den Benutzereingabetext und die Antwort des Vorgesetzten-Agenten aus der jeweiligen Gesprächsrunde.

  2. Wählen Sie Partner hinzufügen aus, um diesen Partner-Agenten in Ihr Team für die Zusammenarbeit mehrerer Agenten aufzunehmen. Um weitere Partner-Agenten aufzunehmen, wiederholen Sie Schritt 1, bis Sie alle Partner-Agenten aufgenommen haben.

  3. Wenn Sie diesen Vorgang abgeschlossen haben, wählen Sie eine der folgenden Optionen aus:

    • Um bei der Zusammenarbeit mehrerer Agenten zu verbleiben, wählen Sie Speichern aus und fahren Sie mit dem nächsten Schritt fort, um Ihr Team für die Zusammenarbeit mehrerer Agenten vorzubereiten und es zu testen.

    • Um zur Seite Details zum Agenten zurückzukehren, wählen Sie Speichern und beenden aus.

Schritt 4: Vorbereiten und Testen einer Zusammenarbeit mehrerer Agenten
Schritt 5: Bereitstellen einer Zusammenarbeit mehrerer Agenten

  • Sie können die Zusammenarbeit mehrerer Agenten bereitstellen, indem Sie den Vorgesetzten-Agenten so einrichten, dass er die Anforderung InvokeAgent stellt.

API

Führen Sie die folgenden Schritte aus, um ein Team für die Zusammenarbeit mehrerer Agenten zu erstellen.

Schritt 1: Erstellen von Partner-Agenten
Schritt 2: Erstellen eines neuen Vorgesetzten-Agenten oder Zuweisen der Vorgesetzten-Rolle zu einem vorhandenen Agenten

  • Um einen neuen Vorgesetzten-Agenten zu erstellen, senden Sie die Anfrage CreateAgent (siehe Link für Anfrage- und Antwortformate und Felddetails) mit einem Build-Time-Endpunkt von Agenten für Amazon Bedrock.

    Um einem vorhandenen Agenten eine Vorgesetzten-Rolle zuzuweisen, senden Sie die Anfrage UpdateAgent mit einem Build-Time-Endpunkt von Agenten für Amazon Bedrock. Da alle Felder überschrieben werden, schließen Sie sowohl Felder ein, die Sie aktualisieren möchten, als auch Felder, die unverändert bleiben sollen.

    Sie müssen mindestens die folgenden Felder aufnehmen:

    Feld Anwendungsfall
    agentResourceRoleArn Um einen ARN der Servicerolle mit Berechtigungen zum Aufrufen von API-Operationen auf dem Agenten anzugeben
    foundationModel Um ein Basismodell (FM) anzugeben, mit dem der Agent orchestrieren soll
    instruction Um dem Agenten Anweisungen zu geben, was er tun soll Wird im $instructions$-Platzhalter der Prompt-Vorlage für die Orchestrierung verwendet.
    agentCollaboration

    Um dem Agenten die Vorgesetzten-Rolle zuzuweisen.

    Geben Sie SUPERVISOR an, wenn der Vorgesetzten-Agent die Antworten der Partner-Agenten koordinieren und die Antwort ausgeben soll.

    Geben Sie SUPERVISOR_ROUTER an, wenn der Vorgesetzten-Agent Informationen an den entsprechenden Partner-Agenten weiterleiten soll, um die endgültige Antwort zu senden.

    Dieses Feld ist standardmäßig auf DISABLED eingestellt.

    Die folgenden Felder sind optional:

    Feld Anwendungsfall
    description Beschreibt die Aufgaben des Agenten.
    idleSessionTTLInSeconds Dauer, nach der der Agent die Sitzung beendet und alle gespeicherten Informationen gelöscht werden.
    customerEncryptionKeyArn Der ARN eines KMS-Schlüssels zum Verschlüsseln von Agentenressourcen.
    tags Um die Tags zu Ihrem Agenten zuzuweisen.
    promptOverrideConfiguration Um die bei jedem Schritt der Orchestrierung an das FM gesendeten Prompts anzupassen.
    guardrailConfiguration Um dem Agenten einen Integritätsschutz hinzuzufügen. Geben Sie die ID oder den ARN des Integritätsschutzes und die zu verwendende Version an.
    clientToken Zur Sicherstellung, dass die API-Anfrage nur einmal durchgeführt wird. Weitere Informationen finden Sie unter Sicherstellen von Idempotenz.

    Die Antwort gibt das Objekt CreateAgent zurück, das Details zu Ihrem neu erstellten Vorgesetzten-Agenten enthält. Wenn der Agent nicht erstellt werden kann, gibt das Objekt CreateAgent in der Antwort eine Liste mit failureReasons und eine Liste mit recommendedActions aus, für die Sie eine Fehlerbehebung ausführen müssen.

Schritt 3: Hinzufügen von Partner-Agenten

  • Um die Partner-Agenten mit dem Vorgesetzten-Agenten zu verknüpfen, senden Sie die Anfrage AssociateAgentCollaborator (siehe Link für Anfrage- und Antwortformate und Felddetails) mit einem Build-Time-Endpunkt von Agenten für Amazon Bedrock.

    Sie müssen mindestens die folgenden Felder aufnehmen:

    Feld Anwendungsfall
    collaboratorName Zur Angabe eines alternativen Namens für den Partner-Agenten. Dieser Name wird nur in den Anleitungen zur Zusammenarbeit angezeigt und ersetzt nicht den ursprünglichen Namen des Agenten.
    agentDescriptor Zur Angabe des Agentenalias „Arn“.
    collaborationInstruction Um dem Partner-Agenten Anleitungen zu geben, was er tun soll.
    relayConversationHistory

    Wenn dieser Wert auf TO_COLLABORATOR festgelegt ist, gibt der Vorgesetzten-Agent den Kontext aus früheren Gesprächen für diesen Partner-Agenten frei.

    Zulässige Werte: TO_COLLABORATOR | DISABLED.
Schritt 4: Vorbereiten und Testen des Teams für die Zusammenarbeit mehrerer Agenten
Schritt 4: Bereitstellen des Teams für die Zusammenarbeit mehrerer Agenten

  • Sie können das Team für die Zusammenarbeit mehrerer Agenten bereitstellen, indem Sie den Vorgesetzten-Agenten so einrichten, dass er die Anforderung InvokeAgent stellt.