View a markdown version of this page

部署独立的 Bedrock Agent 用例 - AWS 上的生成式人工智能应用程序构建者

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

部署独立的 Bedrock Agent 用例

按照本节中的 step-by-step说明配置解决方案并将其部署到您的账户。

部署时间:大约 10-30 分钟

  1. 登录 A WS 管理控制台并选择启动 CloudFront 模板的按钮。

    BedrockAgent。模板

    Launch solution

  2. 默认情况下,该模板在美国东部(弗吉尼亚州北部)区域启动。要在其他 AWS 区域启动解决方案,请使用控制台导航栏中的区域选择器。

    注意

    此解决方案使用 Amazon Bedrock,但目前并非在所有 AWS 区域都可用。如果您正在使用这些功能,则必须在提供这些服务的 AWS 地区启动此解决方案。有关各地区的最新可用性,请参阅 AWS 区域服务列表

  3. 创建堆栈页面上,确认 Amazon S3 URL 文本框中已有正确的模板 URL,然后选择下一步

  4. 指定堆栈详细信息页面上,为您的解决方案堆栈分配一个名称。有关命名字符限制的信息,请参阅 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 配额]。

  5. 参数下,检查该解决方案模板的参数,并根据需要进行修改。该解决方案使用以下默认值。

    参数 默认条目 说明

    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 路由(如果设置FeedbackEnabledYes为启用收集 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

    No

    Yes如果您希望解决方案为您创建新 VPC 并将其用于此用例,请选择此选项。注意:此参数仅在相关时才VpcEnabled相关Yes

    IPAMPoolId

    (可选输入)

    如果要使用 IPAM 分配 CIDR 范围,请提供要使用的 IPAM 池 ID。注意:此参数仅在 “是” YesCreateNewVpcVpcEnabled是” 时才相关No

    ExistingVpcId

    (可选输入)

    用于该用例的现有 VPC 的 VPC ID。注意:此参数仅在 “是” YesCreateNewVpcVpcEnabled是” 时才相关No

    ExistingPrivateSubnetIds

    (可选输入)

    用于部署 Lambda 函数 IDs 的现有私有子网的子网列表,以逗号分隔。注意:此参数仅在 “是” YesCreateNewVpcVpcEnabled是” 时才相关No

    ExistingSecurityGroupIds

    (可选输入)

    用于配置 Lambda 函数的现有 VPC 的安全组列表,以逗号分隔。注意:此参数仅在 “是” YesCreateNewVpcVpcEnabled是” 时才相关No

    VpcAzs

    (可选输入)

    以逗号分隔的列表,列出了 AZs 在哪些子网中创建的 VPCs

    注意:只有在 “是” YesVpcEnabledCreateNewVpc“是” 时才相关No

    BedrockAgentId

    <Requires input>

    要使用的亚马逊 Bedrock Agent 的 ID。

    BedrockAgentAliasId

    <Requires input>

    要使用的亚马逊 Bedrock Agent 的别名 ID。

    部署用户界面

    Yes

    选择用于部署此部署的前端聊天用户界面的选项。选择No后会创建用于托管的基础架构 APIs、身份验证以及不使用聊天界面的后端处理。 APIs

  6. 选择 Next(下一步)。

  7. 配置堆栈选项页面上,请选择下一步

  8. 审核页面上,审核并确认设置。选中确认模板将创建 IAM 资源的复选框。

  9. 选择 Create stack(创建堆栈)以部署堆栈。

您可以在 AWS CloudFormation 控制台的 “状态” 列中查看堆栈的状态。您将在大约 10-30 分钟后收到 “创建完成” 状态。