Amazon Bedrock でフローを作成する - Amazon Bedrock

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

Amazon Bedrock でフローを作成する

フローを作成するには、少なくともフローの名前と説明を指定し、適切なアクセス許可を持つサービスロールを指定します (または、Amazon Bedrock コンソールで自動的に作成されるようにします)。次に、フローのステップとして機能するノードと、ノード間の接続を設定してフローを定義します。フローを作成する前に、「」を読んで Amazon Bedrock Flows の概念と用語Amazon Bedrock フローの仕組みを理解し、使用可能なノードのタイプについて学ぶことをお勧めします。

Amazon Bedrock は保管中のデータを暗号化します。デフォルトでは、Amazon Bedrock はこのデータを暗号化するのに AWS マネージドキーを使用します。必要に応じて、カスタマーマネージドキーを使用してフロー実行データを暗号化できます。詳細については、「Amazon Bedrock Flows リソースの暗号化」を参照してください。

フローを作成する方法については、任意の方法のタブを選択し、ステップに従います。

Console
フローを作成するには
  1. Amazon Bedrock のアクセス許可を持つ IAM ロール AWS Management Console を使用して にサインインし、「 の開始方法 AWS Management Console」で Amazon Bedrock コンソールを開きます。

  2. 左側のナビゲーションペインから Amazon Bedrock フローを選択します。

  3. Amazon Bedrock Flows セクションで、フローの作成を選択します。

  4. フローの [名前] とオプションの [説明] を入力します。

  5. [サービスロール名] で、以下のオプションのいずれかを選択します。

  6. (オプション) KMS キーを使用してフローを暗号化するには、暗号化設定をカスタマイズ (詳細) を選択し、キーを選択します。詳細については、「Amazon Bedrock Flows リソースの暗号化」を参照してください。

  7. [Create] (作成) を選択します。フローが作成され、フローを構築できるフロービルダーに移動します。

  8. 次の手順に進み、フローを構築するか、後でフロービルダーに戻ります。

フローを構築するには
  1. フロービルダーにまだない場合は、次の操作を行います。

    1. Amazon Bedrock アクセス許可を持つ IAM ロール AWS Management Console を使用して にサインインし、「 の開始方法 AWS Management Console」の「Amazon Bedrock コンソールを開きます。

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

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

  2. フロービルダーセクションの中央ペインには、フロー入力ノードとフロー出力ノードが表示されます。これらは、フローの入力ノードと出力ノードです。

  3. ノードを追加して設定するには

    1. フロービルダーペインで、ノードを選択します。

    2. フローの最初のステップに使用するノードをドラッグし、中央ペインにドロップします。

    3. ノードの円は接続ポイントです。フロー入力ノードを 2 番目のノードに接続するには、フロー入力ノードの円から、追加したノードの入力セクションの円に線をドラッグします。

    4. 追加したノードを選択します。

    5. Flow Builder ペインの設定セクションで、選択したノードの設定を指定し、ノードの入出力の名前、データ型、式を定義します。

    6. フロービルダーペインで、ノードを選択します。

    7. ステップを繰り返して、フロー内の残りのノードを追加して設定します。

      注記

      Amazon Bedrock によって自動的に作成されたサービスロールを使用する場合は、ノードを追加すると、ロールが適切なアクセス許可で更新されます。ただし、カスタムサービスロールを使用する場合は、「Amazon Bedrock で Amazon Bedrock フローのサービスロールを作成する」を参照して、サービスロールにアタッチされたポリシーに適切なアクセス許可を追加する必要があります。

  4. フロー内の最後のノードの出力フロー出力ノードの入力に接続します。複数のフロー出力ノードを構成できます。さらにフロー出力ノードを追加するには、フロー出力ノードをドラッグして、フローを停止するノードの横にドロップします。2 つのノード間では必ず接続を描画してください。

  5. 引き続き次の手順から「Amazon Bedrock でフローをテストする」に進むことができますが、後から戻ることもできます。次のステップに進むには、[保存] を選択します。後から戻るには、[保存して終了] を選択します。

ノードまたは接続を削除する

フローを構築するプロセス中、ノードを削除したり、ノード接続を削除したりする必要がある場合があります。

ノードを削除するには
  1. 削除するノードを選択します。

  2. Flow Builder ペインで、削除アイコン () を選択します Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family.

    注記

    Amazon Bedrock によって自動的に作成されたサービスロールを使用する場合は、ノードを追加すると、ロールが適切なアクセス許可で更新されます。ただし、ノードを削除しても、関連するアクセス許可は削除されません。不要になったアクセス許可は、「ロールの変更」の手順に従って削除することをお勧めします。

接続を削除するには
  • [フロービルダー] ページで、展開アイコンが表示されるまで、削除する接続にカーソルを合わせ、接続をノードからドラッグします。

API

フローを作成するには、Amazon Bedrock エージェントのビルドタイムエンドポイントを使用して CreateFlow リクエストを送信します。

以下のフィールドが必要です。

フィールド 基本的な説明
名前 フローの名前。
executionRoleArn フローを作成して管理するためのアクセス許可を持つサービスロールの ARN

次のフィールドはオプションです。

フィールド ユースケース
定義 フローを構成する nodesconnections が含まれます。
description フローについて記述する場合に指定します。
tags タグをエイリアスに関連付ける場合に指定します。詳細については、「Amazon Bedrock リソースにタグ付け」を参照してください。
customerEncryptionKeyArn KMS キーを使用してリソースを暗号化するには。詳細については、「Amazon Bedrock Flows リソースの暗号化」を参照してください。
clientToken API リクエストが 1 回だけ完了するようにします。詳細については、「べき等性の確保」を参照してください。

definition フィールドはオプションですが、フローが機能するために必要です。定義なしでフローを作成し、後でフローを更新することもできます。

nodes リスト内のノードごとに、type フィールドでノードのタイプを指定し、config フィールドでノードの対応する設定を指定します。さまざまなタイプのノードの API 構造の詳細については、「フローのノードタイプ」を参照してください。

フローを構築する際には、次の要件が適用されます。

  • フローには、フロー入力ノードが 1 つのみ、フロー出力ノードが 1 つ以上必要です。

  • フロー入力ノードの入力を含めることはできません。

  • フロー出力ノードの出力を含めることはできません。

  • ノード内のすべての出力は、ダウンストリームノードの入力に接続する必要があります (API では、これは FlowConnectionFlowDataConnectionConfiguration を介して行われます)。

  • 条件ノードのすべての条件 (デフォルトの条件を含む) は、ダウンストリームノードに接続する必要があります (API では、FlowConnectionFlowConditionalConnectionConfiguration を介して行われます)。

フローを構築する際には、次のポインターが適用されます。

  • まず、フロー入力ノードの出力のデータ型を設定します。このデータ型は、フローを呼び出すときに入力として送信することが期待されるデータ型と一致する必要があります。

  • 式を使用してフローの入力を定義するとき、結果が入力に選択したデータ型と一致することを確認します。

  • イテレータノードを含める場合、必要なノードを介して出力を送信した後、コレクターノードのダウンストリームを含めます。コレクターノードは、配列内の出力を返します。