フローのノードタイプ

すべてのフローには 1 つのフロー入力ノードのみが含まれており、そのノードから始める必要があります。Flow input ノードは、InvokeFlow リクエストから content を受け取り、データ型を検証して、次のノードに送信します。

API の入力 FlowNode オブジェクトの一般的な構造を以下に示します。

{
    "name": "string",
    "type": "Input",
    "outputs": [
        {
            "name": "document",
            "type": "String | Number | Boolean | Object | Array",
        }
    ],
    "configuration": {
        "input": CONTEXT-DEPENDENT
    }
}

Flow output ノードは、定義された式に基づいて前のノードから入力データを抽出し、それを返します。コンソールでは、出力は、テストウィンドウで [実行] を選択した後に返されるレスポンスです。API では、出力は、InvokeFlow レスポンスの flowOutputEvent の content フィールドで返されます。フローには、複数のフロー出力ノードを含めることができます。

フローに複数のブランチがある場合、フローに複数の Flow output ノードを含めることができます。

出力 FlowNode オブジェクトの一般的な構造を以下に示しています。

{
    "name": "string",
    "type": "Output",
    "inputs": [
        {
            "name": "document",
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        }
    ],
    "configuration": {
        "output": CONTEXT-DEPENDENT
    }
}

Condition ノードは、定義されている条件に応じて、前のノードから別のノードにデータを送信します。Condition ノードは複数の入力を受け付けることができます。

例については、条件ノードを使用してフローを作成するを参照してください。

条件式

条件を定義するには、その名前で入力を参照し、次のいずれかのリレーショナル演算子を使用して値と比較します。

入力を他の入力と比較したり、条件式内の定数と比較したりできます。例えば、profit という数値入力と expenses という別の数値入力がある場合、profit > expenses と profit <= 1000 の両方が有効な式です。

次の論理演算子を使用して、より複雑な条件の式を組み合わせることができます。括弧を使用して、式をグループ化したときのあいまいさを解決することをお勧めします。

API では、CreateFlow または UpdateFlow リクエストを送信するときに、definition フィールドで以下を定義します。

Iterator ノードは配列を取得し、その項目をダウンストリームノードへの出力として繰り返し返します。Iterator ノードへの入力は 1 つずつ処理され、相互に並列処理されません。Flow output ノードは、異なるレスポンスで各入力の最終結果を返します。また、Iterator ノードの下流にある Collector ノードを使用すると、反復応答を収集して、配列のサイズに加えて配列として返すこともできます。

以下は、イテレーター FlowNode オブジェクトの一般的な構造を示しています。

{
    "name": "string",
    "type": "Iterator",
    "inputs": [
        {
            "name": "array",
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        }
    ],
    "outputs": [
        {
            "name": "arrayItem",
            "type": "String | Number | Boolean | Object | Array",
        },
        {
            "name": "arraySize",
            "type": "Number"
        }
    ],
    "configuration": {
        "iterator": CONTEXT-DEPENDENT
    }
}

Collector ノードは、配列のサイズに加えて反復入力を取得し、配列として返します。Iterator ノードの下流にある Collector ノードを使用すると、一部のノード経由で反復項目を送信した後にこれらの項目を収集できます。

コレクター FlowNode オブジェクトの一般的な構造を以下に示しています。

{
    "name": "string",
    "type": "Collector",
    "inputs": [
        {
            "name": "arrayItem",
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        },
        {
            "name": "arraySize",
            "type": "Number"
        }
    ],
    "outputs": [
        {
            "name": "collectedArray",
            "type": "Array"
        },
    ],
    "configuration": {
        "collector": CONTEXT-DEPENDENT
    }
}

Prompt ノードは、フローで使用するプロンプトを定義します。プロンプト管理のプロンプトを使用するか、ノードでプロンプトをインラインで定義できます。詳細については、「Amazon Bedrock でプロンプト管理を使用して再利用可能なプロンプトを構築して保存する」を参照してください。

例については、サンプルフローの使用を開始するを参照してください。

Prompt ノードへの入力は、変数に入力する値です。出力は、モデルから生成されたレスポンスです。

プロンプト FlowNode オブジェクトの一般的な構造を次に示します。

