@@ -769,6 +769,67 @@ const envs: Record<string, Partial<StackInput>> = {
769769}
770770```
771771
772+ > [ !NOTE]
773+ > AgentCore ユースケースの設定を有効後に、再度無効化する場合は、` createGenericAgentCoreRuntime: false ` にして再デプロイすればAgentCore ユースケースは無効化されますが、` AgentCoreStack ` 自体は残ります。マネージメントコンソールを開き、` agentCoreRegion ` の CloudFormation から ` AgentCoreStack ` というスタックを削除することで完全に消去ができます。
774+
775+ #### AgentCore Runtime のネットワーク設定
776+
777+ AgentCore Runtime は以下のネットワークモードで動作できます:
778+
779+ - ` PUBLIC ` (デフォルト): パブリックネットワークで動作
780+ - ` PRIVATE ` : VPC内のプライベートネットワークで動作
781+
782+ ネットワーク設定は、Generic Runtime と AgentBuilder Runtime の両方に適用されます。
783+
784+ ** VPCモードの使用場面** :
785+
786+ - AgentCore Runtime から社内システムやプライベートデータベースにアクセスする必要がある場合
787+ - 例えば、VPC内の他のAWSサービス(RDS、ElastiCache等)と直接通信したい場合
788+
789+ VPC モードを使用する場合は、以下のパラメータを設定してください:
790+
791+ - ` agentCoreNetworkType ` : ` PRIVATE ` に設定
792+ - ` agentCoreVpcId ` : 使用するVPCのID
793+ - ` agentCoreSubnetIds ` : 使用するサブネットのIDリスト
794+
795+ > [ !IMPORTANT]
796+ > ** Availability Zone (AZ) サポート** : AgentCore RuntimeはリージョンごとにサポートされているAZが限定されています。サブネットは必ずサポートされているAZ内に配置してください。詳細は[ AWS公式ドキュメント] ( https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/agentcore-vpc.html#agentcore-supported-azs ) をご確認ください。
797+ >
798+ > ** インターネットアクセス** : AgentCore Runtime で MCP サーバーのインストールにはインターネットアクセスが必要です。プライベートサブネットが接続先の場合には NAT Gateway への経路を設定してください。
799+
800+ ** [ parameter.ts] ( /packages/cdk/parameter.ts ) を編集**
801+
802+ ``` typescript
803+ // parameter.ts
804+ const envs: Record <string , Partial <StackInput >> = {
805+ dev: {
806+ createGenericAgentCoreRuntime: true ,
807+ agentBuilderEnabled: true ,
808+ agentCoreNetworkType: ' PRIVATE' ,
809+ agentCoreVpcId: ' vpc-xxxxxxxxx' ,
810+ agentCoreSubnetIds: [' subnet-xxxxxxxxx' , ' subnet-yyyyyyyyy' ],
811+ },
812+ };
813+ ```
814+
815+ ** [ packages/cdk/cdk.json] ( /packages/cdk/cdk.json ) を編集**
816+
817+ ``` json
818+ // cdk.json
819+ {
820+ "context" : {
821+ "createGenericAgentCoreRuntime" : true ,
822+ "agentBuilderEnabled" : true ,
823+ "agentCoreNetworkType" : " PRIVATE" ,
824+ "agentCoreVpcId" : " vpc-xxxxxxxxx" ,
825+ "agentCoreSubnetIds" : [" subnet-xxxxxxxxx" , " subnet-yyyyyyyyy" ]
826+ }
827+ }
828+ ```
829+
830+ > [ !WARNING]
831+ > VPCモードを使用する場合、AgentCore Runtime削除時にセキュリティグループが自動削除されません。AgentCore Runtimeが作成するマネージドENIがセキュリティグループを参照するため、CloudFormationでは削除できません。AgentCore Runtime削除後、マネージドENIが自動削除されるまで待ってから、手動でセキュリティグループを削除してください。削除が必要なセキュリティグループIDはCloudFormationの出力に表示されます。
832+
772833### 音声チャットユースケースの有効化
773834
774835> [ !NOTE]
0 commit comments