AgentCoreの実行基盤

AgentCore でエージェントを組むときにまず決めるのは、AIエージェントの本体をどこで動かすか です。ユーザからの質問を受け取ってモデルにツール呼び出しを要求させ、結果をまた次のモデル呼び出しに渡して、最終回答が返ってくるまで繰り返す、この一連の流れを オーケストレーションループ と呼びます。AgentCore は、このループを動かすための実行方式として Harness と Runtime の2つを用意しています。

1. Harness

Harness は、エージェントのオーケストレーションループそのものをマネージドで提供する仕組みです。使いたいモデル・ツール・システムプロンプトを YAML などの設定ファイル(以降 config と呼びます)に書き並べるだけで、AWS 側がツール呼び出しループを実行してくれます。

モデルの応答を見てツールを実行し、その結果をまたモデルに渡す、というループを Lambda などで自前実装しようとすると、ループ制御・ツール名の分岐・実行結果の詰め直し・上限回数の管理などを全部自分でコードに書く必要があります。Harness はこれらを config 宣言だけで肩代わりしてくれるので、標準的なツール呼び出しループで足りるケースなら、最短ルートで立ち上げられます。

2. Runtime

Runtime は、エージェント本体のコードを動かすサーバレスな実行基盤です。セッション単位で分離された環境が提供され、Harness もこの Runtime の上で動きます。

Runtime を直接使う場合は、ループ処理を自分でコードに書き(Strands や LangChain などのフレームワークと組み合わせる)、それを Runtime へデプロイします。デプロイ方式は、Python コードと依存を zip に固める Direct Code Deployment と、Dockerfile でイメージを組み立てる コンテナデプロイ の2つから選べます。試作・素早い反復には Direct Code Deployment が向き、独自のシステム依存や既存のコンテナ CI/CD パイプラインと組み合わせたい場合はコンテナデプロイが向きます。独自のループ・多段構成のオーケストレーション・独自フレームワークを使いたい場合に、Runtime を選びます。

3. Harness と Runtime の使い分け

観点 Harness Runtime
オーケストレーションループ AWSが提供する。configで宣言する 自分でコードに書く(Strandsなどのフレームワークと組み合わせる)
主な変更単位 configを更新する コードを書き換えて再デプロイする(Direct Code Deploymentならzip、コンテナデプロイならイメージを再ビルド)
モデル切り替え configの1フィールドを書き換える コード内のモデル指定を書き換える
フレームワーク選択 選べない(AWSが管理する標準ループ) Strands・LangChainなど任意に選べる
向いているケース 標準的なツール呼び出しループでよい/最短で立ち上げたい 独自のループ・多段構成・独自フレームワークが必要

Harness と Runtime の機能ごとの違いは AgentCore harness vs. Runtime(AWS公式ドキュメント) に一覧があります。「まず Harness で立ち上げ、標準ループで足りない場面が出たときに Runtime へ寄せる」進め方が公式でも推奨されています。本講座のハンズオンも、先に Harness で最短ルートを体験し、そのあと Runtime で自分のループを書く順番で進めます。