[アップデート] Amazon Bedrock AgentCore Runtime で S3 バケットを直接マウントできるようになったので AWS CLI で確認してみた

[アップデート] Amazon Bedrock AgentCore Runtime で S3 バケットを直接マウントできるようになったので AWS CLI で確認してみた

S3 Files なしで直接マウントできた
2026.11.20

いわさです。

Amazon Bedrock AgentCore Runtime は、AI エージェントを動かすためのマネージドな実行環境です。
AgentCore Runtime でエージェントがファイルを読み書きするには、ランタイムにファイルシステムを接続します。

マネージドストレージの他に半年ほど前のアップデートで Amazon S3 Files と Amazon EFS をランタイムに接続できるようになっています。

https://aws.amazon.com/about-aws/whats-new/2026/05/amazon-bedrock-agentcore-runtime/

ただし、S3 Files と EFS は、どちらもランタイムで VPC(AWS 上の仮想ネットワーク)接続が必要です。
そのため、S3 のファイルをランタイムから使いたい場合も、VPC を用意する必要がありました。公式ドキュメントにも、次のように書かれています。

Both S3 Files and EFS require VPC connectivity on the agent runtime.

https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-filesystem-configurations.html

これが、先日の AWS CLI v2.41.1 のアップデートで S3 バケットを直接マウントできるっぽい機能が追加されていました。

Adds s3BucketMount to mount an Amazon S3 bucket as a file system in AgentCore Runtime, with an optional per-session key prefix

https://github.com/aws/aws-cli/commit/ac125194ab55c4699e70677deef525631c4116ec

What's New アナウンスにはまだ出ていないので使えるかわからなかったのですが、試してみました。

実際に確認してみる

マネジメントコンソールでランタイム作成/更新画面の「ファイルシステムを追加」を見てみると、次の 3 つの種類が表示されます。

FDF0E9FA-6036-40E3-ADFC-DDC1A2275DA4.png

マネージドセッションストレージ(プレビュー)、S3 Files、Elastic File System(EFS)です。
S3 バケットの選択肢はありませんね。

どうやら本日時点ではコンソールで新しく追加する経路はなさそうです。ということで AWS CLI で作ってみましょう。
コマンドですがbedrock-agentcore-control/create-agent-runtimeのfilesystem-configurationsで指定できます。

This is a Tagged Union structure. Only one of the following top level keys can be set: sessionStorage, s3FilesAccessPoint, efsAccessPoint, capacityProviderVolume, s3BucketMount.

https://docs.aws.amazon.com/cli/latest/reference/bedrock-agentcore-control/create-agent-runtime.html

こっちだと、s3BucketMountが指定できるんです。
適当な S3 バケットを作成してマウント先を指定します。network-configuration.networkModeはPUBLICにしてます。

cat filesystem.json
[
  {
    "s3BucketMount": {
      "bucket": "hoge-agentcore-mount-123456789012",
      "mountPath": "/mnt/data",
      "prefix": "data/"
    }
  }
]

aws bedrock-agentcore-control create-agent-runtime \
  --region ap-northeast-1 \
  --agent-runtime-name hoge_s3mount_sample \
  --agent-runtime-artifact file://artifact.json \
  --role-arn arn:aws:iam::123456789012:role/hoge-agentcore-runtime-role \
  --network-configuration '{"networkMode":"PUBLIC"}' \
  --filesystem-configurations file://filesystem.json

なお他のコマンドと同様に--payload は JSON 文字列そのまま渡せないです。最初これで 502 エラーになりました。
fileb://プレフィックスでバイナリコンテンツとして指定してあげると、成功します。

作成後コンソールを見てみるとランタイムの詳細がこんな感じに。
ファイル・システムタイプ「S3 bucket」です。

7B9B6D36-4B92-43AB-ACDA-0DF18B9C8920.png

なお、更新画面ではこんな感じになってます。本日時点ではこの画面から再選択はできません。

103DC0D8-2565-4A2F-8927-962820E9475B.png

では実際に使えるのか試してみましょう。
エージェントの内容ですが、次のようなものを設定しています。

Python の Bedrock AgentCore SDK(bedrock_agentcore)を使い、呼び出しするだけの実装です。マウント先のファイル一覧と、書き込みテストの結果を JSON で返却させてます。

main.py
import datetime
import os

from bedrock_agentcore.runtime import BedrockAgentCoreApp

MOUNT_PATH = os.environ.get("MOUNT_PATH", "/mnt/data")

app = BedrockAgentCoreApp()


def inspect_mount():
    result = {"mount_path": MOUNT_PATH, "exists": os.path.isdir(MOUNT_PATH)}
    if result["exists"]:
        entries = []
        for root, dirs, files in os.walk(MOUNT_PATH):
            for name in dirs + files:
                entries.append(os.path.relpath(os.path.join(root, name), MOUNT_PATH))
            if len(entries) >= 200:
                break
        result["entries"] = sorted(entries)[:200]
    return result


@app.entrypoint
def invoke(payload, context):
    body = {"received": payload, "mount": inspect_mount(), "write_test": None}
    try:
        target = os.path.join(MOUNT_PATH, "write-test.txt")
        with open(target, "w") as f:
            f.write(datetime.datetime.now(datetime.timezone.utc).isoformat())
        body["write_test"] = "ok"
    except Exception as e:
        body["write_test"] = f"error: {type(e).__name__}: {e}"
    return body


if __name__ == "__main__":
    app.run()

ランタイムには、このファイルを含む zip ファイルを配置して、エントリーポイントで main.py を指定してます。

では Invoke してみましょう。

aws bedrock-agentcore invoke-agent-runtime \
  --region ap-northeast-1 \
  --agent-runtime-arn arn:aws:bedrock-agentcore:ap-northeast-1:123456789012:runtime/hoge_s3mount_sample-xxxxxxxx \
  --runtime-session-id 0123456789abcdef0123456789abcdefsessionA \
  --content-type application/json \
  --accept application/json \
  --payload fileb://payload.json \
  response.json
{"received": {"prompt": "ls"}, "mount": {"mount_path": "/mnt/data", "exists": true, "entries": ["hello.txt"]}, "write_test": "ok"}

パラメータで指定したプレフィックスのdata/hello.txt が確認出来ましたね。プレフィックスに指定していないother/other.txt は取得できませんでした。
/mnt/data/write-test.txt の書き込みも成功し、S3 バケットを確認してみるとオブジェクトが確認できました。

aws s3 ls s3://hoge-agentcore-mount-123456789012/ --recursive
2026-11-19 23:55:22         23 data/hello.txt
2026-11-20 00:15:44         32 data/write-test.txt
2026-11-19 23:55:23         22 other/other.txt

次に、プレフィックスを sessions/{runtimeSessionId}/ に変えて、ランタイムを更新し、別々のセッションで呼び出してみました。
こんな感じでセッション ID のプレフィックスの中のオブジェクトが確認できますね。

6528DAE7-231E-426A-9B77-1DC9A97B928D.png

さいごに

本日は Amazon Bedrock AgentCore Runtime で S3 バケットを直接マウントできるようになったので AWS CLI で確認してみました。

本日時点では AWS CLI だけでしたが、S3 バケットを VPC なしでマウントし、プレフィックスで、マウントの中の見える範囲を制限したりできました。
数日たてばコンソールにも追加されるだろうと思ってます。

エージェントに読み込ませるリソースとか S3 に置いて、VPC なしでランタイムから読ませるとか、さっと使えて良さげです。

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事