View a markdown version of this page

コンソールを使用してインスタンスの使用を開始する - Amazon Bedrock AgentCore

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

コンソールを使用してインスタンスの使用を開始する

このチュートリアルでは、 AWS マネジメントコンソールを使用してインスタンスコンピューティングタイプでエージェントをホストする方法について説明します。まず EC2 インフラストラクチャを定義するキャパシティープロバイダーを作成し、次にそれを使用するエージェントランタイムを作成し、最後にエージェントを呼び出してモニタリングします。

前提条件については、「インスタンスの使用を開始する」を参照してください。

ステップ 1: キャパシティープロバイダーを作成する

  1. Amazon Bedrock AgentCore コンソールを開き、ランタイムを選択します。

  2. キャパシティープロバイダータブで、キャパシティープロバイダーの作成を選択します。

  3. キャパシティープロバイダーの詳細に名前を入力します。有効な文字は文字、数字、アンダースコアです。名前は文字で始まり、最大 48 文字です。

  4. オペレーティングシステムの場合は、EC2 インスタンスのオペレーティングシステム (Linux (64 ビット x86) など) を選択します。これにより、環境と互換性のあるソフトウェアとアプリケーションが決まります。

  5. 許可されたインスタンスタイプでは、ワークロード要件を満たす EC2 インスタンスタイプを最大 30 個選択します。vCPU、メモリ、CPU 製造元でフィルタリングして一致を見つけます。

  6. セキュリティで、インスタンスのネットワークアクセスを制御する VPC を選択します。必要に応じて、「追加情報」の下にあるサブネットとコンテナネットワークモードを設定します。

  7. (オプション) ストレージ設定で、ボリュームの追加を選択して、永続的ストレージ用の Amazon EBS ボリュームをアタッチします。ボリュームタイプ、サイズ、スループット、IOPS、暗号化を設定します。これにより、ボリューム設定が保存されます。AgentCore はセッションの最初の起動時に各ボリュームを作成します。

  8. サービスアクセスで、EC2 インスタンスにアタッチされたインスタンスプロファイル (AgentCore がシステムログを収集するために使用します。エージェントコードにアクセス許可を付与しません) とインフラストラクチャロール (AgentCore がユーザーに代わって EC2 インスタンスを管理するために使用されます) を選択します。既存のロールを使用するか、コンソールで新しいロールを作成できます。

  9. [キャパシティープロバイダーを作成] を選択します。キャパシティープロバイダーは CREATING状態で開始し、設定が検証ACTIVEされると になります。

注記

キャパシティープロバイダーが作成されると、その説明のみを編集できます。インスタンスタイプ、ネットワーク、ストレージなどの他の設定を変更するには、キャパシティープロバイダーを複製し、重複フローで更新を行います。

ステップ 2: キャパシティープロバイダーを使用するエージェントランタイムを作成する

  1. Runtime ページで、Create runtime を選択します (または、キャパシティープロバイダーの詳細ページから Host agent/tool を選択します)。

  2. エージェントまたはツールの名前を入力します。

  3. コンピューティングタイプで、インスタンスを選択します。

  4. キャパシティープロバイダーの場合は、既存のキャパシティープロバイダーを選択するか、クイック作成を選択して、事前に設定されたデフォルトをインラインで作成します。

  5. エージェント/ツールソースで、ソースタイプを選択し、アーティファクトを指定します。

    • S3 ソース – テンプレートから開始するか、.zipファイルをアップロードするか、S3 バケット内の既存のオブジェクトを選択します。

    • ECR コンテナ – Amazon ECR コンテナイメージ URI を指定します。

  6. (オプション) インバウンド認証、詳細設定 (セキュリティ、環境変数)、アクセス許可 (IAM 実行ロールと KMS 暗号化) を設定します。

  7. ランタイムの作成 を選択します。AgentCore は、バージョン 1 とそれを指すDEFAULTエンドポイントを作成します。

注記

ランタイムの作成後にコンピューティングタイプを変更することはできません。

ステップ 3: を呼び出してモニタリングする

  1. ランタイムの詳細ページから、テストしてペイロードを指定するか、呼び出しコードの表示スニペットを使用して独自のアプリケーションからエージェントを呼び出します。

  2. 新しいセッションの最初の呼び出しは、アカウントに EC2 インスタンスをプロビジョニングしてエージェントを起動するため、通常、それ以降の呼び出しよりも時間がかかります。同じセッションへのそれ以降の呼び出しははるかに高速です。AgentCore は、インスタンスを Amazon EC2 マネージドインスタンスとしてプロビジョニングします。これは、EC2 コンソールビューとDescribeInstancesデフォルトで非表示になります。マネージドインスタンスの可視性の詳細については、「マネージドリソースの可視性設定」を参照してください。

  3. ランタイムの詳細ページでオブザーバビリティメトリクスとログとトレースを使用して、セッション、呼び出し、エラー率、リソース消費量をモニタリングします。

ステップ 4: クリーンアップする

アカウントでプロビジョニングされた Amazon EC2 インスタンスと Amazon EBS ボリュームの継続的な料金を回避するには、完了したらこのチュートリアル用に作成したリソースをクリーンアップします。

  1. AgentCore が EC2 インスタンスとその永続的ボリュームのプロビジョニングを解除するように、セッションを削除します。セッションで単一のエージェントランタイムを停止しても、インスタンスは終了しません。API オペレーションの詳細については、「 AWS CLI または SDK を使用したインスタンスの開始方法」を参照してください。

  2. ランタイム、そのエンドポイント、またはそのバージョンを削除して、ランタイムとキャパシティープロバイダーの関連付けを解除します。

  3. ランタイムが参照しない場合は、キャパシティープロバイダーを削除します。

次の手順