Testen Sie einen Amazon Bedrock-Agenten

Nachdem Sie einen Agenten erstellt haben, erhalten Sie einen funktionierenden Entwurf. Der Arbeitsentwurf ist eine Version des Agenten, mit der Sie den Agenten iterativ entwickeln können. Jedes Mal, wenn Sie Änderungen an Ihrem Agenten vornehmen, wird der Arbeitsentwurf aktualisiert. Wenn Sie mit den Konfigurationen Ihres Agenten zufrieden sind, können Sie eine Version erstellen, die ein Snapshot Ihres Agenten ist, und einen Alias, der auf die Version verweist. Anschließend können Sie Ihren Agenten in Ihren Anwendungen einsetzen, indem Sie den Alias aufrufen. Weitere Informationen finden Sie unter Stellen Sie einen Amazon Bedrock-Agenten bereit.

In der folgenden Liste wird beschrieben, wie Sie Ihren Agenten testen:

• In der Amazon Bedrock-Konsole öffnen Sie das Testfenster an der Seite und senden Eingaben, auf die Ihr Agent antworten kann. Sie können den Arbeitsentwurf oder eine von Ihnen erstellte Version auswählen.

• In der API ist der Arbeitsentwurf die DRAFT Version. Sie senden Eingaben an Ihren Agenten, indem Sie InvokeAgentden Test-Alias oder einen anderen Alias verwendenTSTALIASID, der auf eine statische Version verweist.

Um das Verhalten Ihres Agenten zu beheben, bietet Agents for Amazon Bedrock die Möglichkeit, den Trace während einer Sitzung mit Ihrem Agenten einzusehen. Die Ablaufverfolgung zeigt den step-by-step Argumentationsprozess des Agenten. Weitere Informationen zur Ablaufverfolgung finden Sie unterEreignisse in Amazon Bedrock verfolgen.

Im Folgenden finden Sie die Schritte zum Testen Ihres Agenten. Wählen Sie die Registerkarte aus, die der Methode Ihrer Wahl entspricht, und folgen Sie den Schritten.

Console

Um einen Agenten zu testen

1. Melden Sie sich bei der Rolle AWS Management Console Using an IAM mit Amazon Bedrock-Berechtigungen an und öffnen Sie die Amazon Bedrock-Konsole unter https://console.aws.amazon.com/bedrock/.

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

3. Wählen Sie im Abschnitt Agenten aus der Agentenliste den Link für den Agenten aus, den Sie testen möchten.

4. Das Testfenster wird in einem Bereich auf der rechten Seite angezeigt.

   Anmerkung

   Wenn das Testfenster geschlossen ist, können Sie es erneut öffnen, indem Sie oben auf der Seite mit den Agentendetails oder einer beliebigen Seite darin die Option Test auswählen.

5. Nachdem Sie einen Agenten erstellt haben, müssen Sie ihn mit den Änderungen am Arbeitsentwurf verpacken, indem Sie ihn auf eine der folgenden Arten vorbereiten:

   • Wählen Sie im Testfenster die Option Vorbereiten aus.

   • Wählen Sie auf der Seite Arbeitsentwurf oben auf der Seite die Option Vorbereiten aus.

   Anmerkung

   Jedes Mal, wenn Sie den Arbeitsentwurf aktualisieren, müssen Sie den Agenten darauf vorbereiten, den Agenten mit Ihren neuesten Änderungen zu verpacken. Als bewährte Methode empfehlen wir, dass Sie im Bereich Agentenübersicht auf der Seite Arbeitsentwurf immer die Uhrzeit der letzten Vorbereitung Ihres Agenten überprüfen, um sicherzustellen, dass Sie Ihren Agenten mit den neuesten Konfigurationen testen.

6. Verwenden Sie das Dropdownmenü oben im Testfenster, um einen Alias und die zugehörige Version für den Test auszuwählen. Standardmäßig ist die Kombination TestAlias: Arbeitsentwurf ausgewählt.

