チュートリアル: 住宅ローン申請を処理するフローを作成する

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

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

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

   1. Amazon Bedrock コンソールを使用するアクセス許可を持つ IAM ID AWS マネジメントコンソール を使用して にサインインします。Amazon Bedrock コンソール (https://console.aws.amazon.com/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 で CloudFormation コンソールを開きます。右上隅にあるリージョンを確認して、米国東部 (バージニア北部) リージョンにいることを確かめます。そうでない場合は、リージョンを切り替えます。

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

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

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

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

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

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

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

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

   2. [パラメータ] フィールドはデフォルト値のままにします。

      注記

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

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

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

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

      注記

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

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

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

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

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

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

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

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

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

フローをテストするには

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

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

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

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

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 マネジメントコンソール し、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 は、メインスタック、ネストされたすべてのスタック、およびスタックに含まれるすべてのリソースの削除を開始します。