チュートリアル: 住宅ローンアプリケーションを処理するフローを作成する

1. cloudformation-mortgage-flow-setup.zip ファイルをダウンロードします。

2. ファイル を解凍します。詳細については、「」を参照してくださいCloudFormation テンプレート。

3. 以下を実行して、Amazon Bedrock 基盤モデルへのアクセスをリクエストします。

   1. Amazon Bedrock コンソールを使用するアクセス許可を持つ IAM ID AWS Management Console を使用して にサインインします。次に、https://console.aws.amazon.com/bedrock で Amazon Bedrock コンソールを開きます。

   2. 右上隅にあるリージョンを確認して、米国東部 (バージニア北部) リージョンにいることを確認します。そうでない場合は、リージョンを切り替えます。

   3. 左ナビゲーションペインの下部にある [モデルアクセス] を選択します。

   4. [モデルアクセスを変更] を選択します。

   5. 次のいずれかを行います：

      • すべてのモデルへのアクセスをリクエストするには、[すべてのモデルを有効にする] を選択します。移動先のページで、すべてのモデルの横にあるチェックボックスがオンになります。

      • 特定のモデルへのアクセスをリクエストするには、[特定のモデルを有効にする] を選択します。移動先のページで、次のオプションが表示されます。

        • プロバイダーからすべてのモデルへのアクセスをリクエストするには、プロバイダー名の横にあるチェックボックスをオンにします。

        • 1 つのモデルへのアクセスをリクエストするには、モデル名の横にあるチェックボックスをオンにします。

   6. 次のチュートリアルでは、 Titan Embeddings G1 - Textおよび Claude 3 Haikuモデルへのアクセスを最低限リクエストする必要があります。次いで、[次へ] を選択します。

   7. アクセスをリクエストするモデルと [利用規約] を確認します。準備ができたら、[送信] を選択してアクセスをリクエストします。

1. ターミナルで、次のコマンドを実行してリソースを Amazon S3 バケットにコピーし、 main-stack.yamlおよび main-stack.json ファイルにバケット名パラメータのデフォルト値として S3 バケット名を入力します。

   bash deploy.sh

   注記

   スクリプトの使用法は です。ここでbash deploy.sh <region> <bucket-name>、<region> と <bucket-name> はオプションの引数です。指定しない場合、次のデフォルト値が使用されます。

   • <region> – AWS 認証情報の設定で指定されたデフォルトの AWS リージョン。

   • <bucket-name> – バケットには mortgage-flow-deployment-<AccountId>-<Region> という名前が付けられます。ここで、<AccountId> は AWS アカウント ID であり、<Region> は指定した値または AWS 認証情報の設定で指定されたデフォルトの AWS リージョンと一致します。

2. プロンプトを確認します。デプロイが完了したら、次のステップ用の完全な テンプレートmain-stack.yamlと main-stack.json テンプレートが必要です。

1. https://console.aws.amazon.com/cloudformation で AWS CloudFormation コンソールを開きます。右上隅にあるリージョンを確認して、米国東部 (バージニア北部) リージョンにいることを確認します。そうでない場合は、リージョンを切り替えます。

2. スタックページで、スタックの作成メニューから、新しいリソースを使用する (標準) を選択します。

3. テンプレートを指定します。

   1. [前提条件] で、[既存のテンプレートを選択] を選択します。

   2. [テンプレートの指定] で、[テンプレートファイルのアップロード] を選択します。

   3. ファイルの選択を選択し、 main-stack.yamlまたは main-stack.json テンプレートに移動して選択します。

   4. [次へ] を選択します。

4. スタックの詳細を指定します。

   1. スタック名フィールドに、スタックの名前を入力します。

   2. Parameters フィールドで、デフォルト値のままにします。

      注記

      Q01pS3BucketName 値は、このテンプレートのリソースをアップロードした S3 バケットの名前と一致する必要があります。残りの引数はナレッジベースの設定に関連しています。いずれかの引数を変更する場合は、設定が相互に互換性があることを確認してください。詳細については、「ナレッジベース用に作成したベクトルストアを使用するための前提条件」を参照してください。

   3. [Next] (次へ) を選択します。

