ハンズオンの概要
AgentCore Runtimeは、AIエージェントのコードを動かすためのサーバレス実行基盤です。エージェントごとに独立した実行環境(セッション)が用意され、外部からは共通の呼び出しAPI(InvokeAgentRuntime)で叩けます。
1. AgentCore Runtimeとは
AgentCore Runtimeは、AIエージェントのコードを動かすためのサーバレス実行基盤です。エージェントごとに独立した実行環境(セッション)が用意され、外部からは共通の呼び出しAPI(InvokeAgentRuntime)で叩けます。Lambdaと違い、セッション単位の状態保持や、長時間の対話にも向いています。
AgentCoreハーネスは、実はこのRuntimeの上に載っている「オーケストレーションループそのものをマネージドで提供する抽象」です。ハーネスはconfigで宣言するだけで済む代わりに、ループの構造はAWSが決めた形に従います。Runtimeを直接扱うと、フレームワーク(Strandsなど)の選択・ループの多段化・独自の分岐など、コードで自由に組める代わりに、書くべきコード量が増えます。両者の機能ごとの違いは AgentCore harness vs. Runtime(AWS公式ドキュメント) に一覧があります。
2. AgentCore Runtimeへのデプロイ方式
AgentCore Runtimeには、エージェントコードをデプロイする方式が2種類あります。
| デプロイ方式 | 概要 | 主な向き先 |
|---|---|---|
| Direct Code Deployment(CodeZip) | Pythonコードと依存パッケージをzipに固めてS3経由でデプロイする。Docker不要で扱える | 試作・素早い反復や、共通のフレームワークで完結する構成に向く |
| コンテナデプロイ(Container) | Dockerfileでコンテナイメージを組み立て、ECR経由でデプロイする | 独自のシステム依存を含む構成や、既存のコンテナCI/CDパイプラインとの統合に向く |
本章では Direct Code Deployment(CodeZip)を扱います。CodeZip をローカルCLIで自動化する流れは次章 AgentCore Runtime SDKを理解しよう で、コンテナデプロイは AgentCore Runtimeにコンテナデプロイしよう で扱います。
3. ハンズオン全体の流れ
まずマネジメントコンソールから「テンプレートから始める」でRuntimeを1つ作り、コンソール上で動作確認します。続いて、ランタイムに載っているテンプレートコードを S3 バケットからダウンロードして中身を眺め、Runtime が実行しているコードが「Python コード1ファイル+依存宣言1ファイルを固めた zip」であることを確認します。最後に作成したリソースを削除します。