コンソールからのAgentCore Runtime作成

Amazon Bedrock AgentCoreコンソールから、「テンプレートから始める」オプションで最短のRuntimeを作成します。AWSが用意したサンプルコードがS3に自動配置され、そこからRuntimeがデプロイされる仕組みで、コード準備なしにRuntimeの動きを体験できます。

1. ランタイムの作成

1.1 ランタイム作成画面の表示

マネジメントコンソールで Amazon Bedrock AgentCore コンソール を開き、左メニューの「構築」からランタイムを選択します。「ランタイム」画面の右上にあるランタイムを作成をクリックすると、「ランタイムを作成」画面が開きます。

1.2 設定値の入力

以下の値を入力・選択します。

設定項目 値 設定の基準
名前 MyRuntime ハンズオン用に分かりやすい名前をつける
ソースタイプ S3ソース(既定) 今回はS3経由のCodeZipで作成する
S3設定 テンプレートから始める(既定) AWSが用意したサンプルコードで最短スタートするため
テンプレートを選択 Strands agent(Python 3.13) 後続のセクションでも Strands Agents SDK を扱うため、コンソール版もStrandsに揃える。Otel agent はオブザーバビリティ、Streaming agent はストリーミング応答という要素が加わったテンプレートなので、まず基本的な動きを確認するにはシンプルな Strands agent を選ぶ
保存先フォルダ 既定のまま 「テンプレートから始める」を選ぶと、AWSが自動的にサンプルコード配置用のS3バケット(bedrock-agentcore-runtime-<...>)を設定する
IAMアクセス許可 デフォルトロールを作成(既定) ランタイム用のIAMロール(AmazonBedrockAgentCoreRuntimeDefaultServiceRole-XXXX)をAWS側で自動作成させる

ランタイムの詳細セクションで、名前に MyRuntime を入力します。

エージェントソースセクションで、ソースタイプに S3ソース、S3設定に テンプレートから始める、テンプレートに Strands agent(Python 3.13)を選択します。保存先フォルダは自動で設定される既定値のままにします。

テンプレートを選択すると、その下の Strands agent の詳細 パネルで、選択したテンプレートのエントリーポイント(main.py)と、実際にデプロイされるサンプルコードのプレビューが表示されます。サンプルコードは Agent にモデルIDだけを渡し、prompt を受け取って応答を返すシンプルな Strands エージェントであることが確認できます。

Permissionsセクションでは、IAMアクセス許可を デフォルトロールを作成(既定)のままにします。ランタイム用のIAMロールがAWS側で自動作成されます。

インバウンド認証・ファイルシステムの設定 - オプション・高度な設定はいずれも既定のままにし、右下のランタイムを作成をクリックします。

1.3 作成完了の確認

作成が始まると、画面上部に「MyRuntime をプロビジョニングしています。これには最大 1 分かかることがあります。」というバナーが表示されます。ここではページを離れずに待ちます。

プロビジョニングが完了すると、MyRuntime の詳細画面に自動で遷移します。上部に「MyRuntime、バージョン 1 は正常に作成されました。」の緑色バナーが表示され、エージェントとツールの詳細パネルには、名前・ランタイム ARN・ステータス・ソースタイプなどが並びます。この時点ではエンドポイント一覧の DEFAULT のステータスはまだ作成中です。

数十秒ほど待ってページを再読み込みすると、エンドポイント一覧の DEFAULT のステータスが準備完了に変わります。ここまで来れば、コンソールからのランタイム作成は完了です。

2. 作成されたランタイムの確認

一覧から MyRuntime をクリックして詳細画面を開き、上から順にどのようなランタイムが作成されたのかを見ていきます。

2.1 エージェントとツールの詳細

画面上部のエージェントとツールの詳細パネルには、名前・作成日・ソースタイプ・ランタイム ID・ランタイム ARN・ステータスなどが並びます。特に押さえておきたいのは以下です。

  • ランタイム ARN: arn:aws:bedrock-agentcore:ap-northeast-1:<アカウントID>:runtime/MyRuntime-XXXXXX の形式で払い出される。外部からランタイムを呼び出すときはこのARNを使う
  • ソースタイプ: S3。作成時に選んだCodeZip方式であることを示す
  • ステータス: 準備完了 になっていれば、実際に呼び出せる状態になっている

右上には削除・ランタイムを更新・テストのボタンが並んでいます。この後の動作確認ではテストボタンから呼び出しを行います。