5. スタックオプションを設定します。

   1. [スタック障害オプション] で、[新しく作成されたリソースをすべて削除] を選択します。

      注記

      このオプションを選択すると、スタックの作成に失敗した場合でも削除ポリシーで保持するように指定されているリソースに対して、課金される可能性を防ぐことができます。詳細については、「 AWS CloudFormation ユーザーガイド」のDeletionPolicy「 属性」を参照してください。

   2. [機能] では、チェックボックスをオンにして、CloudFormation によってアカウントに IAM リソースが作成される場合があることを承認します。

   3. [次へ] を選択します。

6. スタックの詳細を確認し、Submit. AWS CloudFormation creates を選択します。作成には数分かかります。スタックの作成が完了したら、スタックの詳細ページのリソースタブを使用して、 がアカウントでプロビジョニングしたリソースを表示できます。

7. スタックの作成が完了したら、以下を実行してナレッジベースのデータソースを同期し、ナレッジベースをクエリできるようにします。

   1. Amazon Bedrock コンソールを使用するアクセス許可を持つ IAM ID AWS Management Console を使用して にサインインします。次に、https://console.aws.amazon.com/bedrock で Amazon Bedrock コンソールを開きます。

   2. 左側のナビゲーションペインで、ナレッジベースを選択し、 という名前で作成されたナレッジベースを選択しますAWSDocsTutorial-MortgageKB。

   3. データソースセクションで、 という名前で、作成されたデータソースの横にあるチェックボックスをオンにしますAWSDocsTutorial-MortgageKB-DS。

   4. [同期] を選択します。同期が完了したら、フローをテストできます。

フローをテストするには

1. Amazon Bedrock コンソールを使用するアクセス許可を持つ IAM ID AWS Management Console を使用して にサインインします。次に、https://console.aws.amazon.com/bedrock で Amazon Bedrock コンソールを開きます。

2. 左側のナビゲーションペインから、フローを選択します。右上隅にあるリージョンを確認して、米国東部 (バージニア北部) リージョンにいることを確認します。そうでない場合は、リージョンを切り替えます。

3. フローセクションで、CloudFormation テンプレートから作成されたフローを選択します。これは、AWSDocsTutorial-MortgageFlow になります。

4. Flow Builder で編集を選択します。フロー内の個々のノードをドラッグして、フローの視覚的表現を変更できます。

5. テストフローペインで、テキストフィールドに次のように入力し、実行を選択します。

   {
       "income": 80000, 
       "totalDebt": 5000, 
       "loanTerm": 30, 
       "loanAmount": 600000, 
       "creditScore": 750, 
       "mlsId": "MLS-5678"
   }

   ローン金額が計算された最大手頃なローン額より大きいため、incomeDebt プロンプトがトリガーされ、フローは拒否レターを生成します。トレースを表示を選択して、フローで実行されたノードを表示できます。

6. ここでも、テストフローペインで、テキストフィールドに次のように入力し、実行を選択します。

   {
       "income": 120000, 
       "totalDebt": 5000, 
       "loanTerm": 30, 
       "loanAmount": 200000, 
       "creditScore": 650, 
       "mlsId": "MLS-3456"
   }

   ローン金額が計算された最大手頃なローンを下回るため、processApplication プロンプトがトリガーされ、mortgageProcessingAgent に送信されます。このプロンプトは、アタッチされたナレッジベースを検索し、入力値に基づいて、顧客がローンの資格があるかどうかを評価するレスポンスを生成します。

7. (オプション) JSON オブジェクトのフィールドに異なる値を使用してフローを実行してみてください。mlsId 値は、Multiple Listing Service にリストされているプロパティに対応しています。有効なmlsId値を見つけるには、以下を実行します。

   1. にサインイン AWS Management Console し、https://console.aws.amazon.com/dynamodb/ で DynamoDB コンソールを開きます。

   2. 左側のナビゲーションペインで、テーブルを選択します。

   3. AWSDocsTutorial-PropertyListing というテーブルを選択します。

   4. [テーブルアイテムの探索] を選択します。

   5. フロー入力の mls_id 列の任意の値を使用できます。

1. https://console.aws.amazon.com/cloudformation を開きます。

2. 左側のナビゲーションペインから、スタックを選択します。

3. テンプレートから作成したスタックを選択します。次に、削除を選択し、削除を確認します。

   CloudFormation は、メインスタック、ネストされたすべてのスタック、およびスタックに含まれるすべてのリソースの削除を開始します。