Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
您可以透過 Files API 上傳檔案並將其掛載到工作階段的沙箱中，以向您的代理提供檔案。
首先，使用 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 列出屬於某個工作階段範圍的檔案並下載它們。
# 列出與工作階段相關聯的檔案
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.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 解壓縮這些檔案mount_path 為 /data.csv 時，檔案會放置在沙箱中的 /mnt/session/uploads/data.csvmount_path，檔案會放置在 /mnt/session/uploads/<file_id>/ 開頭）Was this page helpful?