

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 eines Flows in Amazon Bedrock
<a name="flows-test"></a>

Nachdem Sie einen Flow erstellt haben, erhalten Sie einen *Arbeitsentwurf*. Der Arbeitsentwurf ist eine Version des Flows, mit der Sie den Flow iterativ entwickeln und testen können. Jedes Mal, wenn Sie Änderungen an Ihrem Flow vornehmen, wird der Arbeitsentwurf aktualisiert.

Wenn Sie den Flow testen, verifiziert Amazon Bedrock zunächst folgende Punkte und löst eine Ausnahme aus, wenn die Verifizierung fehlschlägt:
+ Konnektivität zwischen allen Flow-Knoten ist gegeben.
+ Mindestens ein Flow-Ausgabeknoten ist konfiguriert.
+ Eingabe- und Ausgabevariablentypen werden nach Bedarf abgeglichen.
+ Bedingungsausdrücke sind gültig und es wird ein Standardergebnis bereitgestellt.

Schlägt die Verifizierung fehl, müssen Sie die Fehler beheben, bevor Sie die Leistung Ihres Flows testen und validieren können. Nachstehend finden Sie die Schritte zum Testen des Flows. Wählen Sie die Registerkarte für Ihre bevorzugte Methode aus und befolgen Sie dann die beschriebenen Schritte:

------
#### [ Console ]

**So testen Sie Ihren Flow**

