動作確認
作ったエージェントの動作を、以下2つの方法で段階的に確認していきます。
agentcore devによる動作確認 —agentcore devコマンドがローカル Docker でコンテナを起動し、ブラウザの Agent Inspector(対話 UI)から呼び出して検証する- AgentCoreへの反映 —
agentcore deployコマンドでクラウドの AgentCore Runtime にデプロイし、CLI から呼び出して動作を確認する
いずれの方法でも、以下の2つが事前に整っている必要があります。
- AWS 認証情報の設定 — Bedrock のモデルを呼び出すため、
aws configureで対象の AWS アカウントの認証情報を~/.aws/credentialsに保存しておきます。設定手順は事前準備の AWS CLIのインストール を参照 - Docker Desktop の起動 — 両方法とも内部で Docker を利用します(
agentcore devコマンドは Container ビルドのプロジェクトでは内部で docker build を走らせるため、agentcore deployと同様に Docker が必要)
1. agentcore dev による動作確認
agentcore dev コマンドは、Container ビルドのプロジェクトの場合、内部で Docker イメージをビルドしてローカルでコンテナを起動し、ブラウザで Agent Inspector(HTTP エンドポイントを対話 UI から叩けるツール)を開きます。Agent Inspector 経由で対話的にプロンプトを投げてクラウドデプロイ前に動作を確認できるので、main.py を書き換えた直後の検証にちょうど良い流れです。
まず、Docker Desktop が起動していない場合は、アプリケーション一覧から Docker.app を起動します。起動が完了すると、Mac ではメニューバーに Docker のクジラアイコンが表示され、Docker Desktop 画面上のインジケーターが Docker Desktop is running になります。
以下のコマンドで、Docker がインストールされていることを確認します。
docker --version
以下のように Docker のバージョンが表示されれば、インストールは確認できています。
Docker version 27.x.x, build xxxxxxx
バージョンが表示されない場合は、Docker Desktopのインストール を先に実施してください。
インストールが確認できたら、続いてターミナルから Docker Desktop との疎通を確認します。
docker ps
以下のようにヘッダ行が返れば、Docker との通信は確立できています(起動中のコンテナがない場合はヘッダ行だけが返ります)。
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
⚠️ Cannot connect to the Docker daemon や Container build failed (exit code 1) が出る場合 |
|---|
Docker Desktop が起動していない可能性が高いです。Docker.app を起動して Docker Desktop is running になるまで待ってから、再度 docker ps コマンドで疎通確認してください。この状態が整うまで、この節と続く AgentCoreへの反映 節はいずれも動きません。 |
Docker との疎通が確認できたら、MyContainerAgent フォルダに移動してから agentcore dev コマンドを起動します。
cd MyContainerAgent
agentcore dev
初回は Docker イメージのビルド(ARM64 向けのベースイメージ pull と依存関係のインストール)で数分かかります。完了するとブラウザで Agent Inspector が開くので、チャット欄に以下のプロンプトを送信します。
田中太郎(開発部 エンジニア、tanaka@example.com)のメール署名を作って
装飾線付きの署名(【田中太郎】DevOps株式会社 開発部 エンジニア を含む形式)が応答に含まれて返れば、コード自体は正しく動く状態です。
⚠️ Public ECR で 403 Forbidden エラーが出る場合 |
|---|
agentcore dev コマンドのビルド中に public.ecr.aws/docker/library/python:...: 403 Forbidden のようなエラーが出る場合、ネットワーク環境から Public ECR(public.ecr.aws)へのアクセスができていない可能性があります。app/MyContainerAgent/Dockerfile の1行目 FROM public.ecr.aws/docker/library/python:3.12-slim-trixie を FROM python:3.12-slim に書き換えて、Docker Hub 直接参照に切り替えることで回避できます。書き換えて保存したら、再度 agentcore dev コマンドを実行してください。 |
| ⚠️ ブラウザが自動で開かない場合 |
|---|
agentcore dev コマンドの出力に表示される URL(既定は http://localhost:8080)を手動でブラウザで開いてください。ポートが既に使用中の場合は、agentcore dev --port 8090 のように別ポートを指定できます。 |
2. AgentCoreへの反映
ローカルで動作が確認できたら、agentcore deploy コマンドでコンテナをビルドしてクラウドの AgentCore Runtime にデプロイします。実行するコマンド自体は前章の Direct Code Deployment のときと同じで、Container ビルドを選んだプロジェクトでは Docker ビルドと ECR push が自動的に走ります。
MyContainerAgent プロジェクトフォルダに移動してから実行します。
cd MyContainerAgent
agentcore deploy
agentcore deploy コマンドは、docker buildx による ARM64 向けのイメージビルド、ECR リポジトリの自動作成、イメージの push、AgentCore Runtime への反映、CloudWatch のロギング設定までを、CDK 経由でまとめて実行します。初回は CDK bootstrap と ARM64 ビルドで数分〜十数分かかります。
完了すると、以下のように CDK パイプラインの各ステップが [done] に切り替わり、✓ Deploy to AWS Complete が表示されます。
マネジメントコンソールで Amazon Bedrock AgentCore の「ランタイム」画面を開くと、MyContainerAgent_MyContainerAgent(プロジェクト名 + _ + エージェント名)というランタイムがステータス「準備完了」で登録されていることが確認できます。
デプロイが完了したら、AgentCore CLI から MyContainerAgent を呼び出して、クラウド側でも同じ応答が返ることを確認します。
agentcore invoke --prompt "田中太郎(開発部 エンジニア、tanaka@example.com)のメール署名を作って"
以下のように、エージェントからの自然文の中に装飾線付きの署名テキストが含まれた形で返ります。応答の下には、AgentCore が発行したセッション ID と、同じセッションを継続するためのコマンド、ログの保存先が表示されます。
田中太郎さんのメール署名が完成しました!こちらをご利用ください:
━━━━━━━━━━━━━━━━━━━━━━
【田中太郎】DevOps株式会社 開発部 エンジニア
Email: tanaka@example.com
Tel: 03-1234-5678
━━━━━━━━━━━━━━━━━━━━━━
会社名(DevOps株式会社)と代表電話番号(03-1234-5678)は自動で付与されています。何か修正が必要な場合はお知らせください!
Session: 34d66f2a-789d-4382-a6f4-38cc7501fd45
To resume: agentcore invoke --session-id 34d66f2a-789d-4382-a6f4-38cc7501fd45
Log: agentcore/.cli/logs/invoke/invoke-MyContainerAgent-20260726-211955.log
会社名(DevOps株式会社)と代表電話番号(03-1234-5678)はユーザから入力していないのに応答に含まれているため、これが「コンテナ内で create_signature ツールが実際に呼ばれた証拠」になります。マネジメントコンソールで対象のエージェントの Observability 画面を開くと、ツール呼び出し・レイテンシ・トークン数などのトレース情報が確認できます。デプロイの中身が zip でもコンテナでも、呼び出し側から見た振る舞いは同じというのが、AgentCore Runtime が提供する抽象化のメリットです。