テンプレートで生成されたコードの確認
「テンプレートから始める」で作成したランタイムには、AWSが用意したサンプルコード(Strands agent テンプレート)が S3 バケットに zip 形式で配置されています。ここでは、その zip をダウンロードして中身を眺め、Runtime に載っているコードがどのような構成になっているかを確認します。中身を書き換えれば任意の自作エージェントを Runtime で動かせる、という次のステップに繋がる感覚をつかむのが目的です。
1. S3バケットからのサンプルコードのダウンロード
MyRuntime の詳細画面で、エージェントとツールの詳細 パネルの エージェントソース に表示されている S3 URI(bedrock-agentcore-runtime-<...> バケット配下)を確認します。
S3コンソールで対象のバケットを開くと、テンプレートから生成された zip ファイルが1つ配置されています(<数字>-<ランダム文字列>-strands_agent.zip の形式)。zip ファイルにチェックを入れてダウンロードをクリックし、ローカルに保存します。
ダウンロードした zip を任意の場所で展開すると、以下のような2ファイル構成になっていることが確認できます。
main.py: エージェントのエントリポイントとなるファイル。Strandsベースのシンプルなエージェントが実装されているrequirements.txt: Runtimeが自動でインストールする Python 依存パッケージ(bedrock-agentcoreとstrands-agents)を宣言する
2. main.pyとrequirements.txtの中身確認
main.py を Visual Studio Code などのエディタで開くと、前のセクションでランタイム作成時に Strands agent の詳細 パネルの コードプレビュー で見たものと同じ内容が入っています。
from bedrock_agentcore import BedrockAgentCoreApp
from strands import Agent
app = BedrockAgentCoreApp()
agent = Agent(model="global.anthropic.claude-haiku-4-5-20251001-v1:0")
@app.entrypoint
def invoke(payload):
"""Your AI agent function"""
user_message = payload.get("prompt", "Hello! How can I help you today?")
result = agent(user_message)
return {"result": result.message}
if __name__ == "__main__":
app.run()
bedrock-agentcore(AgentCore Runtime SDK)と strands-agents(Strands Agents SDK)の2つを使って、prompt を受け取って応答を返すだけのシンプルなエージェントを表現しているコードです。
requirements.txt の中身は以下の2行だけです。ランタイム側で自動的にインストールされます。
bedrock-agentcore
strands-agents
上記コードの各行の意味、2つのSDKの文法、およびこれを書き換えて自作エージェントを Runtime に載せ替える手順(zip 作成・S3 アップロード・ランタイム更新を agentcore コマンド一発で自動化する流れ)は、次章 AgentCore Runtime SDKを理解しよう で解説します。
ここまでで、コンソールで動いていたエージェントの実体が 「Python コード1ファイル + 依存宣言1ファイルを固めた zip」 だったことが確認できました。
| 💡 ポイント |
|---|
「Runtime に載せる」と聞くと大掛かりに感じるかもしれませんが、実体は S3 に置いた zip ファイル1つです。zip の中身を差し替えて ランタイムを更新 するだけで、Runtime が実行するコードが切り替わります。この単純さを踏まえて次章の SDK と CLI を学ぶと、agentcore コマンドが「zip 作成・S3 アップロード・ランタイム更新をまとめて実行してくれる存在」として理解しやすくなります。 |