翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
コンソールを使用してインスタンスの使用を開始する
このチュートリアルでは、 AWS マネジメントコンソールを使用してインスタンスコンピューティングタイプでエージェントをホストする方法について説明します。まず EC2 インフラストラクチャを定義するキャパシティープロバイダーを作成し、次にそれを使用するエージェントランタイムを作成し、最後にエージェントを呼び出してモニタリングします。
前提条件については、「インスタンスの使用を開始する」を参照してください。
ステップ 1: キャパシティープロバイダーを作成する
-
Amazon Bedrock AgentCore コンソールを開き、ランタイムを選択します。
-
キャパシティープロバイダータブで、キャパシティープロバイダーの作成を選択します。
-
キャパシティープロバイダーの詳細に名前を入力します。有効な文字は文字、数字、アンダースコアです。名前は文字で始まり、最大 48 文字です。
-
オペレーティングシステムの場合は、EC2 インスタンスのオペレーティングシステム (Linux (64 ビット x86) など) を選択します。これにより、環境と互換性のあるソフトウェアとアプリケーションが決まります。
-
許可されたインスタンスタイプでは、ワークロード要件を満たす EC2 インスタンスタイプを最大 30 個選択します。vCPU、メモリ、CPU 製造元でフィルタリングして一致を見つけます。
-
セキュリティで、インスタンスのネットワークアクセスを制御する VPC を選択します。必要に応じて、「追加情報」の下にあるサブネットとコンテナネットワークモードを設定します。
-
(オプション) ストレージ設定で、ボリュームの追加を選択して、永続的ストレージ用の Amazon EBS ボリュームをアタッチします。ボリュームタイプ、サイズ、スループット、IOPS、暗号化を設定します。これにより、ボリューム設定が保存されます。AgentCore はセッションの最初の起動時に各ボリュームを作成します。
-
サービスアクセスで、EC2 インスタンスにアタッチされたインスタンスプロファイル (AgentCore がシステムログを収集するために使用します。エージェントコードにアクセス許可を付与しません) とインフラストラクチャロール (AgentCore がユーザーに代わって EC2 インスタンスを管理するために使用されます) を選択します。既存のロールを使用するか、コンソールで新しいロールを作成できます。
-
[キャパシティープロバイダーを作成] を選択します。キャパシティープロバイダーは
CREATING状態で開始し、設定が検証ACTIVEされると になります。
注記
キャパシティープロバイダーが作成されると、その説明のみを編集できます。インスタンスタイプ、ネットワーク、ストレージなどの他の設定を変更するには、キャパシティープロバイダーを複製し、重複フローで更新を行います。
ステップ 2: キャパシティープロバイダーを使用するエージェントランタイムを作成する
-
Runtime ページで、Create runtime を選択します (または、キャパシティープロバイダーの詳細ページから Host agent/tool を選択します)。
-
エージェントまたはツールの名前を入力します。
-
コンピューティングタイプで、インスタンスを選択します。
-
キャパシティープロバイダーの場合は、既存のキャパシティープロバイダーを選択するか、クイック作成を選択して、事前に設定されたデフォルトをインラインで作成します。
-
エージェント/ツールソースで、ソースタイプを選択し、アーティファクトを指定します。
-
S3 ソース – テンプレートから開始するか、
.zipファイルをアップロードするか、S3 バケット内の既存のオブジェクトを選択します。 -
ECR コンテナ – Amazon ECR コンテナイメージ URI を指定します。
-
-
(オプション) インバウンド認証、詳細設定 (セキュリティ、環境変数)、アクセス許可 (IAM 実行ロールと KMS 暗号化) を設定します。
-
ランタイムの作成 を選択します。AgentCore は、バージョン 1 とそれを指す
DEFAULTエンドポイントを作成します。
注記
ランタイムの作成後にコンピューティングタイプを変更することはできません。
ステップ 3: を呼び出してモニタリングする
-
ランタイムの詳細ページから、テストしてペイロードを指定するか、呼び出しコードの表示スニペットを使用して独自のアプリケーションからエージェントを呼び出します。
-
新しいセッションの最初の呼び出しは、アカウントに EC2 インスタンスをプロビジョニングしてエージェントを起動するため、通常、それ以降の呼び出しよりも時間がかかります。同じセッションへのそれ以降の呼び出しははるかに高速です。AgentCore は、インスタンスを Amazon EC2 マネージドインスタンスとしてプロビジョニングします。これは、EC2 コンソールビューと
DescribeInstancesデフォルトで非表示になります。マネージドインスタンスの可視性の詳細については、「マネージドリソースの可視性設定」を参照してください。 -
ランタイムの詳細ページでオブザーバビリティメトリクスとログとトレースを使用して、セッション、呼び出し、エラー率、リソース消費量をモニタリングします。
ステップ 4: クリーンアップする
アカウントでプロビジョニングされた Amazon EC2 インスタンスと Amazon EBS ボリュームの継続的な料金を回避するには、完了したらこのチュートリアル用に作成したリソースをクリーンアップします。
-
AgentCore が EC2 インスタンスとその永続的ボリュームのプロビジョニングを解除するように、セッションを削除します。セッションで単一のエージェントランタイムを停止しても、インスタンスは終了しません。API オペレーションの詳細については、「 AWS CLI または SDK を使用したインスタンスの開始方法」を参照してください。
-
ランタイム、そのエンドポイント、またはそのバージョンを削除して、ランタイムとキャパシティープロバイダーの関連付けを解除します。
-
ランタイムが参照しない場合は、キャパシティープロバイダーを削除します。