Amazon Bedrock でフローを作成する

注記

プロンプトフローはプレビュー中であり、変更される可能性があります。

プロンプトフローを作成するには、プロンプトフローの名前と説明を最低限指定し、適切なアクセス許可を持つサービスロールを指定します (または、Amazon Bedrock コンソールで自動的に作成されるようにします）。次に、プロンプトフローのステップとして機能するノードとノード間の接続を設定して、プロンプトフローを定義します。フローを作成する前に、「Amazon Bedrock Amazon Bedrock のプロンプトフローの仕組みのプロンプトフロー」の概念と用語を理解し、使用可能なノードのタイプについて学習することをお勧めします。プロンプトフローを作成する方法については、選択した方法に対応するタブを選択し、ステップに従います。

Console

フローを作成するには

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

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

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

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

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

   • 新しいサービスロールを作成して使用する – Amazon Bedrock が使用するサービスロールを作成できるようにします。

   • 既存のサービスロールを使用する – 以前に設定したカスタムサービスロールを選択します。詳細については、「Amazon Bedrock でプロンプトフローのサービスロールを作成する」を参照してください。

6. （オプション) プロンプトフローをKMSキーで暗号化するには、暗号化設定をカスタマイズ (アドバンスト) を選択し、キーを選択します。詳細については、「Amazon Bedrock がフローを暗号化および復号化できるようにするキーポリシー」を参照してください。

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

8. 次の手順に進み、フローを構築するか、後でプロンプトフロービルダーに戻ることができます。

フローを構築するには

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

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

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

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

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

3. ノードを追加および設定するには

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

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

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

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

   5. プロンプトフロービルダーペインの設定セクションで、選択したノードの設定を指定し、ノードの入力と出力の名前、データ型、式を定義します。

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

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

      注記

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

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

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

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

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

ノードを削除するには

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

2. プロンプトフロービルダーペインで、削除アイコン () を選択します 。

   注記

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

接続を削除するには

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

API

フローを作成するには、 Agents for Amazon Bedrock ビルドタイムエンドポイント を使用してCreateFlowリクエストを送信します (リクエストとレスポンスの形式とフィールドの詳細のリンクを参照）。

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

フィールド	基本的な説明
name	フローの名前。
executionRoleArn	フロー を作成および管理するためのアクセス許可を持つサービスロールARNの 。 Amazon Bedrock でプロンプトフローのサービスロールを作成する

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

フィールド	ユースケース
定義	フローconnectionsを構成する nodesと が含まれます。
説明	フローを記述します。
タグ	タグをフローに関連付けるには。詳細については、「リソースのタグ付け」を参照してください。
customerEncryptionKeyArn	KMS キーを使用してフローを暗号化します。詳細については、「Amazon Bedrock がフローを暗号化および復号化できるようにするキーポリシー」を参照してください。
clientToken	API リクエストが 1 回だけ完了するようにするには。詳細については、「冪等性の確保」を参照してください。

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

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

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

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

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

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

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

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

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

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

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

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