View a markdown version of this page

部署獨立的 Bedrock 代理程式使用案例 - AWS 上的生成式 AI 應用程式建置器

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

部署獨立的 Bedrock 代理程式使用案例

遵循本節中的step-by-step說明，設定解決方案並將其部署到您的帳戶。

部署時間：約 10-30 分鐘

  1. 登入 AWS 管理主控台，然後選取按鈕以啟動 CloudFront 範本。

    BedrockAgent.template

    Launch solution

  2. 根據預設，範本會在美國東部 （維吉尼亞北部） 區域啟動。若要在不同 AWS 區域中啟動解決方案，請使用主控台導覽列中的區域選擇器。

    注意

    此解決方案使用 Amazon Bedrock，目前尚未在所有 AWS 區域提供。如果您使用這些功能，您必須在提供這些服務的 AWS 區域中啟動此解決方案。如需各區域的最新可用性，請參閱 AWS 區域服務清單。

  3. 在建立堆疊頁面上，確認正確的範本 URL 位於 Amazon S3 URL 文字方塊中，然後選擇下一步。

  4. 在指定堆疊詳細資訊頁面上，為您的解決方案堆疊指派名稱。如需有關命名字元限制的資訊，請參閱 AWS Identity and Access Management 使用者指南中的 {https---docs-aws-amazon-com-https---docs-aws-amazon-com-IAM-latest-UserGuide-reference-iam-limits-html}【IAM 和 AWS STS 配額】。

  5. 在參數下，檢閱此解決方案範本的參數，並視需要修改這些參數。此解決方案使用下列預設值。

    參數 預設項目 Description

    UseCaseUUID

    <_需要 input_>

    36 個字元長的 UUIDv4，用於識別應用程式內的此部署使用案例。

    UseCaseConfigRecordKey

    需要輸入

    與記錄對應的索引鍵，其中包含聊天提供者 Lambda 函數在執行時間所需的組態。

    資料表中的記錄必須具有與此值相符的金鑰屬性，以及包含所需組態的組態屬性。

    如果此記錄正在使用，則將由部署平台填入。對於此使用案例的獨立部署，需要在 UseCaseConfigTableName 中定義的資料表中手動建立的項目。

    UseCaseConfigTableName

    <需要 input>`

    堆疊將從此處提供的資料表讀取使用案例組態，並使用 UseCaseConfigRecordKey 中定義的記錄金鑰。

    DefaultUserEmail

    placeholder@example.com

    此使用案例的預設使用者電子郵件。解決方案會為此電子郵件建立 Amazon Cognito 使用者，以存取使用案例。

    ExistingRestApiId

    （選用輸入）

    要使用的現有 API Gateway REST API ID。如果未提供，則會建立新的 API Gateway REST API。從部署儀表板部署時通常會提供 。

    注意：當您需要部署多個獨立使用案例時，使用現有 APIs 有助於減少資源重複並簡化 APIs 的管理。為獨立使用案例提供現有 APIs 時，您需負責確保 API 已設定具有預期模型的必要路由 （含）。必要的預先設定/詳細資訊路由 （在聊天期間擷取使用案例詳細資訊），以及選擇性設定 /feedback 路由 （如果 FeedbackEnabled 設定為 Yes 以啟用 LLM 聊天回應的意見回饋集合）。此外，也必須提供 ExistingApiRootResourceId、 ExistingCognitoUserPoolId 和 ExistingCognitoGroupPolicyTableName。

    ExistingApiRootResourceId

    （選用輸入）

    要使用的現有 API Gateway REST API 根資源 ID。在 API 的「資源」區段中選取根資源 (/)，即可從 AWS 主控台取得 REST API 根資源 ID。資源 ID 隨即會顯示在資源詳細資訊面板中。您也可以在 REST API 上執行描述 API 呼叫，以尋找根資源 ID。

    FeedbackEnabled

    No

    如果設定為否，則部署的使用案例堆疊將無法存取意見回饋功能。

    CognitoDomainPrefix

    （選用輸入）

    如果您想要為 Amazon Cognito 使用者集區用戶端提供網域，請輸入值。如果您不提供值，解決方案會產生一個值。

    ExistingCognitoUserPoolId

    （選用輸入）

    您要驗證此使用案例的現有 Amazon Cognito 使用者集區的 UserPoolId。注意：您通常在從部署儀表板部署時提供此 ID，但在獨立部署此使用案例堆疊時可以省略它。

    ExistingCognitoUserPoolClient

    （選用輸入）

    提供使用者集區用戶端 （應用程式用戶端） 以使用現有的集區用戶端。如果您不提供使用者集區用戶端，解決方案會建立一個。只有在您提供 ExistingCognitoUserPoolId 時，才能提供此參數。

    ExistingCognitoGroupPolicyTableName

    （選用輸入）

    包含使用者群組政策的 DynamoDB 資料表名稱。這是由自訂授權方在使用案例的 API 上使用。注意：您通常在從部署儀表板部署時提供此名稱，但在獨立部署此使用案例堆疊時可以省略它。

    VpcEnabled

    No

    堆疊資源是否部署在 VPC 中。

    CreateNewVpc

    No

    Yes 如果您希望解決方案為您建立新的 VPC，並將其用於此使用案例，請選取 。注意：只有在 VpcEnabled 為 時，此參數才相關Yes。

    IPAMPoolId

    （選用輸入）

    如果您想要使用 IPAM 指派 CIDR 範圍，請提供要使用的 IPAM 集區 ID。注意：只有在 VpcEnabled 為 Yes且 CreateNewVpc 為 時，此參數才相關No。

    ExistingVpcId

    （選用輸入）

    要用於使用案例之現有 VPC 的 VPC ID。注意：只有在 VpcEnabled 為 Yes且 CreateNewVpc 為 時，此參數才相關No。

    ExistingPrivateSubnetIds

    （選用輸入）

    逗號分隔的現有私有子網路 IDs 清單，用於部署 Lambda 函數。注意：只有在 VpcEnabled 為 Yes且 CreateNewVpc 為 時，此參數才相關No。

    ExistingSecurityGroupIds

    （選用輸入）

    以逗號分隔的現有 VPC 安全群組清單，用於設定 Lambda 函數。注意：只有在 VpcEnabled 為 Yes且 CreateNewVpc 為 時，此參數才相關No。

    VpcAzs

    （選用輸入）

    以逗號分隔的 AZs 清單，其中會建立 VPCs 的子網路

    注意：只有在 VpcEnabled 為 Yes且 CreateNewVpc 為 時才相關No。

    BedrockAgentId

    需要輸入

    要使用的 Amazon Bedrock 代理程式 ID。

    BedrockAgentAliasId

    需要輸入

    要使用的 Amazon Bedrock 代理程式別名 ID。

    DeployUI

    Yes

    選取選項以部署此部署的前端聊天 UI。選取 No 會導致建立託管 APIs基礎設施、APIs的身分驗證，以及沒有聊天 UI 的後端處理。

  6. 選擇下一步。

  7. 在 Configure stack options (設定堆疊選項) 頁面，選擇 Next (下一步)。

  8. 在檢視 頁面上，檢視和確認的設定。選取確認範本將建立 IAM 資源的方塊。

  9. 選擇 Create stack (建立堆疊) 以部署堆疊。

您可以在狀態欄的 AWS CloudFormation 主控台中檢視堆疊的狀態。您應該會在大約 10-30 分鐘內收到 CREATE_COMPLETE 狀態。