プロンプトフローのノードタイプ

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

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

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

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

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

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

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

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

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

条件式

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

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

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

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

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

以下は、イテレーター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
    }
}

コレクターノードは、配列のサイズに加えて反復入力を受け取り、配列として返します。イテレーターノードの下流にあるコレクターノードを使用して、一部のノードを介して送信した後に反復された項目を収集できます。

コレクター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
    }
}

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

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

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

プロンプト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)
        }
    }
}

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

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

設定で、使用するエージェントのエイリアスの 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"
        }
    }
}

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

設定で、取得した結果に基づいてレスポンスを生成する場合に使用するナレッジベース ID とモデル ID を指定します。取得した結果を配列として返すには、モデル ID を省略します。ノードへの入力は、ナレッジベースへのクエリです。出力は、モデルレスポンス、文字列、または取得した結果の配列のいずれかです。

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

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

S3 ストレージノードを使用すると、フロー内のデータを 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 取り出しノードを使用すると、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 関数ノードを使用すると、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",
        "nodeInputs": [
            {
               "name": "string",
               "type": "String | Number | Boolean | Object | Array",
               "expression": "string",
               "value": ...
            },
            ...
        ]
   }
}

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

Lambda のイベントの詳細については、「」の「Lambda の概念」を参照してください。 AWS 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"
        }
    }
}