{
    "name": "string",
    "type": "prompt",
    "inputs": [
        {
            "name": "content",
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        },
        ...
    ],
    "outputs": [
        {
            "name": "modelCompletion",
            "type": "String"
        }
    ],
    "configuration": {
        "prompt": {
            "sourceConfiguration": PromptFlowNodeSourceConfiguration object (see below),
            "guardrailConfiguration": {
                "guardrailIdentifier": "string",
                "guardrailVersion": "string"
            }
        }
    }
}

PromptFlowNodeSourceConfiguration オブジェクトは、プロンプト管理のプロンプトを使用するか、プロンプトをインラインで定義するかによって異なります。

Amazon Bedrock ガードレールからのガードレールをプロンプトまたはプロンプトから生成されたレスポンスに適用するには、 guardrailConfigurationフィールドを含め、ガードレールの ID または ARN を guardrailIdentifierフィールドに指定し、ガードレールのバージョンを guardrailVersionフィールドに指定します。

Agent ノードを使用すると、プロンプトをエージェントに送信できます。エージェントは、FM と関連付けられたリソース間でオーケストレーションを行い、エンドユーザーに対してアクションを識別して実行します。詳細については、「AI エージェントを使用してアプリケーションのタスクを自動化する」を参照してください。

設定で、使用するエージェントのエイリアスの Amazon リソースネーム (ARN) を指定します。ノードへの入力は、エージェントのプロンプトおよび関連するプロンプトまたはセッション属性です。ノードはエージェントのレスポンスを出力として返します。

エージェントノードは、マルチターン呼び出しをサポートできるため、フロー実行中のユーザーとエージェント間のインタラクティブな会話が可能になります。エージェントノードが追加情報または明確化を必要とする場合、フロー実行を一時停止し、ユーザーに特定の入力をリクエストできます。ユーザーがリクエストされた情報を提供すると、エージェントノードは新しい入力で処理を続行します。これは、エージェントノードが実行を完了するために必要なすべての情報を取得するまで続きます。

エージェント FlowNode オブジェクトの一般的な構造を次に示します。

{
    "name": "string",
    "type": "Agent",
    "inputs": [
       {
            "name": "agentInputText"
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        },
        {
            "name": "promptAttributes"
            "type": "Object",
            "expression": "string"
        },
        {
            "name": "sessionAttributes"
            "type": "Object",
            "expression": "string"
        }
    ],
    "outputs": [
        {
            "name": "agentResponse",
            "type": "String"
        }
    ],
    "configuration": {
        "agent": {
            "agentAliasArn": "string"
        }
    }
}

ナレッジベースノードを使用すると、Amazon Bedrock ナレッジベースからナレッジベースにクエリを送信できます。詳細については、「Amazon Bedrock ナレッジベースを使用してデータを取得し、AI レスポンスを生成する」を参照してください。

設定で、 をknowledgeBaseId最低限指定します。ユースケースに応じて、オプションで次のフィールドを含めることができます。

ノードへの入力は、ナレッジベースへのクエリです。出力は、モデルレスポンス、文字列、または取得した結果の配列のいずれかです。

ナレッジベース FlowNode オブジェクトの一般的な構造を次に示します。

{
    "name": "string",
    "type": "KnowledgeBase",
    "inputs": [
       {
            "name": "retrievalQuery",
            "type": "String",
            "expression": "string"
        }
    ],
    "outputs": [
        {
            "name": "retrievalResults" | "outputText",
            "type": "Array | String"
        }
    ],
    "configuration": {
        "knowledgeBase": {
            "knowledgeBaseId": "string",
            "modelId": "string",
            "guardrailConfiguration": {
                "guardrailIdentifier": "string",
                "guardrailVersion": "string"
            }
        }
    }
}

S3 Storage ノードを使用すると、Amazon S3 ロケーションへのフローにデータを保存できます。設定では、データストレージに使用する S3 バケットを指定します。ノードへの入力は、保存するコンテンツとオブジェクトキーです。ノードは S3 ロケーションの URI を出力として返します。

S3 ストレージ FlowNode オブジェクトの一般的な構造を次に示します。

