AgentCore、エージェントが作るWebアプリをブラウザで即時プレビュー

発表されたこと

AWSは、Amazon Bedrock AgentCore runtimeの「Session endpoints」を解説する技術記事を公開しました。コーディングエージェントがセッション内で動かしているWebアプリを、利用者のブラウザからそのまま開いて操作できるようにする仕組みです。エージェントがファイルを保存するたびに画面が更新されるため、「変更を依頼する→結果を見る」というレビューのループをデプロイ待ちなしで回せます。

記事はGitHubリポジトリ agentcore-samples のサンプルを使ったハンズオン形式です。Viteで作ったサイトをセッション内で起動し、左にチャット、右にライブのWebサイトという1枚のページで確認します。エージェントにダークテーマへの切り替えを頼み、作業ステップが流れてくる様子と画面の変化を同時に眺める構成になっています。

Session endpointの仕組み

各セッションには専用のSession endpointが割り当てられます。到達できるポートは、CreateAgentRuntime呼び出し時のallowedPortsで1〜5件指定し、それぞれ単一ポートまたは8000〜12000の範囲で指定します。予約済みのプラットフォームポートは除外され、ポートを許可してもサーバーが起動するわけではないため、アプリ側が0.0.0.0で待ち受ける必要があります。

URLはInvokeAgentRuntimeのレスポンスヘッダー X-Amzn-Bedrock-AgentCore-Runtime-Session-Endpoint-Url で返り、SDKではsessionEndpointUrlとして扱えます。認証は必須で、IAMを使うランタイムではHTTPリクエスト、HTTP/2ストリーム、WebSocketハンドシェイクのそれぞれにSigV4署名が必要です。呼び出し元には bedrock-agentcore:InvokeAgentRuntimeProxy 権限も求められます。JWTオーソライザーを使う構成では、代わりにベアラートークンを付けます。つまりURLを知っているだけではアクセスできません。

クライアントは常に443番に接続し、ホスト名のプレフィックスでセッション内のポートを選びます。例えば「8090--<セッションID>.runtime.bedrock-agentcore.<リージョン>.on.aws」のように指定します。HTTP/1.1、HTTP/2（Server-Sent EventsやgRPCを含む）、WebSocketが通過します。

ブラウザは自らSigV4署名やベアラートークンを付与できないため、bedrock-agentcore SDKのセッションエンドポイントクライアントが端末上にローカルエンドポイントを開きます。ブラウザはhttp://localhost:8088 に接続し、ローカルエンドポイントが認証情報を付けてSession endpointへ転送する形です。

サンプルの構成と動作

サンプルは4つの部品で構成されます。エージェントはポート8080で動き、list・read・write・editの4ツールでサイトのファイルを編集します。Vite開発サーバーはポート8090でサイトを配信し、保存された変更をホットリロード用のWebSocketでブラウザへ push します。エージェントの/statusルートはポート8081です。

allowedPortsに登録するのは8090と8081だけで、8080は含めません。InvokeAgentRuntimeはSession endpointを経由せずエージェントに到達するためです。利用者の端末ではPreviewAppがプレビューページをlocalhost:8087で配信し、プロンプトをInvokeAgentRuntimeへ送ります。変更内容の判断にはAmazon Bedrock上のClaude Haiku 5.5を使います。

Vite側の設定では、開発サーバーを0.0.0.0のポート8090で待ち受けさせ、Hostヘッダーの制限（server.allowedHosts）を無効にしています。リクエストがlocalhostではなくランタイムの割り当てたホスト名で届くためです。Session endpointが転送前に全リクエストを認証するので、サーバー側で独自のホストチェックを持つ必要はないと説明されています。

ランタイムエンドポイントとの違いと制約

Session endpointは、既存のランタイムエンドポイントとは役割が異なります。ランタイムエンドポイント（DEFAULTなど）は、呼び出し元がどのバージョンのエージェントに到達するかを制御するためのものです。一方のSession endpointは、セッション内でエージェントが動かしているWebプレビューのような成果物を見るための、許可ポート限定の認証付きURLだと位置づけられています。

制約も明示されています。Session endpointはマイクロVMのランタイムで動作し、Instancesコンピュートタイプでは使えません。URLはパブリックHTTPSで到達する必要があり、インバウンド接続にAWS PrivateLinkは対応していません。URLの有効期間はセッション限りなので、利用者向けにアプリを配信する場合はAWS Amplify Hostingなどのホスティングサービスへデプロイすることになります。

サンプルを動かす前提は、AgentCore runtimeのSession endpointsが利用できるリージョンのAWSアカウント、Python 3.10以降、bedrock-agentcore 1.25.2以降、boto3 1.43.122以降、Node.js 22以降とnpm、Git、Jupyter実行環境です。デプロイはエージェントをzipにまとめてAmazon S3に置く直接コードデプロイ方式で、DockerやAmazon ECRは不要とされています。