スタンドアロンの Bedrock エージェントユースケースのデプロイ

BedrockAgent.template

UseCaseUUID

<_入力必須_>

アプリケーション内でデプロイされたこのユースケースを識別するための 36 文字の UUIDv4。

UseCaseConfigRecordKey

<入力必須>

チャットプロバイダーの Lambda 関数が実行時に必要とする設定を含むレコードに対応するキー。

テーブル内のレコードには、この値に一致する key 属性と、必要な設定を含む config 属性が必要です。

このレコードは、使用中の場合はデプロイプラットフォームによって入力されます。このユースケースをスタンドアロンでデプロイする場合は、UseCaseConfigTableName で定義されたテーブルに、手動で作成したエントリを追加する必要があります。

UseCaseConfigTableName

<入力必須>`

スタックは、ここで提供されたテーブルからユースケース設定を読み込み、UseCaseConfigRecordKey で定義されたレコードキーを使用します。

DefaultUserEmail

placeholder@example.com

このユースケースのデフォルトユーザーの E メール。このソリューションでは、この E メールの Amazon Cognito ユーザーを作成して、ユースケースへのアクセスに使用します。

ExistingRestApiId

(オプション入力)

使用する既存の API Gateway REST API ID。指定しない場合、新しい API Gateway REST API が作成されます。通常、デプロイダッシュボードからデプロイするときに提供されます。

注: 既存の API を使用すると、複数のスタンドアロンユースケースをデプロイする必要がある場合に、リソースの重複を減らしAPI の管理を簡素化できます。スタンドアロンのユースケースに既存の API を提供する場合、API に必要なルート (複数可) と想定されるモデルが設定されていることを確認する責任があります。必要な事前設定済みの /details ルート (チャット中にユースケースの詳細を取得) と、オプションで /feedback ルート (FeedbackEnabled が Yes に設定されている場合、LLM チャットレスポンスのフィードバックの収集を有効にする) を設定する必要があります。さらに、ExistingApiRootResourceId、ExistingCognitoUserPoolId、および ExistingCognitoGroupPolicyTableName も指定する必要があります。

ExistingApiRootResourceId

(オプション入力)

使用する既存の API Gateway REST API ルートリソース ID。REST API ルートリソース ID は、API の「リソース」セクションでルートリソース (/) を選択することで AWS コンソールから取得できます。リソース ID はリソースの詳細パネルに表示されます。または、REST API で describe API コールを実行して、ルートリソース ID を見つけることもできます。

FeedbackEnabled

No

[いいえ] に設定すると、デプロイされたユースケーススタックはフィードバック機能にアクセスできなくなります。

CognitoDomainPrefix

(オプション入力)

Amazon Cognito ユーザープールクライアントのドメインを指定する場合は、値を入力します。値を指定しない場合、ソリューションが値を生成します。

ExistingCognitoUserPoolId

(オプション入力)

このユースケースの認証に使用する既存の Amazon Cognito ユーザープールの UserPoolId。注: 通常、デプロイダッシュボードからデプロイする場合にこの ID を指定しますが、このユースケーススタックをスタンドアロンでデプロイする場合は省略できます。

ExistingCognitoUserPoolClient

(オプション入力)

既存のユーザープールクライアント (アプリクライアント) を使用する場合に指定します。ユーザープールクライアントを指定しない場合、ソリューションがクライアントを作成します。このパラメータは、ExistingCognitoUserPoolId を指定した場合にのみ指定できます。

ExistingCognitoGroupPolicyTableName

(オプション入力)

ユーザーグループポリシーを格納する DynamoDB テーブルの名前。これは、ユースケースの API でカスタムオーソライザーによって使用されます。注: 通常、デプロイダッシュボードからデプロイする場合にこの名前を指定しますが、このユースケーススタックをスタンドアロンでデプロイする場合は省略できます。

VpcEnabled

No

スタックのリソースを VPC 内にデプロイするかどうか。

CreateNewVpc

No

ソリューションで新しい VPC を作成し、このユースケースで使用する場合は Yes を選択します。注: このパラメータは、VpcEnabled が Yes の場合にのみ該当します。

IPAMPoolId

(オプション入力)

IPAM を使用して CIDR 範囲を割り当てる場合は、使用する IPAM プール ID を指定します。注: VpcEnabled が Yes で、CreateNewVpc が No の場合にのみ該当します。

ExistingVpcId

(オプション入力)

ユースケースに使用する既存の VPC の VPC ID。注: VpcEnabled が Yes で、CreateNewVpc が No の場合にのみ該当します。

ExistingPrivateSubnetIds

(オプション入力)

Lambda 関数のデプロイに使用する既存のプライベートサブネットのサブネット ID のカンマ区切りリスト。注: VpcEnabled が Yes で、CreateNewVpc が No の場合にのみ該当します。

ExistingSecurityGroupIds

(オプション入力)

Lambda 関数の設定に使用する既存の VPC のセキュリティグループのカンマ区切りリスト。注: VpcEnabled が Yes で、CreateNewVpc が No の場合にのみ該当します。

VpcAzs

(オプション入力)

VPC のサブネットが作成される AZ のカンマ区切りリスト

注: VpcEnabled が Yes で、CreateNewVpc が No の場合にのみ該当します。

BedrockAgentId

<入力必須>

使用する Amazon Bedrock エージェントの ID。

BedrockAgentAliasId

<入力必須>

使用する Amazon Bedrock エージェントのエイリアス ID。

DeployUI

Yes

このデプロイでフロントエンドチャット UI をデプロイするかどうかを選択します。No を選択すると、API をホストするインフラストラクチャ、API の認証、バックエンド処理が、チャット UI なしで作成されます。