教學課程：建立處理房屋貸款申請的流程

1. 下載 cloudformation-mortgage-flow-setup.zip 檔案。

2. 解壓縮檔案。您可以在 CloudFormation 範本 進一步了解內容。

3. 執行下列動作，請求存取 Amazon Bedrock 基礎模型：

   1. AWS 管理主控台 使用具有使用 Amazon Bedrock 主控台之許可的 IAM 身分登入 。接著，開啟位於 https://console.aws.amazon.com/bedrock 的 Amazon Bedrock 主控台。

   2. 在右上角檢查您的區域，確定您位於美國東部 (維吉尼亞北部) 區域。如果不是，請切換區域。

   3. 選取左側導覽窗格底部的模型存取。

   4. 選擇修改模型存取。

   5. 執行以下任意一項：

      • 若要請求存取所有模型，請選擇啟用所有模型。在您前往的頁面上，所有模型旁的核取方塊都會填滿。

      • 若要請求存取特定模型，請選擇啟用所有模型。在您前往的頁面上，您有下列選項：

        • 若要請求供應商存取所有模型，請選取供應商名稱旁的核取方塊。

        • 若要請求存取一個模型，請選取模型名稱旁的核取方塊。

   6. 基於以下教學的目的，您至少應請求存取 Titan Embeddings G1 - Text 和 Claude 3 Haiku 模型。然後選擇下一步。

   7. 檢閱您請求存取的模型和條款。當您就緒時，請選擇提交以請求存取。

1. 在終端機中，執行下列命令，將資源複製到 Amazon S3 儲存貯體，並使用 S3 儲存貯體名稱填入 main-stack.yaml 和 main-stack.json 檔案，做為儲存貯體名稱參數的預設值。

   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：//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. 選擇下一步。

5. 設定堆疊選項：

   1. 在堆疊失敗選項下，選擇刪除所有新建立的資源。

      注意

      選擇此選項可避免針對刪除政策指定的資源向您收費，即使堆疊建立失敗也一樣。如需詳細資訊，請參閱《CloudFormation 使用者指南》中的 DeletionPolicy 屬性。

   2. 在功能下，勾選方塊以確認 CloudFormation 可能會在您的帳戶中建立 IAM 資源。

   3. 選擇下一步。

6. 檢閱堆疊詳細資訊，然後選擇 Submit. CloudFormation creates the stack。建立需要幾分鐘的時間。堆疊建立完成後，您可以使用堆疊詳細資訊頁面上的資源索引標籤來檢視帳戶中佈建的資源。

7. 堆疊建立完成後，請執行下列動作來同步知識庫的資料來源，以便查詢知識庫：

   1. AWS 管理主控台 使用具有使用 Amazon Bedrock 主控台之許可的 IAM 身分登入 。接著，開啟位於 https://console.aws.amazon.com/bedrock 的 Amazon Bedrock 主控台。

   2. 從左側導覽窗格選擇知識庫，然後選取所建立名為 AWSDocsTutorial-MortgageKB 的知識庫。

   3. 在資料來源區段中，選取所建立名為 AWSDocsTutorial-MortgageKB-DS 的資料來源旁的核取方塊。

   4. 選擇同步。同步完成後，您可以測試流程。

測試流程

1. AWS 管理主控台 使用具有使用 Amazon Bedrock 主控台之許可的 IAM 身分登入 。接著，開啟位於 https://console.aws.amazon.com/bedrock 的 Amazon 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 值對應至多重刊登服務上所刊登的屬性。若要尋找有效的 mlsId 值，請執行下列操作：

   1. 登入 AWS 管理主控台 ，並在 https：//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 會啟動刪除主要堆疊、其所有巢狀堆疊，以及堆疊中包含的所有資源。