Managed Agentsエージェントコンテキストの管理

ファイルの追加

ファイルをアップロードし、サンドボックスにマウントして読み取りや処理を行います。

Files APIを通じてファイルをアップロードし、セッションのサンドボックスにマウントすることで、エージェントにファイルを提供できます。

すべてのManaged Agents APIリクエストには、managed-agents-2026-04-01ベータヘッダーが必要です。SDKはベータヘッダーを自動的に設定します。

ファイルのアップロード

まず、Files APIを使用してファイルをアップロードします。

file = client.beta.files.upload(file=Path("data.csv"))
print(f"File ID: {file.id}")

セッションへのファイルのマウント

セッション作成時にresources配列に追加することで、アップロードしたファイルをサンドボックスにマウントします。

mount_pathは省略可能ですが、エージェントがファイルを識別できるように、アップロードするファイルにはわかりやすい名前を付けてください。

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    resources=[
        {
            "type": "file",
            "file_id": file.id,
            "mount_path": "/workspace/data.csv",
        },
    ],
)

セッション内のファイルインスタンスを参照する新しいfile_idが作成されます。これらのコピーはストレージ制限にはカウントされません。

複数のファイル

resources配列にエントリを追加することで、複数のファイルをマウントできます。

resources = [
    {"type": "file", "file_id": "file_abc123", "mount_path": "/workspace/data.csv"},
    {"type": "file", "file_id": "file_def456", "mount_path": "/workspace/config.json"},
    {"type": "file", "file_id": "file_ghi789", "mount_path": "/workspace/src/main.py"},
]

1セッションあたり最大100ファイルまでサポートされています。

実行中のセッションでのファイル管理

セッションリソースAPIを使用して、セッション作成後にファイルを追加または削除できます。各リソースには、追加時（または一覧表示時）に返されるidがあり、削除時にこれを使用します。

resource = client.beta.sessions.resources.add(
    session.id,
    type="file",
    file_id=file.id,
)
print(resource.id)  # "sesrsc_01ABC..."

resources.listでセッション上のすべてのリソースを一覧表示できます。ファイルを削除するには、リソースIDを指定してresources.deleteを呼び出します。

listed = client.beta.sessions.resources.list(session.id)
for entry in listed.data:
    print(entry.id, entry.type)

client.beta.sessions.resources.delete(resource.id, session_id=session.id)

セッションファイルの一覧表示とダウンロード

Files APIを使用して、セッションにスコープされたファイルを一覧表示し、ダウンロードします。

# セッションに関連付けられたファイルを一覧表示
files = client.beta.files.list(
    scope_id="sesn_abc123",
    betas=["managed-agents-2026-04-01"],
)
for f in files:
    print(f.id, f.filename)

# ファイルをダウンロード
content = client.beta.files.download(files.data[0].id)
content.write_to_file("output.txt")

サポートされているファイルタイプ

エージェントは、以下を含むあらゆるファイルタイプを扱うことができます。

ソースコード（.py、.js、.ts、.go、.rsなど）
データファイル（.csv、.json、.xml、.yaml）
ドキュメント（.txt、.md）
アーカイブ（.zip、.tar.gz） - エージェントはbashを使用してこれらを展開できます
バイナリファイル - エージェントは適切なツールでこれらを処理できます

ファイルパス

サンドボックスにマウントされたファイルは読み取り専用のコピーです。エージェントはこれらを読み取ることはできますが、アップロードされた元のファイルを変更することはできません。変更されたバージョンを扱うには、エージェントはサンドボックス内の新しいパスに書き込みます。

ファイルは指定した正確なパスにマウントされます
親ディレクトリは自動的に作成されます
パスは絶対パス（/で始まる）である必要があります

Was this page helpful?

Managed Agentsエージェントコンテキストの管理

ファイルの追加

ファイルをアップロードし、サンドボックスにマウントして読み取りや処理を行います。

Files APIを通じてファイルをアップロードし、セッションのサンドボックスにマウントすることで、エージェントにファイルを提供できます。

すべてのManaged Agents APIリクエストには、managed-agents-2026-04-01ベータヘッダーが必要です。SDKはベータヘッダーを自動的に設定します。

ファイルのアップロード

まず、Files APIを使用してファイルをアップロードします。

file = client.beta.files.upload(file=Path("data.csv"))
print(f"File ID: {file.id}")

セッションへのファイルのマウント

セッション作成時にresources配列に追加することで、アップロードしたファイルをサンドボックスにマウントします。

mount_pathは省略可能ですが、エージェントがファイルを識別できるように、アップロードするファイルにはわかりやすい名前を付けてください。

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    resources=[
        {
            "type": "file",
            "file_id": file.id,
            "mount_path": "/workspace/data.csv",
        },
    ],
)

セッション内のファイルインスタンスを参照する新しいfile_idが作成されます。これらのコピーはストレージ制限にはカウントされません。

複数のファイル

resources配列にエントリを追加することで、複数のファイルをマウントできます。

resources = [
    {"type": "file", "file_id": "file_abc123", "mount_path": "/workspace/data.csv"},
    {"type": "file", "file_id": "file_def456", "mount_path": "/workspace/config.json"},
    {"type": "file", "file_id": "file_ghi789", "mount_path": "/workspace/src/main.py"},
]

1セッションあたり最大100ファイルまでサポートされています。

実行中のセッションでのファイル管理

resource = client.beta.sessions.resources.add(
    session.id,
    type="file",
    file_id=file.id,
)
print(resource.id)  # "sesrsc_01ABC..."

listed = client.beta.sessions.resources.list(session.id)
for entry in listed.data:
    print(entry.id, entry.type)

client.beta.sessions.resources.delete(resource.id, session_id=session.id)

セッションファイルの一覧表示とダウンロード

Files APIを使用して、セッションにスコープされたファイルを一覧表示し、ダウンロードします。

# セッションに関連付けられたファイルを一覧表示
files = client.beta.files.list(
    scope_id="sesn_abc123",
    betas=["managed-agents-2026-04-01"],
)
for f in files:
    print(f.id, f.filename)

# ファイルをダウンロード
content = client.beta.files.download(files.data[0].id)
content.write_to_file("output.txt")

サポートされているファイルタイプ

エージェントは、以下を含むあらゆるファイルタイプを扱うことができます。

ソースコード（.py、.js、.ts、.go、.rsなど）
データファイル（.csv、.json、.xml、.yaml）
ドキュメント（.txt、.md）
アーカイブ（.zip、.tar.gz） - エージェントはbashを使用してこれらを展開できます
バイナリファイル - エージェントは適切なツールでこれらを処理できます

ファイルパス

ファイルは指定した正確なパスにマウントされます
親ディレクトリは自動的に作成されます
パスは絶対パス（/で始まる）である必要があります

Was this page helpful?

ファイルのアップロード

セッションへのファイルのマウント

複数のファイル

実行中のセッションでのファイル管理

セッションファイルの一覧表示とダウンロード

サポートされているファイルタイプ

ファイルパス

ファイルのアップロード

セッションへのファイルのマウント

複数のファイル

実行中のセッションでのファイル管理

セッションファイルの一覧表示とダウンロード

サポートされているファイルタイプ

ファイルパス

ファイルのアップロード

セッションへのファイルのマウント

複数のファイル

実行中のセッションでのファイル管理

セッションファイルの一覧表示とダウンロード

サポートされているファイルタイプ

ファイルパス

ファイルのアップロード

セッションへのファイルのマウント

複数のファイル

実行中のセッションでのファイル管理

セッションファイルの一覧表示とダウンロード

サポートされているファイルタイプ

ファイルパス