{
    "name": "string",
    "type": "Storage",
    "inputs": [
        {
            "name": "content",
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        },
        {
            "name": "objectKey",
            "type": "String",
            "expression": "string"
        }
    ],
    "outputs": [
        {
            "name": "s3Uri",
            "type": "String"
        }
    ],
    "configuration": {
        "retrieval": {
            "serviceConfiguration": {
                "s3": {
                    "bucketName": "string"
                }
            }
        }
    }
}

S3 Retrieval ノードを使用すると、Amazon S3 ロケーションからデータを取得してフローに導入できます。設定では、データを取得する S3 バケットを指定します。ノードへの入力はオブジェクトキーです。ノードは S3 ロケーションのコンテンツを出力として返します。

S3 取り出し FlowNode オブジェクトの一般的な構造を次に示します。

{
    "name": "string",
    "type": "Retrieval",
    "inputs": [
        {
            "name": "objectKey",
            "type": "String",
            "expression": "string"
        }
    ],
    "outputs": [
        {
            "name": "s3Content",
            "type": "String"
        }
    ],
    "configuration": {
        "retrieval": {
            "serviceConfiguration": {
                "s3": {
                    "bucketName": "string"
                }
            }
        }
    }
}

Lambda function ノードを使用すると、ビジネスロジックを実行するようにコードを定義できる Lambda 関数を呼び出すことができます。フローに Lambda ノードを含めると、Amazon Bedrock は指定した Lambda 関数に入力イベントを送信します。

設定では、Lambda 関数の Amazon リソースネーム (ARN) を指定します。Lambda 入力イベントで送信する入力を定義します。これらの入力に基づいてコードを記述し、関数によって返される内容を定義できます。出力では、関数のレスポンスが返されます。

Λ 関数 FlowNode オブジェクトの一般的な構造を次に示します。

{
    "name": "string",
    "type": "LambdaFunction",
    "inputs": [
       {
            "name": "string",
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        },
        ...
    ],
    "outputs": [
        {
            "name": "functionResponse",
            "type": "String | Number | Boolean | Object | Array"
        }
    ],
    "configuration": {
        "lambdaFunction": {
            "lambdaArn": "string"
        }
    }
}

フローの Lambda 入力イベント

Lambda ノードで Lambda 関数に送信される入力イベントは、次の形式です。

{
   "messageVersion": "1.0",
   "flow": {
        "flowArn": "string",
        "flowAliasArn": "string"
   },
   "node": {
        "name": "string",
        "inputs": [
            {
               "name": "string",
               "type": "String | Number | Boolean | Object | Array",
               "expression": "string",
               "value": ...
            },
            ...
        ]
   }
}

各入力のフィールドは Lambda ノードを定義するときに指定したフィールドと一致し、value フィールドの値は、式によって解決された後のノードへの入力全体で指定されます。例えば、ノードへの入力全体が [1, 2, 3] で、式が $.data[1] の場合、Lambda 関数に送信される入力イベントの値は 2 になります。

Lambda でのイベントの詳細については、AWS Lambda デベロッパーガイドの「Lambda の概念」を参照してください。

フローの Lambda レスポンス

Lambda 関数を記述するときは、この関数から返されるレスポンスを定義します。このレスポンスは、Lambda ノードの出力としてフローに返されます。

Lex ノードを使用すると、Amazon Lex ボットを呼び出して自然言語処理を使用して発話を処理し、ボット定義に基づいてインテントを識別できます。詳細については、Amazon LEX 開発者ガイドを参照してください。

設定で、使用するボットのエイリアスの Amazon リソースネーム (ARN) と使用するロケールを指定します。ノードへの入力は、発話と、それに伴うリクエスト属性またはセッション属性です。ノードは、識別されたインテントを出力として返します。

Lex FlowNode オブジェクトの一般的な構造を次に示します。

{
    "name": "string",
    "type": "Lex",
    "inputs": [
       {
            "name": "inputText",
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        },
        {
            "name": "requestAttributes",
            "type": "Object",
            "expression": "string"
        },
        {
            "name": "sessionAttributes",
            "type": "Object",
            "expression": "string"
        }
    ],
    "outputs": [
        {
            "name": "predictedIntent",
            "type": "String"
        }
    ],
    "configuration": {
        "lex": {
            "botAliasArn": "string",
            "localeId": "string"
        }
    }
}