プロジェクトの準備
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 が入っていれば、プロジェクトの作成は完了です。