Amazon Bedrock でフローをテストする - Amazon Bedrock

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Bedrock でフローをテストする

フローを作成すると、作業中のドラフトが表示されます。作業中のドラフトは、繰り返し構築してテストできるフローのバージョンです。フローを変更するたびに、作業中のドラフトが更新されます。

フローをテストすると、Amazon Bedrock は最初に以下を検証し、検証に失敗した場合は例外をスローします。

  • すべてのフローノード間の接続。

  • 1 つ以上のフロー出力ノードが設定されていること。

  • 入力変数タイプと出力変数タイプが必要に応じて一致していること。

  • 条件式が有効で、デフォルトの結果が提供されていること。

検証が失敗した場合、フローのパフォーマンスをテストして検証する前にエラーを修正する必要があります。フローをテストするための手順を以下に示します。希望する方法のタブを選択し、手順に従ってください。

Console
フローをテストするには

  1. [フロービルダー] を開いていない場合は、以下を実行します。

    1. Amazon Bedrock コンソールを使用するためのアクセス許可を持つ IAM ID を使用して、AWS マネジメントコンソールにサインインします。Amazon Bedrock コンソール (https://console.aws.amazon.com/bedrock) を開きます。

    2. 左側のナビゲーションペインで [Amazon Bedrock フロー] を選択します。次に、[Amazon Bedrock Flows] セクションで、テストするフローを選択します。

    3. [フロービルダーで編集] を選択します。

  2. フロービルダーページの右側のペインで、フローを呼び出す入力を入力します。入力データ型が、フロー入力ノード用に設定した出力データ型と一致することを確認します。

  3. [Run] (実行) を選択します。

  4. フロー設定の中で、エラーをトリガーするノードまたは接続は赤で強調表示され、警告をトリガーするノードまたは接続は黄色で強調表示されます。エラーメッセージと警告を読み、特定された問題を修正し、フローを保存して、テストを再度実行します。

    注記

    フローをテストするときには、変更内容が適用されるように、フローを保存する必要があります。

  5. (オプション) 各ノードの入力、出力、実行時間を表示するには、レスポンスで [トレースを表示] を選択します。詳細については、「Amazon Bedrock の証跡を表示してフローの各ステップを追跡する」を参照してください。ビジュアルビルダーに戻るには、[トレースを非表示] を選択するか、折りたたみアイコンを選択します。

  6. フローのパフォーマンスに満足したら、[保存して終了] を選択します。

  7. 引き続きフローの構築を繰り返すことができます。満足し、本番環境にデプロイする準備ができたら、フローのバージョンとエイリアスを作成してそのバージョンを指します。詳細については、「バージョンとエイリアスを使用してフローをアプリケーションにデプロイする」を参照してください。

API

フローをテストするには、Amazon Bedrock エージェントのランタイムエンドポイントを使用して InvokeFlow リクエストを送信します。フローの ARN または ID を flowIdentifier フィールドに含め、使用するエイリアスの ARN または ID を flowAliasIdentifier フィールドに含めます。

各ノードの入力と出力を表示するには、enableTrace フィールドを TRUE に設定します。詳細については、「Amazon Bedrock の証跡を表示してフローの各ステップを追跡する」を参照してください。

リクエスト本文はフローの入力を指定し、形式は以下のとおりです。

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

document フィールドで入力を指定し、nodeName フィールドで入力の名前を指定して、nodeOutputName フィールドで入力の名前を指定します。

レスポンスはストリームで返されます。返される各イベントには、document フィールドのノードからの出力、nodeName フィールドで処理されたノード、および nodeType フィールド内のノードのタイプが含まれます。これらのイベントの形式は以下のとおりです。

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

フローが終了すると、completionReason を含む flowCompletionEvent フィールドも返されます。エラーがある場合、対応するエラーフィールドが返されます。