7. (Optional) Wenn Sie Provisioned Throughput für Ihren Alias auswählen möchten, gibt der Text unter dem ausgewählten Test-Alias Using ODT oder Using PT an. Um ein Modell für bereitgestellten Durchsatz zu erstellen, wählen Sie Ändern aus. Weitere Informationen finden Sie unter Bereitgestellter Durchsatz für Amazon Bedrock.

8. Um den Agenten zu testen, geben Sie eine Nachricht ein und wählen Sie Ausführen. Während Sie auf die Generierung der Antwort warten oder nachdem sie generiert wurde, haben Sie die folgenden Optionen:

   • Um Details zu jedem Schritt des Orchestrierungsprozesses des Agenten anzuzeigen, einschließlich der Aufforderung, der Inferenzkonfigurationen und des Argumentationsprozesses des Agenten für jeden Schritt und der Verwendung seiner Aktionsgruppen und Wissensdatenbanken, wählen Sie Trace anzeigen. Die Ablaufverfolgung wird in Echtzeit aktualisiert, sodass Sie sie einsehen können, bevor die Antwort zurückgegeben wird. Um die Ablaufverfolgung für einen Schritt zu erweitern oder zu reduzieren, wählen Sie einen Pfeil neben einem Schritt aus. Weitere Informationen zum Trace-Fenster und zu den angezeigten Details finden Sie unterEreignisse in Amazon Bedrock verfolgen.

   • Wenn der Agent eine Wissensdatenbank aufruft, enthält die Antwort Fußnoten. Um den Link zum S3-Objekt anzuzeigen, das die zitierten Informationen für einen bestimmten Teil der Antwort enthält, wählen Sie die entsprechende Fußnote aus.

   • Wenn Sie Ihren Agenten so einstellen, dass er die Kontrolle zurückgibt, anstatt eine Lambda-Funktion für die Bearbeitung der Aktionsgruppe zu verwenden, enthält die Antwort die vorhergesagte Aktion und ihre Parameter. Geben Sie einen Beispielausgabewert aus der API oder Funktion für die Aktion ein und wählen Sie dann Submit, um eine Agentenantwort zu generieren. In der folgenden Abbildung finden Sie ein Beispiel:

     

   Im Testfenster können Sie die folgenden Aktionen ausführen:

   • Um eine neue Konversation mit dem Agenten zu beginnen, wählen Sie das Aktualisierungssymbol.

   • Um das Trace-Fenster anzuzeigen, wählen Sie das Erweiterungssymbol aus. Um das Trace-Fenster zu schließen, wählen Sie das Symbol zum Verkleinern.

   • Um das Testfenster zu schließen, wählen Sie das Rechtspfeilsymbol.

Sie können Aktionsgruppen und Wissensdatenbanken aktivieren oder deaktivieren. Verwenden Sie diese Funktion, um Fehler bei Ihrem Agenten zu beheben, indem Sie isolieren, welche Aktionsgruppen oder Wissensdatenbanken aktualisiert werden müssen, indem Sie das Verhalten des Agenten anhand verschiedener Einstellungen bewerten.

Um eine Aktionsgruppe oder Wissensdatenbank zu aktivieren

1. Melden Sie sich bei der Rolle AWS Management Console Using an IAM mit Amazon Bedrock-Berechtigungen an und öffnen Sie die Amazon Bedrock-Konsole unter https://console.aws.amazon.com/bedrock/.

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

3. Wählen Sie im Abschnitt Agenten den Link für den Agenten, den Sie testen möchten, aus der Agentenliste aus.

4. Wählen Sie auf der Detailseite des Agenten im Abschnitt Arbeitsentwurf den Link für den Arbeitsentwurf aus.

5. Zeigen Sie im Abschnitt Aktionsgruppen oder Wissensdatenbanken mit der Maus auf den Status der Aktionsgruppe oder Wissensdatenbank, deren Status Sie ändern möchten.

6. Es wird eine Schaltfläche zum Bearbeiten angezeigt. Wählen Sie das Bearbeitungssymbol und wählen Sie dann aus dem Dropdownmenü aus, ob die Aktionsgruppe oder Wissensdatenbank Aktiviert oder Deaktiviert ist.