2.2 呼び出しコードを表示

呼び出しコードを表示パネルには、このランタイムを外部のアプリケーションから呼び出す際に使うサンプルコードが表示されます。Python・TypeScript・JavaScript の3言語から選んで確認できます。Python のサンプルは、boto3 で bedrock-agentcore クライアントを作成し、invoke_agent_runtime に agentRuntimeArn・runtimeSessionId・payload を渡すシンプルな構成になっています。今回はこの後のセクションでコンソールのテスト機能から動作確認するため直接は使いませんが、外部アプリケーションから呼び出す場合はこのコードがそのまま土台になります。

2.3 エンドポイント

AgentCore におけるエンドポイントは、クライアントがランタイムを呼び出すときの入口で、それぞれが特定のバージョンに紐づけられます。クライアントはエンドポイント名を指定して呼び出すため、ランタイムの設定を更新したときも、エンドポイントに割り当てるバージョンを差し替えるだけで済み、クライアント側のコードを書き換えずにバージョンを切り替えられる作りになっています。

エンドポイントパネルには、作成時点で DEFAULT エンドポイントが自動作成されています。DEFAULT は常に最新バージョンに追従するエンドポイントです。バージョンを固定して呼び出したい場合や、新しいバージョンを段階的に切り替えたい場合は、右上のエンドポイントを作成から別のエンドポイントを作ってそこに特定バージョンを割り当てます。

2.4 バージョン

バージョンパネルには、バージョン 1 が自動で作られています。ランタイムは設定を更新するたびに新しいバージョンのスナップショットが作られ、DEFAULT エンドポイントは常に最新バージョンを指す形になります。ロールバックや過去バージョンとの比較を行うときはこの単位で扱います。

2.5 オブザーバビリティ

オブザーバビリティパネルには、ランタイムセッション数・ランタイム呼び出し数・エラー率・スロットリングレート・vCPU消費量・メモリ消費量が並び、時間範囲を5m / 30m / 1h / 3h / 12h / 1d から切り替えられます。作成直後はすべて 0 ですが、この後のテストでランタイムを呼び出すと、ここに値が入ってきます。トレースやログを含む詳細な可視化は AgentCore Observabilityでエージェントを可視化しよう で扱います。

2.6 ログの配信とトレース

ログの配信とトレース - オプションパネルでは、ランタイムのログとトレースを CloudWatch へ配信する設定を追加できます。ログ配信は初期状態では未設定、Tracingは Not enabled で、有効化するには CloudWatch の Transaction Search を先に設定する必要があります。これらの設定は AgentCore Observabilityでエージェントを可視化しよう で扱うため、この章では既定のままにします。

2.7 リソースベースのポリシー

リソースベースのポリシーパネルは、他のAWSアカウントやサービスにこのランタイムへのアクセスを許可するためのポリシー設定です。単一アカウント内で使う今回のハンズオンでは設定不要なので、表示するポリシーがありません のままにします。

2.8 タグ

タグパネルは、コスト配分やリソース管理のためのタグを付与する場所です。他のAWSリソースと同じ仕組みで、今回のハンズオンでは設定不要なので、タグなし のままにします。

3. ランタイム詳細画面での動作確認

ランタイムの各パネルを確認したら、実際に呼び出して動作を試します。詳細画面右上のテストボタンをクリックすると、コード不要で呼び出しを試せる画面が開きます。

テスト画面では、ランタイムエージェントとエンドポイントにそれぞれ MyRuntime と DEFAULT が自動で選択されています。セッション IDは空欄のままで、実行時に新しいセッションが自動生成されます。入力欄に以下のJSONを入力し、右下の実行をクリックします。

{
  "prompt": "こんにちは、自己紹介をお願いします"
}

出力欄に、モデルからの応答が返ってきます。「テンプレートから始める」で作成したサンプルコードは、受け取った prompt をそのまま Agent に渡して結果を返すシンプルな Strands エージェントとして動作するため、Claude による自己紹介文が箇条書きを交えた形で返ってくれば、コンソールから作成したランタイムが動作している状態です。

コンソールだけで、コードを一切書かずに Runtime が動く状態まで持って行けました。ここまでで「Runtimeという層で何が動くのか」を体感できたので、次のセクションでは、このランタイムに載っているテンプレートコードの実物を S3 から取り出して中身を確認します。