Function Compute：E2B 相容說明

Sandbox

第一代運行時的暫停與恢複僅對已開通白名單的帳號可用，請先完成白名單開通，再調用 sandbox.pause() 或串連已暫停 Sandbox；第二代運行時預設支援暫停與恢複，無需加入白名單。

Snapshot 功能同樣僅對已開通白名單的帳號可用，且僅支援第二代運行時（microVM）。請先完成白名單開通，再調用 Snapshot 相關介面。

支援以下 Sandbox 生命週期和訪問能力：

• Sandbox.create()

• Sandbox.connect(sandboxId)

• Sandbox.list()

• Sandbox.getInfo(sandboxId)

• Sandbox.kill(sandboxId)

• Sandbox.setTimeout(sandboxId, ms)

• sandbox.getInfo()

• sandbox.isRunning()

• sandbox.setTimeout(ms)

• sandbox.pause()

• sandbox.kill()

• sandbox.downloadUrl(path)

• sandbox.uploadUrl(path)

• sandbox.getHost(port)

• sandbox.createSnapshot({ name? }) / Sandbox.createSnapshot(sandboxId, { name? })

• Sandbox.listSnapshots({ sandboxId?, name?, limit?, nextToken? })

• Sandbox.deleteSnapshot(snapshotId | qualifiedName)

• Python：sandbox.create_snapshot(name=...) / Sandbox.create_snapshot(sandbox_id, name=...)、Sandbox.list_snapshots(...)、Sandbox.delete_snapshot(snapshot_id | qualified_name)

Sandbox.connect(sandboxId) 可串連已有 Sandbox。如果目標 Sandbox 已暫停，串連時會自動回復。

Sandbox.create() 的模板參數除模板名 / 模板 ID 外，還可以是 Snapshot ID 或已命名 Snapshot 的全名。Snapshot 使用限制和命名規則參見快照（Snapshot）（邀測）。

Commands

支援以下命令執行和進程管理能力：

• sandbox.commands.run()

• sandbox.commands.list()

• sandbox.commands.connect()

• sandbox.commands.sendStdin()

• sandbox.commands.kill()

互動式終端和依賴 TTY 的任務使用 sandbox.pty API。

Filesystem

支援以下檔案系統能力：

• sandbox.files.list()

• sandbox.files.exists()

• sandbox.files.getInfo() / sandbox.files.get_info()

• sandbox.files.read()

• sandbox.files.write()

• sandbox.files.makeDir() / sandbox.files.make_dir()

• sandbox.files.remove()

• sandbox.files.rename()

• sandbox.files.watchDir() / sandbox.files.watch_dir()

sandbox.files.write() 支援寫入文本、二進位內容和流式內容。目錄監聽適合等待 Agent 輸出檔案或同步任務產物。

雲沙箱 檔案自訂中繼資料暫不支援。以 Python SDK e2b==2.31.0 為例：方法簽名雖然接受 metadata 參數，但第一代運行時的 Sandbox 使用 envd 0.5.2，SDK 在發出寫入請求前會直接拋出 TemplateException: File metadata requires envd 0.6.2 or later。

Code Interpreter

支援代碼解譯器核心能力：

• sandbox.runCode() / sandbox.run_code()

• sandbox.createCodeContext() / sandbox.create_code_context()

• sandbox.listCodeContexts() / sandbox.list_code_contexts()

• sandbox.restartCodeContext() / sandbox.restart_code_context()

• sandbox.removeCodeContext() / sandbox.remove_code_context()

• 執行結果輸出，包括 stdout、stderr、execution count、裸運算式結果和 execution.results 富結果。

• 流式輸出情境下的 stdout、stderr 和結果回調。

• 多次代碼執行之間的變數和上下文狀態保持。

• 通過 language 參數執行 Python、JavaScript、TypeScript 和 Bash。

圖表與可視化當前只支援檔案降級方案：在 Sandbox 內產生圖片檔案後，通過 Filesystem 或下載 URL 取回。

Template

支援模板的建立、查詢、更新和刪除（增刪改查）。當前模板構建支援從鏡像建立模板。具體使用方式參見構建和系統管理範本。

CLI

雲沙箱相容 E2B CLI 的常用 Sandbox 命令，並擴充部分 Template 管理命令：

新版本 E2B CLI 使用 E2B_API_KEY 認證。配置方式參見通過 CLI 使用雲沙箱。

Metrics

支援 E2B metrics，並在控制台提供可觀測能力；暫不支援 Metrics API。