本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 教程：创建处理抵押贷款申请的流
为了熟悉 Amazon Bedrock 资源及其功能，我们将使用 CloudFormation 模板来设置一个[流程](flows.md)，通过组合各种 Amazon Bedrock 和其他资源，自动执行抵押贷款申请流程。 AWS
**注意**
在本教程中，我们将使用{{us-east-1}}区域。您可以使用任何支持代理、流、护栏、知识库和提示管理器的区域。有关按区域的功能支持表，请参阅[功能支持由 AWS 区域 在 Amazon Bedrock 中](features-regions.md)。确保您有权在所使用的区域中创建 Amazon S3、Amazon Bedrock、Lambda 和 DynamoDB 资源。
此流并不用于部署目的，而是用作了解 Amazon Bedrock 资源的教程。下图直观地展示了 AWS 管理控制台中的流：
该流结合使用 Amazon Bedrock [代理](agents.md)、[提示](prompt-management.md)和 [Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) 函数，来创建一个抵押贷款处理流，该流会收集客户的财务信息并处理客户是否符合贷款资格。Amazon Bedrock [知识库](knowledge-base.md)和[护栏](guardrails.md)也附加到流的代理，以增强响应并提供安全保障。有关流组件的更详细信息，请参阅[有关抵押贷款处理流的详细信息](getting-started-mortgage-flow-details.md)。
**Topics**
+ [先决条件](#getting-started-mortgage-flow-prereqs)
+ [使用创建抵押贷款处理流程 CloudFormation](#getting-started-mortgage-flow-create)
+ [测试抵押贷款处理流](#getting-started-mortgage-flow-test)
+ [清理：删除资源](#getting-started-mortgage-flow-delete)
+ [CloudFormation 模板](getting-started-mortgage-flow-template.md)
+ [有关抵押贷款处理流的详细信息](getting-started-mortgage-flow-details.md)
## 先决条件
要创建此流，您需要下载一个 .zip 文件，并按照说明运行脚本，该脚本将为您设置资源和模板。
**重要**
您创建的 Amazon 资源将会收费，直到您删除它们。
然后，完成以下先决任务：
1. 下载 [cloudformation-mortgage-flow-setup.zip](samples/cloudformation-mortgage-flow-setup.zip) 文件。
1. 解压缩该文件。您可以在 [CloudFormation 模板](getting-started-mortgage-flow-template.md)中了解有关内容的更多信息。
1. 通过执行以下操作，请求访问 Amazon Bedrock 基础模型：
1. 使用有权使用 Amazon Bedrock 控制台的 IAM 身份登录。 AWS 管理控制台 然后，打开 Amazon Bedrock 控制台，网址为[https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)。
1. 检查右上角的区域，确保您使用的是**美国东部（弗吉尼亚州北部）**区域。如果不是，请切换区域。
1. 选择左侧导航窗格底部的**模型访问权限**。
1. 选择**修改模型访问权限**。
1. 请执行以下操作之一：
+ 要请求访问所有模型，请选择**启用所有模型**。在您转到的页面上，所有模型旁边的复选框都将处于选中状态。
+ 要请求访问特定模型，请选择**启用特定模型**。在您转到的页面上，您有以下选项：
+ 要请求访问提供商的所有模型，请选中提供商名称旁边的复选框。
+ 要请求访问某一模型，请选中模型名称旁边的复选框。
1. 就以下教程而言，您应尽量减少请求访问 **Titan Embeddings G1 - Text** 和 **Claude Haiku 4.5** 模型的次数。然后选择**下一步**。
1. 查看您请求访问的模型和相应**条款**。准备好之后，选择**提交**以请求访问权限。
## 使用创建抵押贷款处理流程 CloudFormation
为了创建抵押贷款处理流程及其相关资源，我们将创建一个 CloudFormation 模板并使用它来创建包含 Amazon Bedrock 资源的堆栈。
**重要**
您创建的 Amazon 资源将会收费，直到您删除它们。
### 创建资源然后 CloudFormation 模板文件
首先，使用.zip 文件中的脚本将资源上传到 S3 存储桶并创建 CloudFormation 模板。
1. 在终端中运行以下命令，将资源复制到 Amazon S3 存储桶，并将 `main-stack.yaml` 和 `main-stack.json` 文件填充为 S3 存储桶名称，作为存储桶名称参数的默认值。
```
bash deploy.sh
```
**注意**
脚本的用法是`bash deploy.sh {{}} {{}}`，其中{{}}和{{}}是可选参数。如果您不提供这些参数，将使用以下默认值：
{{}}— 在您的 AWS 凭证设置中指定的默认 AWS 区域。
{{}}— 存储桶将被命名{{mortgage-flow-deployment--}}，其中{{}}是您的 AWS 账户 ID，与您提供的值或 AWS 证书设置中指定的默认 AWS 区域{{}}相匹配。
1. 确认提示。部署完成后，您应该有一个完整的 `main-stack.json` 和 `main-stack.yaml` 模板供下一步使用。
**注意**
如果脚本失败，您可以通过执行以下操作，手动准备资源：
在 Amazon S3 控制台中将解压缩文件夹的*内容*（不包括`cloudformation-mortgage-flow-setup`文件夹本身）上传到美国东部（弗吉尼亚北部）的 S3 存储桶，网址为。[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
查找 `templates/json/main-stack-tmp.yaml` 或 `templates/json/main-stack-tmp.json` 文件并执行以下操作：
将`Q01pS3BucketName`参数的`Default`值从更改为您{{MortgageFlowBucket}}的 S3 存储桶名称。
从文件名中删除 `-tmp`，使其变为 `templates/json/main-stack.yaml` 或 `templates/json/main-stack.json`。
### 使用创建堆栈 CloudFormation 控制台
接下来，使用您保存的模板来配置堆 CloudFormation 栈。
1. 打开 CloudFormation 控制台，网址为[https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/)。检查右上角的区域，确保您使用的是**美国东部（弗吉尼亚州北部）**区域。如果不是，请切换区域。
1. 在**堆栈**页面中，从**创建堆栈**菜单中选择**使用新资源（标准）**。
1. 指定模板：
1. 在**先决条件**下，选择**选择现有模板**。
1. 在**指定模板**下，选择**上传模板文件**。
1. 选择**选择文件**，导航到 `main-stack.yaml` 或 `main-stack.json` 模板，并选择该模板。
1. 选择**下一步**。
1. 指定堆栈详细信息：
1. 在**堆栈名称**字段中，为堆栈输入名称。
1. 在**参数**字段中，保留默认值。
**注意**
`Q01pS3BucketName` 值应与您为此模板上传资源的 S3 存储桶名称匹配。其余的参数与知识库的配置有关；如果您修改其中任何一个，请确保各配置之间是兼容的。有关更多信息，请参阅 [将您创建的向量存储用于知识库的先决条件](knowledge-base-setup.md)。
1. 选择**下一步**。
1. 配置堆栈选项：
1. 在**堆栈故障选项**下，选择**删除所有新创建的资源**。
**注意**
如果选择此选项，即使堆栈创建失败，您可能也不会因为删除策略规定保留资源而向资源付费。有关更多信息，请参阅《CloudFormation 用户指南》**中的 [`DeletionPolicy` 属性](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html)。
1. 在 “**能力**” 下，选中复选框以确认 CloudFormation 可能会在您的账户中创建 IAM 资源。
1. 选择**下一步**。
1. 查看堆栈详细信息并选择**提交**。 CloudFormation 创建堆栈。创建过程需要几分钟时间。在堆栈创建完成后，可以使用堆栈详细信息页面上的**资源**选项卡来查看账户中预置的资源。
1. 在堆栈创建完成后，执行以下操作以同步知识库的数据来源，从而可以查询知识库：
1. 使用有权使用 Amazon Bedrock 控制台的 IAM 身份登录。 AWS 管理控制台 然后，打开 Amazon Bedrock 控制台，网址为[https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)。
1. 在左侧导航窗格中，选择**知识库**，然后选择已创建的名为 `AWSDocsTutorial-MortgageKB` 的知识库。
1. 在**数据来源**部分中，选中已创建的名为 `AWSDocsTutorial-MortgageKB-DS` 的数据来源旁边的复选框。
1. 选择**同步**。同步完成后，您可以测试该流。
## 测试抵押贷款处理流
创建抵押贷款处理流后，您可以使用 Amazon Bedrock 控制台来检查、测试和修改流。您还可以检查、测试和修改流中的各个资源。
**测试流**
1. 使用有权使用 Amazon Bedrock 控制台的 IAM 身份登录。 AWS 管理控制台 然后，打开 Amazon Bedrock 控制台，网址为[https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)。
1. 从左侧导航窗格中选择**流**。检查右上角的区域，确保您使用的是**美国东部（弗吉尼亚州北部）**区域。如果不是，请切换区域。
1. 在 “**流程**” 部分中，选择根据 CloudFormation 模板创建的流程。它应该是 `AWSDocsTutorial-MortgageFlow`。
1. 选择**在流生成器中编辑**。您可以拖动流中的各个节点来修改流的可视化表示。
1. 在**测试流**窗格中，在文本字段中输入以下内容，然后选择**运行**。
```
{
"income": 80000,
"totalDebt": 5000,
"loanTerm": 30,
"loanAmount": 600000,
"creditScore": 750,
"mlsId": "MLS-5678"
}
```
由于贷款金额大于计算得到的最大可承受贷款额度，因此会触发 **incomeDebt** 提示并且流会生成拒绝函。您可以选择**显示跟踪**来查看流中运行的节点。
1. 同样，在**测试流**窗格中，在文本字段中输入以下内容，然后选择**运行**。
```
{
"income": 120000,
"totalDebt": 5000,
"loanTerm": 30,
"loanAmount": 200000,
"creditScore": 650,
"mlsId": "MLS-3456"
}
```
由于贷款金额低于计算的最高可负担贷款，因此会触发 **Proces** sApplication 提示并发送到**抵押贷**款ProcessingAgent，抵押贷款会查找所附的知识库并生成响应，根据输入值评估客户是否有资格获得贷款。
1. （可选）尝试通过为 JSON 对象中的字段使用不同的值来运行流。这些 `mlsId` 值对应于多重挂牌服务上列出的房产。您可以执行以下操作来查找有效的 `mlsId` 值：
1. 登录 AWS 管理控制台 并打开 DynamoDB 控制台，网址为。[https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/)
1. 在左侧导航窗格中，选择**表**。
1. 选择上面写着的表格**AWSDocsTutorial-PropertyListing**。
1. 选择**浏览表项目**。
1. 您可以在流输入中使用 **mls\_id** 列中的任何值。
您还可以导航到中的**代理**、**知识库**、**防护栏**和**提示管理**页面， AWS 管理控制台 以独立检查流程中使用的每个 Amazon Bedrock 资源。要了解有关流的更多信息并更详细地了解各个组件，请参阅[有关抵押贷款处理流的详细信息](getting-started-mortgage-flow-details.md)。
## 清理：删除资源
在您探索这些资源并更好地了解不同 Amazon Bedrock 资源的功能后，我们将删除该堆栈及其包含的资源。
**重要**
您创建的 Amazon 资源将会收费，直到您删除它们。
1. 打开 [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/)。
1. 从左侧导航窗格中选择**堆栈**。
1. 选择您根据此模板创建的堆栈。然后，选择**删除**，再确认**删除**。
CloudFormation 启动删除主堆栈、其所有嵌套堆栈以及堆栈中包含的所有资源。