本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
部署独立的 Bedrock Agent 用例
按照本节中的 step-by-step说明配置解决方案并将其部署到您的账户。
部署时间:大约 10-30 分钟
-
登录 A WS 管理控制台
并选择启动 CloudFront 模板的按钮。 -
默认情况下,该模板在美国东部(弗吉尼亚州北部)区域启动。要在其他 AWS 区域启动解决方案,请使用控制台导航栏中的区域选择器。
注意
此解决方案使用 Amazon Bedrock,但目前并非在所有 AWS 区域都可用。如果您正在使用这些功能,则必须在提供这些服务的 AWS 地区启动此解决方案。有关各地区的最新可用性,请参阅 AWS 区域服务列表
。 -
在创建堆栈页面上,确认 Amazon S3 URL 文本框中已有正确的模板 URL,然后选择下一步。
-
在指定堆栈详细信息页面上,为您的解决方案堆栈分配一个名称。有关命名字符限制的信息,请参阅 AWS https---docs-aws-amazon-com Identity and Access Man agement 用户指南中的 {https---docs-aws-amazon-comUserGuide--iam-latest--reference-iam-limits-html} [IAM 和 AWS STS 配额]。
-
在参数下,检查该解决方案模板的参数,并根据需要进行修改。该解决方案使用以下默认值。
参数 默认条目 说明 UseCaseUUID
<_Requires input_>长度 UUIDv4 为 36 个字符,用于标识应用程序中已部署的用例。
UseCaseConfigRecordKey
<Requires input>与包含聊天提供商 Lambda 函数在运行时所需的配置的记录对应的密钥。
表中的记录必须具有与该值匹配的关键属性,以及包含所需配置的配置属性。
如果部署平台正在使用此记录,则该记录将由部署平台填充。对于此用例的独立部署,需要在中定义的表中手动创建的UseCaseConfigTableName条目。
UseCaseConfigTableName
<Requires input>`堆栈将使用中定义的记录密钥从此处提供的表中读取用例配置UseCaseConfigRecordKey。
DefaultUserEmail
placeholder@example.com此用例的默认用户的电子邮件。该解决方案为该电子邮件创建了一个 Amazon Cognito 用户来访问该用例。
ExistingRestApiId
(可选输入)
要使用的现有 API Gateway REST API ID。如果未提供,则将创建一个新的 API Gateway REST API。通常在从 “部署” 仪表板部署时提供。
注意:使用现有 APIs 可以帮助减少资源重复,并简化 APIs 何时需要部署多个独立用例的管理。在 APIs 为独立用例提供现有路径时,您有责任确保 API 配置为具有预期模型的所需路由。必须配置所需的预先配置的 /details 路由(在聊天期间获取用例详细信息),也可以配置 /feedback 路由(如果设置FeedbackEnabled
Yes为启用收集 LLM 聊天响应的反馈)。此外 ExistingApiRootResourceIdExistingCognitoUserPoolId,还ExistingCognitoGroupPolicyTableName必须提供、。ExistingApiRootResourceId
(可选输入)
要使用的现有 API Gateway REST API 根资源 ID。REST API 根资源 ID 可以从 AWS 控制台获取,方法是在 API 的 “资源” 部分选择根资源 (/)。然后,资源 ID 将显示在资源详细信息面板中。或者,您也可以在 REST API 上运行描述 API 调用以查找根资源 ID。
FeedbackEnabled
No如果设置为 “否”,则部署的用例堆栈将无法访问反馈功能。
CognitoDomainPrefix
(可选输入)
如果您想为 Amazon Cognito 用户池客户端提供域名,请输入一个值。如果您不提供值,则解决方案会生成一个值。
ExistingCognitoUserPoolId
(可选输入)
UserPoolId您想要验证此用例的现有 Amazon Cognito 用户池。注意:从部署仪表板部署时,通常会提供此 ID,但在独立部署此用例堆栈时可以省略它。
ExistingCognitoUserPoolClient
(可选输入)
提供用户池客户端(应用程序客户端)以使用现有客户端。如果您不提供用户池客户端,则解决方案会创建一个用户池客户端。只有在您提供时,您才能提供此参数ExistingCognitoUserPoolId。
ExistingCognitoGroupPolicyTableName
(可选输入)
包含用户组策略的 DynamoDB 表的名称。这是由自定义授权方在用例的 API 上使用的。注意:从 Deployment 控制面板部署时通常会提供此名称,但是在独立部署此用例堆栈时,可以省略该名称。
VpcEnabled
No堆栈资源是否部署在 VPC 内。
CreateNewVpc
NoYes如果您希望解决方案为您创建新 VPC 并将其用于此用例,请选择此选项。注意:此参数仅在相关时才VpcEnabled相关Yes。IPAMPoolId
(可选输入)
如果要使用 IPAM 分配 CIDR 范围,请提供要使用的 IPAM 池 ID。注意:此参数仅在 “是”
Yes和 CreateNewVpc“VpcEnabled是” 时才相关No。ExistingVpcId
(可选输入)
用于该用例的现有 VPC 的 VPC ID。注意:此参数仅在 “是”
Yes和 CreateNewVpc“VpcEnabled是” 时才相关No。ExistingPrivateSubnetIds
(可选输入)
用于部署 Lambda 函数 IDs 的现有私有子网的子网列表,以逗号分隔。注意:此参数仅在 “是”
Yes和 CreateNewVpc“VpcEnabled是” 时才相关No。ExistingSecurityGroupIds
(可选输入)
用于配置 Lambda 函数的现有 VPC 的安全组列表,以逗号分隔。注意:此参数仅在 “是”
Yes和 CreateNewVpc“VpcEnabled是” 时才相关No。VpcAzs
(可选输入)
以逗号分隔的列表,列出了 AZs 在哪些子网中创建的 VPCs
注意:只有在 “是”
Yes和 VpcEnabledCreateNewVpc“是” 时才相关No。BedrockAgentId
<Requires input>要使用的亚马逊 Bedrock Agent 的 ID。
BedrockAgentAliasId
<Requires input>要使用的亚马逊 Bedrock Agent 的别名 ID。
部署用户界面
Yes选择用于部署此部署的前端聊天用户界面的选项。选择
No后会创建用于托管的基础架构 APIs、身份验证以及不使用聊天界面的后端处理。 APIs -
选择 Next(下一步)。
-
在配置堆栈选项页面上,请选择下一步。
-
在审核页面上,审核并确认设置。选中确认模板将创建 IAM 资源的复选框。
-
选择 Create stack(创建堆栈)以部署堆栈。
您可以在 AWS CloudFormation 控制台的 “状态” 列中查看堆栈的状态。您将在大约 10-30 分钟后收到 “创建完成” 状态。