プロジェクトの準備

agentcore create コマンドで、コンテナデプロイ用のプロジェクトのフォルダ構造と雛形のコードを対話ウィザードから作成します。まず作業用の親フォルダを準備します。

任意の場所に agentcore-container-handson フォルダを作成し、Visual Studio Codeの「ファイル」→「フォルダーを開く」から、作成した agentcore-container-handson フォルダを開きます。以降の操作は、Visual Studio Codeのターミナルから行います。

agentcore-container-handson  ← このフォルダを作成

ターミナルから対話ウィザードを起動します。

agentcore create

ウィザードが順に質問してくるので、以下のように選択・入力します。Project name と What would you like to build? を答えると、続けて Add Agent の対話が始まり、Agent name 以降を順に選んでいきます。Build で Container を選ぶのが、コンテナデプロイのポイントです。

質問 選択・入力する値 設定の基準
Project name MyContainerAgent ハンズオン用に分かりやすい名前を付ける
What would you like to build? Agent Runtimeにコードベースのエージェントをデプロイする(Harness はコード不要のマネージド構成、Skip は後からリソースを追加する用途)
Agent name MyContainerAgent プロジェクトと同じ名前で識別しやすくする
Select agent type Create new agent 雛形からエージェントを新規作成する(既存コードの持ち込みや Bedrock Agents からの取り込みではない)
Language Python Strands Agents SDK を使って Python で実装する
Build Container 本章のポイント。Docker でイメージをビルドして ECR 経由でデプロイする方式を選ぶ
Protocol HTTP 標準のHTTPエージェントとして動かす(MCP・A2A・AG-UI は特定プロトコル向け)
Framework Strands Agents SDK 短いコードでツール呼び出しループを書ける、公式推奨のフレームワークを使う
Model Amazon Bedrock Bedrockで提供されるAnthropic Claudeを使う
Memory None 今回は会話履歴のマネージド保存は使わない
Customize advanced settings 何も選択せずEnter VPC接続やカスタム認証など高度な設定は今回は使わない
Review Configuration Y または Enter 表示された内容で確定する

確定すると、以下のような完了画面が表示されます。[done] が5つ並び(プロジェクトディレクトリ作成・エージェント追加・Python 環境準備・agentcore/ ディレクトリ準備・Git リポジトリ初期化)、Created: の下に生成された上位構造(app/MyContainerAgent/ と agentcore/)と使用モデル(us.anthropic.claude-sonnet-4-5-20250514-v1:0 via Bedrock)が表示されます。末尾の Next: に、この後のステップ(agentcore dev コマンドでローカル動作確認、または agentcore deploy コマンドでデプロイ)が案内されます。

生成されるプロジェクトの詳細は以下のような構成です。Container を選んだので、app/MyContainerAgent/ 配下に Dockerfile が含まれます。

agentcore-container-handson/
└── MyContainerAgent/
    ├── agentcore/
    │   ├── agentcore.json
    │   ├── aws-targets.json
    │   └── cdk/
    └── app/
        └── MyContainerAgent/
            ├── main.py       # エージェントのエントリポイント
            ├── Dockerfile    # ← Build type: Container を選んだ場合に生成される
            ├── requirements.txt
            └── ...

MyContainerAgent/ フォルダが生成され、その中に Dockerfile が入っていれば、プロジェクトの作成は完了です。