ハンズオンの概要

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」であることを確認します。最後に作成したリソースを削除します。