Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Testen des Verhaltens von Agenten und Beheben von Fehlern
Nachdem Sie einen Agenten erstellt haben, liegt ein *Arbeitsentwurf* vor. Dieser Arbeitsentwurf ist eine Version des Agenten, mit der Sie den Agenten iterativ entwickeln können. Jedes Mal, wenn Sie Änderungen am Agenten vornehmen, wird der Arbeitsentwurf aktualisiert. Wenn Sie mit den Konfigurationen des Agenten zufrieden sind, können Sie eine *Version* (also einen Snapshot des Agenten) und einen *Alias*, der auf die Version verweist, erstellen. Anschließend können Sie den Agenten in Ihren Anwendungen bereitstellen, indem Sie den Alias aufrufen. Weitere Informationen finden Sie unter [Bereitstellen und Verwenden eines Amazon-Bedrock-Agenten in Ihrer Anwendung](agents-deploy.md).
Im Folgenden wird beschrieben, wie Sie einen Agenten testen:
+ In der Amazon-Bedrock-Konsole: Öffnen Sie das Testfenster an der Seite und senden Sie eine Eingabe, auf die der Agent reagieren soll. Sie können entweder den Arbeitsentwurf oder eine von Ihnen erstellte Version auswählen.
+ In der API: Hier ist die `DRAFT`-Version der Arbeitsentwurf. Sie senden Eingaben an den Agenten, indem Sie [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) mit dem Test-Alias, `TSTALIASID` oder einem anderen Alias, der auf eine statische Version verweist, verwenden. Bevor Sie den Agenten testen können, müssen Sie ihn vorbereiten, indem Sie [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html) aufrufen.
## Nachverfolgen des Agentenverhaltens
Als Hilfe zur Behebung von Fehlern im Agentenverhalten bietet Agenten für Amazon Bedrock die Möglichkeit, die *Nachverfolgung* während einer Sitzung mit dem Agenten anzuzeigen. Die Nachverfolgung zeigt den Argumentationsprozess des Agenten schrittweise an. Weitere Informationen zur Nachverfolgung finden Sie unter [Verfolgen Sie den step-by-step Argumentationsprozess des Agenten mithilfe von Trace](trace-events.md).
## Testen des Agenten
Im Folgenden finden Sie Schritte zum Testen des Agenten. Wählen Sie die Registerkarte für Ihre bevorzugte Methode aus und befolgen Sie die angegebenen Schritte:
------
#### [ Console ]
**Testen Sie einen Agenten wie folgt:**
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](https://console.aws.amazon.com/bedrock).
1. Wählen Sie im linken Navigationsbereich die Option **Agenten** aus. Wählen Sie dann im Abschnitt **Agenten** einen Agenten aus.
1. Wählen Sie im Abschnitt **Agenten** aus der Agentenliste den Link für den Agenten aus, den Sie testen möchten.
1. Das Fenster **Testen** 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 **Testen** auswählen.
1. Nachdem Sie einen Agenten erstellt haben, müssen Sie ihn mit den Änderungen des Arbeitsentwurfs ausstatten, indem Sie ihn auf eine der folgenden Weisen vorbereiten:
+ Wählen Sie im Fenster **Testen** die Option **Vorbereiten** aus.
+ Wählen Sie oben auf der Seite **Arbeitsentwurf** die Option **Vorbereiten** aus.
**Anmerkung**
Jedes Mal, wenn Sie den Arbeitsentwurf aktualisieren, müssen Sie den Agenten darauf vorbereiten, ihn mit den aktuellen Änderungen auszustatten. Als Best Practice empfehlen wir, stets im Abschnitt **Agentenübersicht** auf der Seite **Arbeitsentwurf** die Angabe **Zuletzt vorbereitet** zu überprüfen, um sicherzugehen, dass Sie den Agenten mit den aktuellen Konfigurationen testen.
1. Verwenden Sie das Dropdown-Menü oben im **Testfenster**, um einen Alias und die zugehörige Version zum Testen auszuwählen. Standardmäßig ist die Kombination **TestAlias: Arbeitsentwurf** ausgewählt.
1. (Optional) Um „Bereitgestellter Durchsatz“ für Ihren Alias auszuwählen, wird unter dem ausgewählten Testalias entweder der Text **ODT wird verwendet …** oder der Text **PT wird verwendet …** angezeigt. Um ein „Bereitgestellter Durchsatz“-Modell zu erstellen, wählen Sie **Ändern** aus. Weitere Informationen finden Sie unter [Erhöhen Sie die Kapazität für den Modellaufruf mit Provisioned Throughput in Amazon Bedrock](prov-throughput.md).
1. (Optional) Um einen Prompt aus dem Prompt-Management zu verwenden, wählen Sie das Optionssymbol (![\[Vertical ellipsis icon representing a menu or more options.\]](http://docs.aws.amazon.com/de_de/bedrock/latest/userguide/images/icons/vertical-ellipsis.png)) im Meldungsfeld und anschließend **Prompt zum Importieren** aus. Wählen Sie den Prompt und die Version aus. Geben Sie Werte für die Prompt-Variablen im Abschnitt **Test-Variablenwerte** ein. Weitere Informationen zu Prompts im Prompt-Management finden Sie unter [Erstellen und Speichern wiederverwendbarer Prompts mit dem Prompt-Management in Amazon Bedrock](prompt-management.md).
1. Um den Agenten zu testen, geben Sie eine Nachricht ein und wählen Sie **Ausführen** aus. Während Sie auf die Generierung der Antwort warten oder nachdem diese generiert wurde, haben Sie die folgenden Optionen:
+ Um Details zu jedem Schritt des Orchestrierungsprozesses des Agenten anzuzeigen, einschließlich des Prompts, der Inferenzkonfigurationen und des Argumentationsprozesses des Agenten für jeden Schritt sowie der Verwendung seiner Aktionsgruppen und Wissensdatenbanken, wählen Sie **Nachverfolgung anzeigen** aus. Die Nachverfolgung wird in Echtzeit aktualisiert, sodass Sie sie einsehen können, bevor die Antwort zurückgegeben wird. Wählen Sie einen Pfeil neben einem Schritt aus, um die Nachverfolgung für diesen Schritt zu erweitern oder zu reduzieren. Weitere Informationen zum Fenster **Nachverfolgung** und zu den angezeigten Details finden Sie unter [Verfolgen Sie den step-by-step Argumentationsprozess des Agenten mithilfe von Trace](trace-events.md).
+ Ruft der Agent eine Wissensdatenbank auf, 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 den 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 deren Parameter. Geben Sie einen Beispielausgabewert aus der API oder der Funktion für die Aktion ein und wählen Sie dann **Senden** aus, um eine Agentenantwort zu generieren. Die folgenden Bilder dienen als Beispiel:
![\[Testfenster für Anfrage nach Beispielausgabe für die Aktion.\]](http://docs.aws.amazon.com/de_de/bedrock/latest/userguide/images/agents/roc-testwindow.png)
Im **Testfenster** können Sie die folgenden Aktionen ausführen:
+ Aktualisierungssymbol auswählen, um eine neue Konversation mit dem Agenten zu beginnen;
+ Erweiterungssymbol auswählen, um das Fenster **Nachverfolgung** anzuzeigen; Verkleinern-Symbol auswählen, um das Fenster **Nachverfolgung** zu schließen;
+ Rechtspfeil-Symbol auswählen, um das Fenster **Testen** zu schließen.
Sie können Aktionsgruppen und Wissensdatenbanken aktivieren oder deaktivieren. Verwenden Sie dieses Feature, um Agentenfehler zu beheben, indem durch die Bewertung des Agentenverhaltens anhand verschiedener Einstellungen die zu aktualisierenden Aktionen und Wissensdatenbanken isoliert werden.
**Aktivieren Sie eine Aktionsgruppe oder Wissensdatenbank wie folgt:**
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](https://console.aws.amazon.com/bedrock).
1. Wählen Sie im linken Navigationsbereich **Agenten** aus. Wählen Sie im Abschnitt **Agenten** einen Agenten aus.
1. Wählen Sie im Abschnitt **Agenten** aus der Agentenliste den Link für den Agenten aus, den Sie testen möchten.
1. Wählen Sie auf der Detailseite des Agenten im Abschnitt **Arbeitsentwurf** den Link für den **Arbeitsentwurf** aus.
1. Zeigen Sie im Abschnitt **Aktionsgruppen** oder **Wissensdatenbanken** mit der Maus auf den **Status** der Aktionsgruppe oder der Wissensdatenbank, deren Status Sie ändern möchten.
1. Es wird eine Schaltfläche zum Bearbeiten angezeigt. Klicken Sie darauf und wählen Sie dann aus dem Dropdown-Menü aus, ob die Aktionsgruppe oder Wissensdatenbank **Aktiviert** oder **Deaktiviert** ist.
1. 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 Fenster **Testen**, um Fehler beim Agenten zu beheben.
1. Wählen Sie **Vorbereiten** aus, um die am Agenten vorgenommenen Änderungen zu übernehmen, bevor Sie ihn testen.
------
#### [ API ]
Für Agenten, die `after` 31. März 2025 erstellt wurden:
+ Wenn Sie den Agenten in der Konsole erstellt haben, ist das Streaming standardmäßig aktiviert. Sie können das Streaming jederzeit deaktivieren.
+ Stellen Sie sicher, dass die Ausführungsrolle des Agenten die Berechtigung `bedrock:InvokeModelWithResponseStream` für das konfigurierte Agentenmodell umfasst.
Bevor Sie den Agenten zum ersten Mal testen, müssen Sie ihn mit den Arbeitsentwürfen ausstatten, indem Sie eine [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html)-Anfrage mit einem [Build-Time-Endpunkt für Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) senden. Fügen Sie der Anfrage die `agentId` hinzu. Die Änderungen gelten für die `DRAFT`-Version, auf die der Alias `TSTALIASID` verweist.
```
def prepare_agent(self, agent_id):
"""
Creates a DRAFT version of the agent that can be used for internal testing.
:param agent_id: The unique identifier of the agent to prepare.
:return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
"""
try:
prepared_agent_details = self.client.prepare_agent(agentId=agent_id)
except ClientError as e:
logger.error(f"Couldn't prepare agent. {e}")
raise
else:
return prepared_agent_details
```
Weitere Informationen finden Sie unter [Hallo Agenten für Amazon Bedrock](bedrock-agent_example_bedrock-agent_Hello_section.md).
**Anmerkung**
Jedes Mal, wenn Sie den Arbeitsentwurf aktualisieren, müssen Sie den Agenten darauf vorbereiten, ihn mit den aktuellen Änderungen auszustatten. Als Best Practice empfehlen wir, eine [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgent.html)-Anfrage (siehe Link für Anfrage- und Antwortformate sowie Felddetails) mit einem [Build-Time-Endpunkt für Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) zu senden und die `preparedAt`-Zeit zu überprüfen, die der Agent benötigt, um zu verifizieren, ob Sie den Agenten mit den neuesten Konfigurationen testen.
Um den Agenten zu testen, senden Sie eine [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html)-Anfrage an den Agenten. Einen Beispielcode finden Sie unter [Aufrufen eines Agenten über Ihre Anwendung](agents-invoke-agent.md).
**Anmerkung**
Die AWS CLI unterstützt [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) nicht.
Die Anfrage enthält folgende Felder:
+ Machen Sie mindestens die folgenden Angaben:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/bedrock/latest/userguide/agents-test.html)
+ Die folgenden Felder sind optional:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/bedrock/latest/userguide/agents-test.html)
Die Antwort wird in einem Ereignis-Stream zurückgegeben. Jedes Ereignis umfasst einen `chunk`, der einen Teil der Antwort im `bytes`-Feld enthält, der dekodiert werden muss. Die folgenden Objekte können ebenfalls zurückgegeben werden:
+ Wenn der Agent eine Wissensdatenbank abgefragt hat, beinhaltet der `chunk` auch `citations`.
+ Wenn das Streaming aktiviert und der Integritätsschutz für den Agenten konfiguriert ist, wird die Antwort in den für das Integritätsschutz-Intervall angegebenen Zeichenintervallen generiert. Standardmäßig ist das Intervall auf 50 Zeichen eingestellt.
+ Wenn Sie eine Nachverfolgung aktiviert haben, wird auch ein `trace`-Objekt zurückgegeben. Wenn ein Fehler auftritt, wird ein Feld mit der Fehlermeldung zurückgegeben. Weitere Informationen zum Interpretieren der Nachverfolgung finden Sie unter [Verfolgen Sie den step-by-step Argumentationsprozess des Agenten mithilfe von Trace](trace-events.md).
+ Wenn Sie Ihre Aktionsgruppe anhand einer Lambda-Funktion so einrichten, dass sie übersprungen wird, wird im Feld `returnControl` ein [ReturnControlPayload](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ReturnControlPayload.html)-Objekt zurückgegeben. Die allgemeine Struktur des Objekts [ReturnControlPayload](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ReturnControlPayload.html) sieht wie folgt aus:
```
{
"invocationId": "string",
"invocationInputs": [
[ApiInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ApiInvocationInput.html) or [FunctionInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FunctionInvocationInput.html),
...
]
}
```
Jedes Objekt der `invocationInputs`-Liste ist einer der folgenden Objektarten zugeordnet:
+ Ein [ApiInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ApiInvocationInput.html)-Objekt, das den API-Vorgang enthält, der laut Vorhersage des Agenten auf der Grundlage der Benutzereingabe aufgerufen werden sollte, zusätzlich zu den Parametern und weiteren vom Benutzer erhaltenen Informationen, um der API zu entsprechen. Struktur des [ApiInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ApiInvocationInput.html)-Objekts:
```
{
"actionGroup": "string",
"apiPath": "string",
"httpMethod": "string",
"parameters": [
{
"name": "string",
"type": "string",
"value": "string"
},
...
],
"requestBody": {
: {
"properties": [
{
"name": "string",
"type": "string",
"value": "string"
}
]
}
}
}
```
+ Es handelt sich um ein [FunctionInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FunctionInvocationInput.html)-Objekt, das die Funktion enthält, die laut Vorhersage des Agenten auf der Grundlage der Benutzereingabe aufgerufen werden sollte, zusätzlich zu den vom Benutzer erhaltenen Parametern für diese Funktion. Struktur von [FunctionInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FunctionInvocationInput.html):
```
{
"actionGroup": "string",
"function": "string",
"parameters": [
{
"name": "string",
"type": "string",
"value": "string"
}
]
}
```
------
# Verfolgen Sie den step-by-step Argumentationsprozess des Agenten mithilfe von Trace
Jede Antwort eines Agenten für Amazon Bedrock wird von einem *Trace* begleitet, die es Ihnen ermöglicht, Ereignisse zu den Schritten zu empfangen, die vom Agenten orchestriert werden. Mithilfe des Trace können Sie den Argumentationsprozess des Agenten verfolgen, der diesen zu der Antwort führt, die er zu diesem Zeitpunkt in der Konversation gibt.
Verwenden Sie den Trace, um den Pfad des Agenten von der Benutzereingabe bis zur zurückgegebenen Antwort nachzuverfolgen. Der Trace liefert Informationen zu den Eingaben in die Aktionsgruppen, die der Agent aufruft, und die Wissensdatenbanken, die er abfragt, um dem Benutzer zu antworten. Darüber hinaus stellt der Trace Informationen zu den Ausgaben bereit, die von den Aktionsgruppen und Wissensdatenbanken zurückgegeben werden. Sie können sich die Argumentation ansehen, anhand derer der Agent bestimmt, welche Aktion er ausführt, oder die Abfrage, die er an eine Wissensdatenbank stellt. Wenn ein Schritt im Trace fehlschlägt, gibt diese einen Grund für den Fehler zurück. Verwenden Sie die detaillierten Informationen im Trace, um Probleme mit Ihrem Agenten zu beheben. Sie können Schritte identifizieren, die beim Agent zu Problemen oder zu einem unerwarteten Verhalten führen. Anhand dieser Informationen können Sie dann überlegen, wie Sie das Verhalten des Agenten verbessern können.
# Anzeigen des Trace
Im Folgenden wird beschrieben, wie Sie den Trace anzeigen. Wählen Sie die Registerkarte für Ihre bevorzugte Methode und führen Sie die folgenden Schritte aus:
------
#### [ Console ]
**So zeigen Sie den Trace während einer Konversation mit einem Agenten an**
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](https://console.aws.amazon.com/bedrock).
1. Wählen Sie im Abschnitt **Agenten** aus der Agentenliste den Link für den Agenten aus, den Sie testen möchten.
1. Das Fenster **Testen** wird in einem Bereich auf der rechten Seite angezeigt.
1. Geben Sie eine Nachricht ein und wählen Sie **Ausführen** aus. Wählen Sie während der Generierung der Antwort oder nach Abschluss der Generierung die Option **Trace anzeigen** aus.
1. Sie können den Trace für jeden **Schritt** in Echtzeit anzeigen, während Ihr Agent die Orchestrierung durchführt.
------
#### [ API ]
Um den Trace anzuzeigen, senden Sie eine [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html)-Anfrage mit einem [Runtime-Endpunkt von Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt) und legen Sie das Feld `enableTrace` auf `TRUE` fest. Der Trace ist standardmäßig deaktiviert. Einen Beispielcode finden Sie unter [Aufrufen eines Agenten über Ihre Anwendung](agents-invoke-agent.md).
Wenn Sie den Trace aktivieren, wird in der [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html)-Antwort jedes `chunk`-Element im Stream von einem `trace`-Feld begleitet, das einem [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html)-Objekt zugeordnet ist. Im [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html) befindet sich ein `trace`-Feld, das einem [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Trace.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Trace.html)-Objekt zugeordnet ist.
------
## Struktur des Trace
Wenn Sie den Trace aktivieren, wird in der [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html)-Antwort jedes `chunk`-Element im Stream von einem `trace`-Feld begleitet, das einem [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html)-Objekt zugeordnet ist. Das `tracePart`-Objekt enthält Informationen zum Agenten und zu den Sitzungen sowie den Argumentationsprozess des Agenten und die Ergebnisse des Aufrufs von API-Funktionen.
```
{
"agentId": "string",
"agentName": "string",
"collaboratorName": "string",
"agentAliasId": "string",
"sessionId": "string",
"agentVersion": "string",
"trace": { ...},
"callerChain": [{
"agentAliasArn": "agent alias arn"
}]
}
```
Die folgende Liste beschreibt die Felder des [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html)-Objekts:
+ `agentId` – Die eindeutige Kennung des Agenten.
+ `agentName` – Der Name des Agenten.
+ `collaboratorName` – Wenn die Zusammenarbeit mehrerer Agenten aktiviert ist, der Name des Agenten.
+ `agentVersion` – Die Version des Agenten.
+ `agentAliasId` – Die eindeutige Kennung des Agenten.
+ `sessionId` – Die eindeutige Kennung der Sitzung mit den Agenten.
+ `trace` – Enthält den Argumentationsprozess des Agenten und die Ergebnisse des Aufrufs von API-Aktionen. Weitere Informationen hierzu finden Sie unten.
+ `callerChain` – Die Liste der Anrufer zwischen dem Agenten, der diesen Trace veröffentlicht hat, und dem Endbenutzer.
+ Wenn es sich um einen einzelnen Agenten handelt, enthält dieses Feld den Alias „Arn“ desselben Agenten, der den Trace veröffentlicht hat.
+ Wenn die Zusammenarbeit mehrerer Agenten aktiviert ist, enthält dieses Feld den Alias „Arn“ aller Agenten, die die Endbenutzeranforderung an den aktuellen Agenten weitergeleitet haben.
Im [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html) befindet sich ein `trace`-Feld, das einem [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Trace.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Trace.html)-Objekt zugeordnet ist. Der Trace wird sowohl in der Konsole als auch in der API als JSON-Objekt angezeigt. Jeder **Schritt** in der Konsole oder jede [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Trace.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Trace.html) in der API kann eine der folgenden Ablaufverfolgungen sein:
+ [PreProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingTrace.html)— Verfolgt die Eingabe und Ausgabe des Vorverarbeitungsschritts, in dem der Agent Benutzereingaben kontextualisiert und kategorisiert und feststellt, ob sie gültig sind.
+ [OrchestrationTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationTrace.html)— Verfolgt die Eingabe und Ausgabe des Orchestrierungsschritts, in dem der Agent die Eingabe interpretiert, Aktionsgruppen aufruft und Wissensdatenbanken abfragt. Dann gibt der Agent die Ausgabe zurück, um die Orchestrierung fortzusetzen oder dem Benutzer zu antworten.
+ [PostProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingTrace.html)— Verfolgt die Eingabe und Ausgabe des Nachbearbeitungsschritts, in dem der Agent die endgültige Ausgabe der Orchestrierung verarbeitet und bestimmt, wie die Antwort an den Benutzer zurückgegeben werden soll.
+ [CustomOrchestrationTrace](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent-runtime_CustomOrchestrationTrace.html)— Details zum benutzerdefinierten Orchestrierungsschritt, in dem der Agent die Reihenfolge bestimmt, in der Aktionen ausgeführt werden.
+ [RoutingClassifierTrace](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent-runtime_RoutingClassifierTrace.html)— Verfolgt die Eingabe und Ausgabe des Routing-Klassifikators
+ [FailureTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FailureTrace.html)— Verfolgt den Grund, warum ein Schritt fehlgeschlagen ist.
+ [GuardrailTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GuardrailTrace.html)— Zeichnet die Aktionen der Leitplanke nach.
Jede der Ablaufverfolgungen (außer`FailureTrace`) enthält ein [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html)-Objekt. Das [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html)-Objekt enthält neben dem Prompt, die dem Agenten in diesem Schritt zur Verfügung gestellt wird, Konfigurationen, die in der Prompt-Vorlage für den Schritt festgelegt sind. Weitere Informationen zum Ändern von Prompt-Vorlagen finden Sie unter [Verbessern der Korrektheit von Agenten mithilfe erweiterter Prompt-Vorlagen in Amazon Bedrock](advanced-prompts.md). Die Struktur des `ModelInvocationInput`-Objekts ist wie folgt:
```
{
"traceId": "string",
"text": "string",
"type": "PRE_PROCESSING | ORCHESTRATION | ROUTING_CLASSIFIER | KNOWLEDGE_BASE_RESPONSE_GENERATION | POST_PROCESSING",
"foundationModel":string",
"inferenceConfiguration": {
"maximumLength": number,
"stopSequences": ["string"],
"temperature": float,
"topK": float,
"topP": float
},
"promptCreationMode": "DEFAULT | OVERRIDDEN",
"parserMode": "DEFAULT | OVERRIDDEN",
"overrideLambda": "string"
}
```
Die folgende Liste beschreibt die Felder des [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html)-Objekts:
+ `traceId` – Die eindeutige Kennung des Trace.
+ `text` – Der Text aus dem Prompt, die dem Agenten in diesem Schritt zur Verfügung gestellt wurde.
+ `type` – Der aktuelle Schritt im Prozess des Agenten.
+ `foundationModel` – Das Basismodell des Collaborator-Agenten in der Zusammenarbeit mehrerer Agenten. Dieses Feld wird nur verwendet, wenn `type` auf `ROUTING_CLASSIFIER` festgelegt ist. Wenn das für die Weiterleitung des Prompts verwendete Standardmodell außer Kraft gesetzt wird, zeigt dieses Feld das Modell des Supervisor-Agenten, der für die Weiterleitung des Prompts verwendet wird.
+ `inferenceConfiguration` – Inferenzparameter, die die Antwortgenerierung beeinflussen. Weitere Informationen finden Sie unter [So beeinflussen Sie die Antwortgenerierung mit Inferenzparametern](inference-parameters.md).
+ `promptCreationMode` – Gibt an, ob die standardmäßige Prompt-Basisvorlage des Agenten für diesen Schritt außer Kraft gesetzt wurde oder nicht. Weitere Informationen finden Sie unter [Verbessern der Korrektheit von Agenten mithilfe erweiterter Prompt-Vorlagen in Amazon Bedrock](advanced-prompts.md).
+ `parserMode` – Gibt an, ob der standardmäßige Antwort-Parser des Agenten für diesen Schritt außer Kraft gesetzt wurde oder nicht. Weitere Informationen finden Sie unter [Verbessern der Korrektheit von Agenten mithilfe erweiterter Prompt-Vorlagen in Amazon Bedrock](advanced-prompts.md).
+ `overrideLambda` – Der Amazon-Ressourcenname (ARN) der Parser-Lambda-Funktion, die zum Analysieren der Antwort verwendet wird, falls der Standard-Parser außer Kraft gesetzt wurde. Weitere Informationen finden Sie unter [Verbessern der Korrektheit von Agenten mithilfe erweiterter Prompt-Vorlagen in Amazon Bedrock](advanced-prompts.md).
Weitere Informationen zu den einzelnen Trace-Typen finden Sie in den folgenden Abschnitten:
### PreProcessingTrace
```
{
"modelInvocationInput": { // see above for details }
"modelInvocationOutput": {
"metadata": {
"usage": {
"inputToken":: int,
"outputToken":: int
},
"rawResponse": {
"content": "string"
}
"parsedResponse": {
"isValid": boolean,
"rationale": "string"
},
"traceId": "string"
}
}
```
Das [PreProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingTrace.html)besteht aus einem [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html)Objekt und einem [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingModelInvocationOutput.html)Objekt. Die [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingModelInvocationOutput.html) enthält die folgenden Felder.
+ `metadata` – Enthält die folgenden Informationen zur Ausgabe des Basismodells.
+ `usage` – Enthält die folgenden Informationen zur Verwendung des Basismodells.
+ `inputTokens` – Enthält die Informationen zu den Eingabe-Token aus der Verwendung des Basismodells.
+ `outputTokens` – Enthält die Informationen zu den Ausgabe-Token aus der Verwendung des Basismodells.
+ `rawResponse` – Enthält die Rohausgabe des Basismodells.
+ `content` – Der Inhalt der Rohausgabe des Basismodells.
+ `parsedResponse` – Enthält die folgenden Details zur analysierten Benutzeraufforderung.
+ `isValid` – Gibt an, ob der Benutzer-Prompt gültig ist oder nicht.
+ `rationale` – Gibt die Argumentation des Agenten für die nächsten Schritte an.
+ `traceId` – Die eindeutige Kennung des Trace.
### OrchestrationTrace
Das [OrchestrationTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationTrace.html)besteht aus dem [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html)Objekt, dem [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html)Objekt und einer beliebigen Kombination der Objekte [Rationale [InvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvocationInput.html)](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rationale.html), und [Observation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html). Die [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html) enthält die folgenden Felder. Weitere Informationen zu den Objekten [Rationale](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rationale.html) und [Observation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html) erhalten Sie [InvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvocationInput.html), wenn Sie eine der folgenden Registerkarten auswählen.
```
{
"modelInvocationInput": { // see above for details },
"modelInvocationOutput": {
"metadata": {
"usage": {
"inputToken":: int,
"outputToken":: int
},
"rawResponse": {
"content": "string"
},
"rationale": { ... },
"invocationInput": { ... },
"observation": { ... }
}
```
Wenn der `type` auf `AGENT_COLLABORATOR` festgelegt und das Routing für den Vorgesetzten-Agenten aktiviert wurde, enthält [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html) die folgende Struktur:
```
routingClassifierModelInvocationOutput: {
traceId: "string",
rawResponse: "string",
routerClassifierParsedResponse: {...}
metadata: {
inputTokens: "..."
outputTokens: "..."
}
}
```
------
#### [ Rationale ]
Das [Rationale](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rationale.html)-Objekt enthält die Argumentation des Agenten anhand der Benutzereingabe. Im Folgenden finden Sie die Struktur:
```
{
"traceId": "string",
"text": "string"
}
```
Die folgende Liste beschreibt die Felder des [Rationale](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rationale.html)-Objekts:
+ `traceId` – Die eindeutige Kennung des Trace-Schritts.
+ `text` – Der Argumentationsprozess des Agenten, der auf dem Eingabe-Prompt basiert.
------
#### [ InvocationInput ]
Das [InvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvocationInput.html)-Objekt enthält Informationen, die in die Aktionsgruppe oder Wissensdatenbank eingegeben werden, die aufgerufen oder abgefragt werden soll. Im Folgenden finden Sie die Struktur:
```
{
"traceId": "string",
"invocationType": "AGENT_COLLABORATOR" | "ACTION_GROUP | KNOWLEDGE_BASE | FINISH",
"agentCollaboratorInvocationInput": {
// see below for details
},
"actionGroupInvocationInput": {
// see below for details
},
"knowledgeBaseLookupInput": {
"knowledgeBaseId": "string",
"text": "string"
}
}
```
Die folgende Liste beschreibt die Felder des [InvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvocationInput.html)-Objekts:
+ `traceId` – Die eindeutige Kennung des Trace.
+ `invocationType` – Gibt an, ob der Agent einen Collaborator-Agenten, eine Aktionsgruppe oder eine Wissensdatenbank aufruft oder die Sitzung beendet.
+ `agentCollaborationInvocationInput` – Enthält die Aufrufeingabe für die Collaborator-Agenten. Wird angezeigt, wenn `type` auf `AGENT_COLLABORATOR` festgelegt und das Routing für den Supervisor-Agenten aktiviert ist. Weitere Informationen finden Sie unter [Verwenden der Zusammenarbeit mehrerer Agenten mit Agenten für Amazon Bedrock](agents-multi-agent-collaboration.md).
+ Die `agentCollaborationInvocationInput `-Struktur lautet wie folgt:
```
{
"agentCollaboratorName": "string",
"agentCollaboratorAliasArn": "string",
"input": {
"text": "string"
}
}
```
Nachfolgend finden Sie Beschreibungen der Felder:
+ `agentCollaboratorName` – Der Name des Collaborator-Agenten, der dem Supervisor-Agenten zugeordnet ist.
+ `agentCollaboratorAliasArn` – Der Alias „Arn“ des Collaborator-Agenten, der die Antwort sendet.
+ `input` – Die Eingabezeichenfolge für den Collaborator-Agenten.
+ `actionGroupInvocationInput` – Wird angezeigt, wenn der `type` auf `ACTION_GROUP` festgelegt ist. Weitere Informationen finden Sie unter [Definieren von Aktionen in der Aktionsgruppe](action-define.md). Dabei kann es sich um eine der folgenden Strukturen handeln:
+ Wenn die Aktionsgruppe durch ein API-Schema definiert ist, sieht die Struktur wie folgt aus:
```
{
"actionGroupName": "string",
"apiPath": "string",
"verb": "string",
"parameters": [
{
"name": "string",
"type": "string",
"value": "string"
},
...
],
"requestBody": {
"content": {
"": [
{
"name": "string",
"type": "string",
"value": "string"
}
]
}
},
"executionType": "LAMBDA | RETURN_CONTROL",
"invocationId": "string"
}
```
Nachfolgend finden Sie Beschreibungen der Felder:
+ `actionGroupName` – Der Name der Aktionsgruppe, die laut Vorhersage des Agenten aufgerufen werden sollte.
+ `apiPath` – Der Pfad zur aufzurufenden API-Operation gemäß dem API-Schema.
+ `verb` – Die verwendete API-Methode gemäß dem API-Schema.
+ `parameters` – Enthält eine Liste von Objekten. Jedes Objekt enthält den Namen, den Typ und den Wert eines Parameters in der API-Operation, wie im API-Schema definiert.
+ `requestBody` – Enthält den Text der Anforderung und ihre Eigenschaften, wie im API-Schema definiert.
+ `executionType` – Gibt an, ob die Ausführung der Aktion an eine Lambda-Funktion (`LAMBDA`) übergeben wird oder ob die Steuerung durch die `InvokeAgent`-Antwort (`RETURN_CONTROL`) zurückgegeben wird. Weitere Informationen finden Sie unter [Verarbeiten der Ausführung der Aktion](action-handle.md).
+ `invocationId` – Der eindeutige Bezeichner des Aufrufs. Wird nur zurückgegeben, wenn `executionType` auf `RETURN_CONTROL` festgelegt ist.
+ Wenn die Aktionsgruppe durch Funktionsdetails definiert ist, sieht die Struktur wie folgt aus:
```
{
"actionGroupName": "string",
"function": "string",
"parameters": [
{
"name": "string",
"type": "string",
"value": "string"
},
...
],
"executionType": "LAMBDA | RETURN_CONTROL",
"invocationId": "string"
}
```
Nachfolgend finden Sie Beschreibungen der Felder:
+ `actionGroupName` – Der Name der Aktionsgruppe, die laut Vorhersage des Agenten aufgerufen werden sollte.
+ `function` – Der Name der Funktion, die laut Vorhersage des Agenten aufgerufen werden sollte.
+ `parameters` – Die Parameter der Funktion.
+ `executionType` – Gibt an, ob die Ausführung der Aktion an eine Lambda-Funktion (`LAMBDA`) übergeben wird oder ob die Steuerung durch die `InvokeAgent`-Antwort (`RETURN_CONTROL`) zurückgegeben wird. Weitere Informationen finden Sie unter [Verarbeiten der Ausführung der Aktion](action-handle.md).
+ `invocationId` – Der eindeutige Bezeichner des Aufrufs. Wird nur zurückgegeben, wenn `executionType` auf `RETURN_CONTROL` festgelegt ist.
+ `knowledgeBaseLookupInput` – Wird angezeigt, wenn der `type` auf `KNOWLEDGE_BASE` festgelegt ist. Weitere Informationen finden Sie unter [Abrufen von Daten und Generieren von KI-Antworten mit Wissensdatenbanken für Amazon Bedrock](knowledge-base.md). Enthält die folgenden Informationen über die Wissensdatenbank und die Suchabfrage für die Wissensdatenbank:
+ `knowledgeBaseId` – Die eindeutige Kennung der Wissensdatenbank, nach der der Agent sucht.
+ `text` – Die an die Wissensdatenbank gestellte Abfrage.
------
#### [ Observation ]
Das [Observation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html)-Objekt enthält das Ergebnis eines Agent-Partners, einer Aktionsgruppe oder Wissensdatenbank oder die Antwort an den Benutzer. Im Folgenden finden Sie die Struktur:
```
{
"traceId": "string",
"type": "AGENT_COLLABORATOR |ACTION_GROUP | KNOWLEDGE_BASE | REPROMPT | ASK_USER | FINISH",
"agentCollaboratorInvocationOutput": {
"agentCollaboratorName": "string",
"agentCollaboratorAliasArn": "string",
"output": {
"text": "string"
},
"actionGroupInvocation": {
"text": "JSON-formatted string"
},
"knowledgeBaseLookupOutput": {
"retrievedReferences": [
{
"content": {
"text": "string"
},
"location": {
"type": "S3",
"s3Location": {
"uri": "string"
}
}
},
...
]
},
"repromptResponse": {
"source": "ACTION_GROUP | KNOWLEDGE_BASE | PARSER",
"text": "string"
},
"finalResponse": {
"text"
}
}
```
Die folgende Liste beschreibt die Felder des [Observation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html)-Objekts:
+ `traceId` – Die eindeutige Kennung des Trace.
+ `type` – Gibt an, ob die Beobachtung des Agenten anhand des Ergebnisses eines Agent-Partners, einer Aktionsgruppe oder einer Wissensdatenbank zurückgegeben wird oder ob der Agent den Benutzer erneut auffordert, nach weiteren Informationen fragt oder das Gespräch beendet.
+ `agentCollaboratorInvocationOutput` – Enthält die Antwort des Collaborator-Agenten oder die endgültige Antwort. Wird angezeigt, wenn `type` auf `AGENT_COLLABORATOR` festgelegt und das Routing für den Supervisor-Agenten aktiviert ist. Weitere Informationen finden Sie unter [Verwenden der Zusammenarbeit mehrerer Agenten mit Agenten für Amazon Bedrock](agents-multi-agent-collaboration.md). Jede Ressource enthält die folgenden Felder:
+ `agentCollaboratorName` – Der Name des Collaborator-Agenten, der die Antwort sendet.
+ `agentCollaboratorAliasArn` – Der Alias „Arn“ des Collaborator-Agenten, der die Antwort sendet.
+ `output` – Enthält die Antwort, die vom Collaborator-Agenten gesendet wurde.
+ `actionGroupInvocationOutput` – Enthält die Zeichenfolge im JSON-Format, die von der API zurückgegeben wird, die von der Aktionsgruppe aufgerufen wurde. Erscheint, wenn der `type` `ACTION_GROUP` ist. Weitere Informationen finden Sie unter [Definieren von OpenAPI-Schemas für die Aktionsgruppen Ihres Agenten in Amazon Bedrock](agents-api-schema.md).
+ `knowledgeBaseLookupOutput` – Enthält aus der Wissensdatenbank abgerufenen Text, der für die Beantwortung des Prompts relevant ist, sowie den Amazon-S3-Speicherort der Datenquelle. Erscheint, wenn der `type` `KNOWLEDGE_BASE` ist. Weitere Informationen finden Sie unter [Abrufen von Daten und Generieren von KI-Antworten mit Wissensdatenbanken für Amazon Bedrock](knowledge-base.md). Jedes Objekt in der `retrievedReferences`-Liste enthält die folgenden Felder:
+ `content` – Enthält `text` aus der Wissensdatenbank, der aufgrund der Abfrage der Wissensdatenbank zurückgegeben wird.
+ `location` – Enthält den Amazon-S3-URI der Datenquelle, in der der zurückgegebene Text gefunden wurde.
+ `repromptResponse`: Erscheint, wenn der `type` `REPROMPT` ist. Enthält den `text`, der erneut nach einem Prompt fragt, zusammen mit der `source`, warum der Agent eine weitere Prompts ausgibt.
+ `finalResponse`: Erscheint, wenn der `type` `ASK_USER` oder `FINISH` ist. Enthält den `text`, der den Benutzer nach weiteren Informationen fragt oder eine Antwort an den Benutzer ist.
------
### PostProcessingTrace
```
{
"modelInvocationInput": { // see above for details }
"modelInvocationOutput": {
"rawResponse": {
"content": "string"
},
"metadata": {
"usage": {
"inputToken": int,
"outputToken": int
}
},
"parsedResponse": {
"text": "string"
},
"traceId": "string"
}
}
```
Das [PostProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingTrace.html)besteht aus einem [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html)Objekt und einem [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingModelInvocationOutput.html)Objekt. Die [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingModelInvocationOutput.html) enthält die folgenden Felder.
+ `rawResponse` – Enthält die Rohausgabe des Basismodells.
+ `content` – Der Inhalt der Rohausgabe des Basismodells.
+ `metadata` – Enthält die folgenden Informationen zur Ausgabe des Basismodells.
+ `usage` – Enthält die folgenden Informationen zur Verwendung des Basismodells.
+ `inputTokens` – Enthält die Informationen zu den Eingabe-Token aus der Verwendung des Basismodells.
+ `outputTokens` – Enthält die Informationen zu den Ausgabe-Token aus der Verwendung des Basismodells.
+ `parsedResponse` – Enthält den `text`, der nach der Verarbeitung durch die Parser-Funktion an den Benutzer zurückgegeben werden soll.
+ `traceId` – Die eindeutige Kennung des Trace.
### FailureTrace
```
{
"failureReason": "string",
"traceId": "string"
}
```
Die folgende Liste beschreibt die Felder des [FailureTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FailureTrace.html)-Objekts:
+ `failureReason` – Der Grund, warum der Schritt fehlgeschlagen ist.
+ `traceId` – Die eindeutige Kennung des Trace.
### GuardrailTrace
```
{
"action": "GUARDRAIL_INTERVENED" | "NONE",
"inputAssessments": [GuardrailAssessment],
"outputAssessments": [GuardrailAssessment]
}
```
Die folgende Liste beschreibt die Felder des GuardrailAssessment Objekts:
+ `action` – Gibt an, ob bei den Eingabedaten der Integritätsschutz eingegriffen hat oder nicht. Die Optionen lauten `GUARDRAIL_INTERVENED` oder `NONE`.
+ `inputAssessments` – Die Details der Bewertung des Integritätsschutzes hinsichtlich der Benutzereingabe.
+ `outputAssessments` – Die Details der Bewertung des Integritätsschutzes hinsichtlich der Antwort.
Weitere Informationen zum `GuardrailAssessment`-Objekt und zum Testen des Integritätsschutzes finden Sie unter [So testen Sie Ihren Integritätsschutz](guardrails-test.md).
GuardrailAssessment Beispiel:
```
{
"topicPolicy": {
"topics": [{
"name": "string",
"type": "string",
"action": "string"
}]
},
"contentPolicy": {
"filters": [{
"type": "string",
"confidence": "string",
"action": "string"
}]
},
"wordPolicy": {
"customWords": [{
"match": "string",
"action": "string"
}],
"managedWordLists": [{
"match": "string",
"type": "string",
"action": "string"
}]
},
"sensitiveInformationPolicy": {
"piiEntities": [{
"type": "string",
"match": "string",
"action": "string"
}],
"regexes": [{
"name": "string",
"regex": "string",
"match": "string",
"action": "string"
}]
}
}
```