1. Falls Sie sich noch nicht im **Flow-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](https://console.aws.amazon.com/bedrock).

   1. Wählen Sie **Amazon Bedrock Flows** im linken Navigationsbereich aus. Wählen Sie dann im Abschnitt **Amazon Bedrock Flows** einen Flow aus, den Sie testen möchten.

   1. Wählen Sie **Im Flow-Builder bearbeiten** aus.

1. Geben Sie auf der Seite **Flow-Builder** im rechten Bereich eine Eingabe ein, um den Flow aufzurufen. Vergewissern Sie sich, dass der Eingabedatentyp mit dem Ausgabedatentyp, den Sie für den Flow-Eingabeknoten konfiguriert haben, übereinstimmt.

1. Klicken Sie auf **Ausführen**.

1. Knoten oder Verbindungen in der Flow-Konfiguration, die Fehler auslösen, werden rot hervorgehoben, und Knoten oder Verbindungen, die Warnungen auslösen, sind gelb markiert. Lesen Sie die Fehlermeldungen und Warnungen, beheben Sie die identifizierten Probleme, speichern Sie den Flow und führen Sie den Test erneut aus.
**Anmerkung**  
Sie müssen den Flow speichern, damit die Änderungen, die Sie vorgenommen haben, beim Testen des Flows übernommen werden.

1. (Optional) Um die Eingaben, Ausgaben und die Ausführungsdauer für jeden Knoten anzuzeigen, wählen Sie in der Antwort die Option **Nachverfolgung anzeigen** aus. Weitere Informationen finden Sie unter [Verfolgen jedes Schritts im Flow durch Anzeigen der zugehörigen Nachverfolgung in Amazon BedrockVerfolgen jedes Schritts im Flow durch Anzeigen der zugehörigen Nachverfolgung](flows-trace.md). Um zum visuellen Builder zurückzukehren, wählen Sie **Nachverfolgung verbergen** oder klicken Sie auf das Symbol zum Ausblenden.

1. Wenn Sie mit der Leistung des Flows zufrieden sind, klicken Sie auf **Speichern und beenden**.

1. Sie können die Erstellung Ihres Flows weiter iterieren. Wenn Sie mit dem Ergebnis zufrieden und bereit sind, den Flow in der Produktionsumgebung bereitzustellen, erstellen Sie eine Version des Flows und einen Alias, der auf die Version verweist. Weitere Informationen finden Sie unter [Bereitstellen eines Flows in Ihrer Anwendung mithilfe von Versionen und Aliasen](flows-deploy.md).

------
#### [ API ]

Um den Flow zu testen, senden Sie eine [InvokeFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html)-Anfrage mit einem [Laufzeit-Endpunkt von Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). Geben Sie den ARN oder die ID des Flows in das Feld `flowIdentifier` und den ARN oder die ID des Alias, der verwendet werden soll, im Feld `flowAliasIdentifier` ein.

Um die Eingaben und Ausgaben für jeden Knoten anzuzeigen, setzen Sie das Feld `enableTrace` auf `TRUE`. Weitere Informationen finden Sie unter [Verfolgen jedes Schritts im Flow durch Anzeigen der zugehörigen Nachverfolgung in Amazon BedrockVerfolgen jedes Schritts im Flow durch Anzeigen der zugehörigen Nachverfolgung](flows-trace.md).

Der Anforderungstext spezifiziert die Eingabe für den Flow und besitzt das folgende Format:

```
{
   "inputs": [ 
      { 
         "content": { 
            "document": "JSON-formatted string"
         },
         "nodeName": "string",
         "nodeOutputName": "string"
      }
   ],
   "enableTrace": TRUE | FALSE
}
```

Geben Sie die Eingabe in das Feld `document` ein und geben Sie einen Namen für die Eingabe im Feld `nodeName` sowie im Feld `nodeOutputName` ein.

Die Antwort wird in einem Stream zurückgegeben. Jedes zurückgegebene Ereignis enthält die Ausgabe von einem Knoten im Feld `document`, den Knoten, der im Feld `nodeName` verarbeitet wurde, und den Knotentyp im Feld `nodeType`. Diese Ereignisse haben das folgende Format:

```
{
    "flowOutputEvent": { 
        "content": { 
            "document": "JSON-formatted string"
        },
        "nodeName": "string",
        "nodeType": "string"
    }
}
```

Wenn der Flow abgeschlossen ist, wird auch ein Feld `flowCompletionEvent` mit dem `completionReason` zurückgegeben. Falls ein Fehler auftritt, wird das entsprechende Fehlerfeld zurückgegeben.

------

# Verfolgen jedes Schritts im Flow durch Anzeigen der zugehörigen Nachverfolgung in Amazon Bedrock
<a name="flows-trace"></a>

Wenn Sie einen Flow aufrufen, können Sie die *Nachverfolgung* anzeigen, um die Eingaben und Ausgaben von jedem Knoten zu sehen. Mithilfe der Nachverfolgung können Sie den Weg von der Eingabe bis zur Antwort, die letztendlich zurückgegeben wird, verfolgen. Sie können die Nachverfolgung verwenden, um aufgetretene Fehler zu beheben, Schritte zu ermitteln, die zu unerwarteten Ergebnissen oder Leistungsengpässen führen, und Möglichkeiten zur Verbesserung des Flows in Betracht zu ziehen.

Um die Nachverfolgung anzuzeigen, gehen Sie wie folgt vor:
+ Folgen Sie in der Konsole den Schritten auf der Registerkarte **Konsole** unter [Testen eines Flows in Amazon Bedrock](flows-test.md) und wählen Sie in der Antwort vom Flow-Aufruf die Option **Nachverfolgung anzeigen** aus.
+ Setzen Sie in der API das Feld `enableTrace` auf `true` in einer [InvokeFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html)-Anfrage. Jedes `flowOutputEvent` in der Antwort wird zusammen mit einem `flowTraceEvent` zurückgegeben.

Jedes Nachverfolgungsereignis enthält den Namen des Knotens, der entweder eine Eingabe empfangen oder eine Ausgabe geliefert hat, sowie das Datum und die Uhrzeit der Verarbeitung der Ein- oder Ausgabe. Wählen Sie eine Registerkarte aus, um mehr über einen bestimmten Typ von Nachverfolgungsereignis zu erfahren.

------
#### [ FlowTraceConditionNodeResultEvent ]

Dieser Nachverfolgungstyp identifiziert, welche Bedingungen für einen Bedingungsknoten erfüllt sind, und hilft Ihnen, die Zweige des Flows zu ermitteln, die während des Aufrufs aktiviert wurden. Das folgende JSON-Objekt zeigt, wie ein [FlowTraceEvent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_FlowTraceEvent.html) für das Ergebnis eines Bedingungsknotens aussieht:

```
{
    "trace": {
        "conditionNodeOutputTrace": {
            "nodeName": "string",
            "satisfiedConditions": [
                {
                    "conditionName": "string"
                },
                ...
            ],
            "timestamp": timestamp
        }
    }
}
```

------
#### [ FlowTraceNodeInputEvent ]

Dieser Nachverfolgungstyp zeigt die Eingabe an, die an einen Knoten gesendet wurde. Wenn sich das Ereignis einem Iteratorknoten nachgelagert, aber einem Kollektorknoten vorgelagert befindet, gibt das Feld `iterationIndex` den Index des Elements in dem Array an, aus dem die Eingabe stammt. Das folgende JSON-Objekt zeigt, wie ein [FlowTraceEvent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_FlowTraceEvent.html) für die Eingabe in einen Knoten aussieht.

```
{
    "trace": {
        "nodeInputTrace": {
            "fields": [
                {
                    "content": {
                        "document": JSON object
                    },
                    "nodeInputName": "string"
                },
                ...
            ],
            "nodeName": "string",
            "timestamp": timestamp,
            "iterationIndex": int
        }
    }
}
```

------
#### [ FlowTraceNodeOutputEvent ]

Dieser Nachverfolgungstyp zeigt die Ausgabe an, die von einem Knoten erzeugt wurde. Wenn sich das Ereignis einem Iteratorknoten nachgelagert, aber einem Kollektorknoten vorgelagert befindet, gibt das Feld `iterationIndex` den Index des Elements in dem Array an, aus dem die Ausgabe stammt. Das folgende JSON-Objekt zeigt, wie ein [FlowTraceEvent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_FlowTraceEvent.html) für die Ausgabe eines Knotens aussieht.

```
{
    "trace": {
        "nodeOutputTrace": {
            "fields": [
                {
                    "content": {
                        "document": JSON object
                    },
                    "nodeOutputName": "string"
                },
                ...
            ],
            "nodeName": "string",
            "timestamp": timestamp,
            "iterationIndex": int
        }
    }
}
```

------