7. Wenn eine Aktionsgruppe deaktiviert ist, verwendet der Agent die Aktionsgruppe nicht. Wenn eine Wissensdatenbank deaktiviert ist, verwendet der Agent die Wissensdatenbank nicht. Aktivieren oder deaktivieren Sie Aktionsgruppen oder Wissensdatenbanken und verwenden Sie dann das Testfenster, um Fehler bei Ihrem Agenten zu beheben.

8. Wählen Sie Vorbereiten, um die Änderungen, die Sie am Agenten vorgenommen haben, zu übernehmen, bevor Sie ihn testen.

API

Bevor Sie Ihren Agenten zum ersten Mal testen, müssen Sie ihn mit den Arbeitsentwürfen verpacken, indem Sie eine PrepareAgentAnfrage (siehe Link für Anfrage- und Antwortformate und Felddetails) mit einem Build-Time-Endpunkt für Agents for Amazon Bedrock senden. Fügen Sie das agentId in die Anfrage ein. Die Änderungen gelten für die DRAFT Version, auf die der TSTALIASID Alias verweist.

Siehe Codebeispiele

Anmerkung

Jedes Mal, wenn Sie den Arbeitsentwurf aktualisieren, müssen Sie den Agenten darauf vorbereiten, den Agenten mit Ihren neuesten Änderungen zu verpacken. Als bewährte Methode empfehlen wir, dass Sie eine GetAgentAnfrage (siehe Link für Anfrage- und Antwortformate und Felddetails) mit einem Build-Time-Endpunkt für Agents for Amazon Bedrock senden und die Zeit überprüfen, zu der preparedAt Ihr Agent benötigt, um zu überprüfen, ob Sie Ihren Agenten mit den neuesten Konfigurationen testen.

Um Ihren Agenten zu testen, senden Sie eine InvokeAgentAnfrage (siehe Link für Anfrage- und Antwortformate und Felddetails) mit einem Runtime-Endpunkt für Agents for Amazon Bedrock.

Anmerkung

Das unterstützt AWS CLI InvokeAgentnicht.

Siehe Codebeispiele

Die Anfrage enthält die folgenden Felder:

• Geben Sie mindestens die folgenden Pflichtfelder an:

  Feld	Short description
  agentId	ID des Agenten
  agentAliasId	ID des Alias. Wird verwendetTSTALIASID, um die DRAFT Version aufzurufen
  sessionId	Alphanumerische ID für die Sitzung (2—100 Zeichen)
  Text eingeben	Die Benutzeraufforderung, die an den Agenten gesendet werden soll

• Die folgenden Felder sind optional:

  Feld	Short description
  Trace aktivieren	Geben Sie anTRUE, ob der Trace angezeigt werden soll.
  Sitzung beenden	Geben Sie TRUE an, dass die Sitzung mit dem Agenten nach dieser Anfrage beendet werden soll.
  Sitzungsstatus	Schließt Kontext ein, der das Verhalten des Agenten oder das Verhalten von Wissensdatenbanken beeinflusst, die dem Agenten zugeordnet sind. Weitere Informationen finden Sie unter Sitzungskontext steuern.

Die Antwort wird in einem Event-Stream zurückgegeben. Jedes Ereignis enthält einechunk, die einen Teil der Antwort im bytes Feld enthält, der dekodiert werden muss. Wenn der Agent eine Wissensdatenbank abgefragt hat, beinhaltet dies auch. chunk citations Die folgenden Objekte können ebenfalls zurückgegeben werden:

• Wenn Sie eine Ablaufverfolgung aktiviert haben, wird auch ein trace Objekt zurückgegeben. Wenn ein Fehler auftritt, wird ein Feld mit der Fehlermeldung zurückgegeben. Weitere Hinweise zum Lesen der Ablaufverfolgung finden Sie unterEreignisse in Amazon Bedrock verfolgen.