View a markdown version of this page

Mit Flow-Ausführungen Amazon-Bedrock-Flows asynchron ausführen - Amazon Bedrock
Erforderliche Berechtigungen für Flow-AusführungenEine Flow-Ausführung erstellen und verwaltenFlow-AusführungsstatusBest Practices für Flow-Ausführungen

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 Vorgang ausführen, wird der Flow ausgeführt, bis er abgeschlossen ist oder nach einer Stunde ein Timeout auftritt (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

Eine Flow-Ausführung erstellen und verwalten

Sie können eine Flow-Ausführung in der Konsole oder mithilfe der StartFlowExecution Operation erstellen.

Console

  1. Erstellen Sie einen Flow, indem Sie die Anleitungen unter Einen Flow in Amazon Bedrock erstellen und gestalten befolgen.

  2. Erstellen Sie einen Alias für den Flow, indem Sie die Anleitungen unter Einen Alias eines Flows in Amazon Bedrock erstellen befolgen.

  3. Falls Sie sich noch nicht im Flow-Builder befinden, gehen Sie wie folgt vor:

    1. Melden Sie sich 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

    2. Wählen Sie Amazon Bedrock Flows im linken Navigationsbereich und anschließend Ihren Flow aus.

  4. Wählen Sie die Registerkarte Ausführungen und dann Ausführung erstellen aus.

  5. Geben Sie im Dialogfeld Ausführung erstellen Folgendes ein:

    1. Geben Sie unter Name einen Namen für die Flow-Ausführung ein.

    2. Wählen Sie unter Alias auswählen den Alias des Flows aus, den Sie verwenden möchten.

    3. Geben Sie unter Prompt-Eingabe den Prompt ein, mit dem Sie den Flow starten möchten.

    4. Wählen Sie Erstellen aus, um die Flow-Ausführung zu erstellen und zu starten.

  6. 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.

  7. (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.

  8. (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 Anfrage mit einem Laufzeitendpunkt für Agents for Amazon Bedrock. 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-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 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-Knoten des Flows. Sie können die Ausgaben abrufen, nachdem der Flow abgeschlossen ist oder während der Flow ausgeführt wird (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 an, um eine Liste der Ausgabeereignisse aus der Flow-Ausführung abzurufen ListFlowExecutionEvents. 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.

Ereignisse anzeigen

Um das Debuggen Ihrer Schemaausführung zu erleichtern, können Sie den ListFlowExecutionEvents Vorgang verwenden, um Ereignisse anzuzeigen, die Knoten generieren, während das Schema ausgeführt wird. 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 Vorgang auf, um diesen Snapshot abzurufen. Die Antwort enthält die folgenden Felder:

  • Kunde EncryptionKeyArn — Der ARN des AWS KMS Schlüssels, der den Flow verschlüsselt.

  • definition: Die Definition des Flows.

  • Ausführung RoleArn — Der ARN der IAM-Servicerolle, die von der Flow-Ausführung verwendet wird.

  • flow AliasIdentifier — 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 Operation aufrufen. Die Antwort enthält ein flowExecutionSummaries Array mit Informationen zu jeder Ihrer Schemaausführungen in der aktuellen Version 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 stoppen müssen, rufen Sie den StopFlowExecution 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 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 regelmäßig den Status Ihrer Flow-Ausführung ab, indem Sie GetFlowExecution ihn so lange verwenden, bis Ihr Flow einen Endzustand erreicht (was etwas anderes ist alsRunning).

  • Wenn Ihre Flow-Ausführung einen Endzustand erreicht, verwenden Sie diese Option, ListFlowExecutionEvents 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 eine Momentaufnahme Ihrer Flow-Ausführung, GetExecutionFlowSnapshot um beim Debuggen zu helfen, falls bei der Ausführung Probleme auftreten.