Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
您可以透過 Files API 上傳檔案，並將其掛載至工作階段的「sandbox」（沙箱）中，藉此將檔案提供給您的代理程式。
首先，使用 Files API 上傳檔案：
file = client.files.upload(file=Path("data.csv"))
print(f"File ID: {file.id}")建立工作階段時，將已上傳的檔案加入 resources 陣列，即可將其掛載至沙箱中：
session = client.beta.sessions.create(
agent=agent.id,
environment_id=environment.id,
resources=[
{
"type": "file",
"file_id": file.id,
"mount_path": "/data.csv",
},
],
)使用上述的 mount_path，代理程式會在 /mnt/session/uploads/data.csv 讀取該檔案（請參閱檔案路徑）。
系統會建立一個新的 file_id，用以參照該檔案在工作階段中的實例。這些副本不會計入您的儲存空間限制。
在 resources 陣列中加入多個項目，即可掛載多個檔案：
resources = [
{"type": "file", "file_id": "file_abc123", "mount_path": "/data.csv"},
{"type": "file", "file_id": "file_def456", "mount_path": "/config.json"},
{"type": "file", "file_id": "file_ghi789", "mount_path": "/src/main.py"},
]每個工作階段最多支援 500 個檔案。
您可以在工作階段建立後，使用工作階段資源 API 新增或移除檔案。每個資源在新增（或列出）時都會回傳一個 id，您可使用該 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 列出範圍限定於某個工作階段的檔案並下載它們。依 scope_id 篩選需要 managed-agents-2026-04-01 beta 標頭，因此列出檔案的範例使用 beta files 命名空間並明確傳遞該標頭。下載檔案則不需要 beta 標頭。
# 列出與工作階段相關聯的檔案
files = client.beta.files.list(
scope_id="sesn_abc123",
betas=["managed-agents-2026-04-01"],
)
for file in files:
print(file.id, file.filename)
# 下載檔案
content = client.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 解壓縮這些檔案mount_path 為 /data.csv 時，檔案會放置於沙箱中的 /mnt/session/uploads/data.csvmount_path，檔案會放置於 /mnt/session/uploads/<file_id>/ 開頭）Was this page helpful?