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. # Mit Flow-Ausführungen Amazon-Bedrock-Flows asynchron ausführen Mit Flow-Ausführungen können Sie Amazon-Bedrock-Flows asynchron ausführen. Auf diese Weise können Ihre Flows länger ausgeführt werden und Sie haben außerdem die Kontrolle darüber, so dass Ihre Anwendung andere Aufgaben ausführen kann. Wenn Sie einen Flow mithilfe der Amazon Bedrock-Konsole oder mit dem [InvokeFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html)Vorgang ausführen, wird der Flow ausgeführt, bis er abgeschlossen ist oder das Timeout nach einer Stunde abläuft (je nachdem, was zuerst eintritt). Wenn Sie eine Flow-Ausführung veranlassen, kann Ihr Flow viel länger laufen: Einzelne Knoten können bis zu fünf Minuten laufen. Ihr gesamter Flow kann bis zu 24 Stunden lang laufen. **Anmerkung** Flow-Ausführungen für Amazon Bedrock befinden sich in der Vorversion und unterliegen Änderungen. ## Erforderliche Berechtigungen für Flow-Ausführungen + Stellen Sie sicher, dass Ihre Servicerolle für Amazon-Bedrock-Flows über alle erforderlichen Berechtigungen verfügt. Weitere Informationen finden Sie unter [Erstellen einer Servicerolle für Amazon Bedrock Flows in Amazon Bedrock](flows-permissions.md). + (Optional) Verschlüsseln Sie Ihre Flow-Ausführungsdaten mit einem vom Kunden verwalteten Schlüssel. AWS KMS Weitere Informationen finden Sie unter [Verschlüsselung von Flow-Ressourcen von Amazon Bedrock](encryption-flows.md). ## Eine Flow-Ausführung erstellen und verwalten Sie können eine Flow-Ausführung in der Konsole oder mithilfe des [StartFlowExecution](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_StartFlowExecution.html)Vorgangs erstellen. ------ #### [ Console ] 1. Erstellen Sie einen Flow, indem Sie die Anleitungen unter [Einen Flow in Amazon Bedrock erstellen und gestalten](flows-create.md) befolgen. 1. Erstellen Sie einen Alias für den Flow, indem Sie die Anleitungen unter [Einen Alias eines Flows in Amazon Bedrock erstellen](flows-alias-create.md) befolgen. 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 berechtigt ist, die Amazon Bedrock-Konsole zu verwenden. Ö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 und anschließend Ihren Flow aus. 1. Wählen Sie die Registerkarte **Ausführungen** und dann **Ausführung erstellen** aus. 1. Geben Sie im Dialogfeld **Ausführung erstellen** Folgendes ein: 1. Geben Sie unter **Name** einen Namen für die Flow-Ausführung ein. 1. Wählen Sie unter **Alias auswählen** den Alias des Flows aus, den Sie verwenden möchten. 1. Geben Sie unter **Prompt-Eingabe** den Prompt ein, mit dem Sie den Flow starten möchten. 1. Wählen Sie **Erstellen** aus, um die Flow-Ausführung zu erstellen und zu starten. 1. Wählen Sie auf der Seite mit den Flow-Details die Registerkarte **Ausführungen** aus und notieren Sie sich den Status der Flow-Ausführung unter **Ausführungsstatus**. 1. (Optional) Wählen Sie eine Ausführung aus, um den Flow zu öffnen und die Zusammenfassung der Ausführung anzuzeigen. Unter **Ausführungsausgabe** sehen Sie die Ausgabe des Flows. 1. (Optional) Um eine Flow-Ausführung zu stoppen, wählen Sie die Ausführung aus und klicken Sie auf **Stoppen**. ------ #### [ API ] **Eine Flow-Ausführung starten** Um eine Flow-Ausführung auszuführen, senden Sie eine [StartFlowExecution](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_StartFlowExecution.html)Anfrage mit einem [Runtime-Endpunkt von Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). Geben Sie in der Anfrage die Flow-ID und die Flow-Alias-ID des Flows an, den Sie ausführen möchten. Sie können auch Folgendes angeben: + **inputs**: Ein Array, das den [Eingabe](flows-nodes.md#flows-nodes-input)-Knoten enthält, von dem aus der Flow ausgeführt werden soll. Sie geben im Feld `content` die Eingabe an, die an den Eingabeknoten des Prompt-Flows gesendet werden soll. + **name**: Ein Name für die Flow-Ausführung. ``` { "inputs": [{ "nodeName": "FlowInputNode", "nodeOutputName": "document", "content": { "document": "Test" } }], "name": "MyExecution" } ``` Die Antwort ist der Amazon-Ressourcenname (ARN) der Flow-Ausführung. Sie können den `executionArn` verwenden, um den aktuellen Status des Flows abzufragen, z. B. wenn die Flow-Ausführung abgeschlossen ist oder ein Bedingungsknoten seine Bedingungen bewertet. ``` { "executionArn": "arn:aws:bedrock:us-west-2:111122223333:flow/FLOWID/alias/TSTALIASID/execution/MyExecution" } ``` **Den Fortschritt einer Flow-Ausführung verfolgen** Verwenden Sie den [GetFlowExecution](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GetFlowExecution.html)Vorgang, um den aktuellen Status eines Flows abzurufen, den Sie anhand seines Ausführungs-ARN identifizieren. Ein Flow-Status lautet entweder `Running`, `Succeeded`, `Failed`, `TimedOut` oder `Aborted`. ``` { "endedAt": null, "errors": null, "executionArn": "arn:aws:bedrock:us-west-2:111122223333:flow/FLOWID/alias/TSTALIASID/execution/MyExecution", "flowAliasIdentifier": "TSTALIASID", "flowIdentifier": "FLOWID", "flowVersion": "DRAFT", "startedAt": "2025-03-20T23:32:28.899221162Z", "status": "Running" } ``` Fehler (z. B. ein Lambda-Knoten mit Zeitüberschreitung) werden im Array `errors` zurückgegeben, wie im folgenden Beispiel gezeigt: ``` "errors": [{ "nodeName": "LambdaNode1", "errorType": "ExecutionTimedOut", "message": "Call to lambda function timed out" }], ``` **Die Ergebnisse einer Flow-Ausführung abrufen** Amazon Bedrock schreibt die Ausgaben eines Flows in die [Ausgabe](flows-nodes.md#flows-nodes-output)-Knoten des Flows. Sie können die Ausgaben abrufen, sobald der Flow abgeschlossen ist oder solange der Flow läuft (abhängig von Ihrem Anwendungsfall). Wenn Sie möchten, dass der Flow zuerst abgeschlossen wird, rufen Sie `GetFlowExecution` auf und stellen Sie sicher, dass der Wert des Felds `status` in der Antwort `Succeeded` lautet. Rufen Sie auf, um eine Liste der Ausgabeereignisse der Flow-Ausführung abzurufen [ListFlowExecutionEvents](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ListFlowExecutionEvents.html). Suchen Sie in der Antwort nach `flowOutputEvent`-Objekten in `flowExecutionEvents`. Sie können die Ausgabe eines Flows beispielsweise im Feld `content` abrufen: ``` { "flowOutputEvent": { "content": { "document": "The model response." }, "nodeName": "FlowOutputNode" } } ``` Sie können die Ausgabe von `ListFlowExecutions` auf Eingabe- und Ausgabeknoten beschränken, indem Sie den Abfrageparameter `eventType` auf `Flow` setzen. **Anzeigen von Ereignissen** Um Ihnen das Debuggen Ihrer Flow-Ausführung zu erleichtern, können Sie den [ListFlowExecutionEvents](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ListFlowExecutionEvents.html)Vorgang verwenden, um Ereignisse anzuzeigen, die Knoten während der Ausführung des Flows generieren. Legen Sie den `eventType`-Abfrageparameter auf `Node` fest, um die Eingaben und Ausgaben aller Knoten (einschließlich Zwischenknoten) in der Antwort anzuzeigen, die dem folgenden Beispiel ähnelt: ``` { "flowExecutionEvents": [{ "nodeOutputEvent": { "fields": [{ "content": { "document": "History book" }, "name": "document" }], "nodeName": "FlowInputNode", "timestamp": "2025-05-05T18:38:56.637867516Z" } }, { "nodeInputEvent": { "fields": [{ "content": { "document": "History book" }, "name": "book" }], "nodeName": "Prompt_1", "timestamp": "2025-05-05T18:38:57.434600163Z" } }, { "nodeOutputEvent": { "fields": [{ "content": { "document": "Here's a summary of the history book." }, "name": "modelCompletion" }], "nodeName": "Prompt_1", "timestamp": "2025-05-05T18:39:06.034157077Z" } }, { "nodeInputEvent": { "fields": [{ "content": { "document": "Here's a summary of the history book." }, "name": "document" }], "nodeName": "FlowOutputNode", "timestamp": "2025-05-05T18:39:06.453128251Z" } } ] } ``` **Einen Snapshot Ihrer Flow-Ausführung erfassen** Beim Starten einer Flow-Ausführung erstellt Amazon Bedrock automatisch einen Snapshot einer Flow-Definition und von Metadaten. Das ist hilfreich, da ein Flow aktualisiert werden kann, während er asynchron ausgeführt wird. Rufen Sie den [GetExecutionFlowSnapshot](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GetExecutionFlowSnapshot.html)Vorgang auf, um diesen Snapshot abzurufen. Die Antwort enthält die folgenden Felder: + **customerEncryptionKeyArn** — Der ARN des AWS KMS Schlüssels, der den Flow verschlüsselt. + **definition**: Die [Definition](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_FlowDefinition.html) des Flows. + **executionRoleArn**— Der ARN der IAM-Dienstrolle, die von der Flow-Ausführung verwendet wird. + **flowAliasIdentifier**— Die Alias-ID des Flows. + **flowIdentifier**: Die ID des Flows. + **flowVersion**: Die Version des Flows. ``` { "customerEncryptionKeyArn": null, "definition": "{flow-definition}", "executionRoleArn": "arn:aws:iam::111122223333:role/name", "flowAliasIdentifier": "TSTALIASID", "flowIdentifier": "FLOWID", "flowVersion": "DRAFT" } ``` **Ihre Flow-Ausführungen auflisten** Sie können eine Liste Ihrer Flow-Ausführungen abrufen, indem Sie die [ListFlowExecutions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ListFlowExecutions.html)Operation aufrufen. Die Antwort enthält ein `flowExecutionSummaries` Array mit Informationen zu jeder Ihrer aktuellen Flow-Ausführungen AWS-Region für einen Flow oder Flow-Alias. Jedes Element enthält Informationen wie den Ausführungs-ARN, die Startzeit und den aktuellen Status des Flows. ``` { "flowExecutionSummaries": [{ "createdAt": "2025-03-11T23:21:02.875598966Z", "endedAt": null, "executionArn": "arn:aws:bedrock:us-west-2:111122223333:flow/FLOWID/alias/TSTALIASID/execution/MyExecution", "flowAliasIdentifier": "TSTALIASID", "flowIdentifier": "FLOWID", "flowVersion": "DRAFT", "status": "Running" }] } ``` **Eine laufende Flow-Ausführung stoppen** Wenn Sie eine laufende Flow-Ausführung beenden müssen, rufen Sie den [StopFlowExecution](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_StopFlowExecution.html)Vorgang auf und übergeben Sie die Flow-ID, die Flow-Alias-ID und die Flow-Ausführungs-ID für die Ausführung, die Sie beenden möchten. ------ ## Flow-Ausführungsstatus Eine Flow-Ausführung kann einen der folgenden Status haben: + **Running**: Die Flow-Ausführung ist im Gange. + **Succeeded**: Die Flow-Ausführung wurde erfolgreich abgeschlossen. + **Failed**: Die Flow-Ausführung ist aufgrund eines Fehlers fehlgeschlagen. + **TimedOut**— Die Flow-Ausführung hat die maximale Laufzeit von 24 Stunden überschritten. + **Abgebrochen** — Die Flow-Ausführung wurde mithilfe des [StopFlowExecution](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_StopFlowExecution.html)Vorgangs manuell gestoppt. Flow-Ausführungen, die nicht mehr laufen, werden nach 90 Tagen automatisch gelöscht. ## Best Practices für Flow-Ausführungen Beachten Sie Folgendes, wenn Sie Flow-Ausführungen verwenden: + Rufen Sie den Status Ihrer Flow-Ausführung regelmäßig ab, [GetFlowExecution](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GetFlowExecution.html)bis Ihr Flow einen Terminalstatus erreicht hat (was etwas anderes als`Running`) ist. + Wenn Ihre Flow-Ausführung einen Terminalstatus erreicht, verwenden Sie diese [ListFlowExecutionEvents](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ListFlowExecutionEvents.html)Option, um die Ergebnisse Ihres Flows abzurufen. Sie könnten diese Ergebnisse beispielsweise verwenden, um eine gewisse Logik für Ihren Flow zu schaffen. + Erstellen Sie einen Snapshot Ihrer Flow-Ausführung, [GetExecutionFlowSnapshot](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GetExecutionFlowSnapshot.html)um Ihnen beim Debuggen zu helfen, falls bei der Ausführung Probleme auftreten.