类class agentscope.workspace

E2BBackend

class E2BBackend(BackendBase)

源码Source agentscope/workspace/_e2b/_e2b_backend.py:22–163

E2B Backend，在隔离环境中安全执行代码和工具。位于 agentscope.workspace 包，继承自 BackendBase。核心成员包括 getcwd、exec_shell、read_file、write_file。

Only the three abstract primitives (exec_shell, read_file, write_file) are implemented here; the derived filesystem helpers are inherited from :class:BackendBase.

构造器摘要Constructor Summary

构造器Constructor	说明Description
`def __init__(sandbox: Any, workdir: str) -> None`	初始化 `E2BBackend` 实例。 Initialize the E2B backend.

方法摘要Method Summary

方法Method	说明Description
`async def getcwd() -> str`async	返回 `getcwd` 结果。 Return the sandbox's default working directory.
`async def exec_shell(command: list[str], *, cwd: str \| None = None, timeout: float \| None = None) ->` `ExecResult`async	执行 `exec_shell` 方法。 Run a program inside the sandbox via ``commands.run``.
`async def read_file(path: str) -> bytes`async	设置读取文件。 Read a file from the sandbox via ``files.read``.
`async def write_file(path: str, data: bytes) -> None`async	执行写入文件相关操作。 Write data to a file inside the sandbox.

构造器详情Constructor Detail

E2BBackend

def __init__(sandbox: Any, workdir: str) -> None

初始化 E2BBackend 实例。

Initialize the E2B backend.

参数Parameters

名称Name	类型Type	说明Description
`sandbox`	Any	一种已启动/已连接`e2b.AsyncSandbox`对象。A started / connected `e2b.AsyncSandbox` object.
`workdir`	str	workdir（类型 `str`）。Default working directory for `exec_shell` calls inside the sandbox.

源码Source agentscope/workspace/_e2b/_e2b_backend.py:38–49

方法详情Method Detail

getcwd

async def getcwd() -> str

async

返回 getcwd 结果。

Overrides the base class default (which would shell out to pwd) with the cached workdir supplied at construction, avoiding a per-call sandbox round-trip.

返回Returns str

返回字符串结果。`str`:

源码Source agentscope/workspace/_e2b/_e2b_backend.py:53–64

exec_shell

async def exec_shell(command: list[str], *, cwd: str | None = None, timeout: float | None = None) -> ExecResult

async

执行 exec_shell 方法。

command* is an argv list.

参数Parameters

名称Name	类型Type	说明Description
`command`	list[str]	命令（类型 `list[str]`）。Executable path/name followed by its arguments.
`cwd`kw默认default `None`	str \| None	cwd（类型 `str \| None`）。Working directory inside the sandbox. When `None` the backend's default `workdir` is used.
`timeout`kw默认default `None`	float \| None	超时时间（类型 `float \| None`）。Maximum number of seconds to wait. When `None` the SDK default applies.

返回Returns ExecResult

返回ExecResult。`ExecResult`:

源码Source agentscope/workspace/_e2b/_e2b_backend.py:66–120

read_file

async def read_file(path: str) -> bytes

async

设置读取文件。

Read a file from the sandbox via files.read.

参数Parameters

名称Name	类型Type	说明Description
`path`	str	路径（类型 `str`）。Path to the file inside the sandbox.

返回Returns bytes

返回字节。`bytes`:

异常Raises

可能抛出 `Exception`。`FileNotFoundError`:
可能抛出 `Exception`。If the path does not exist inside the sandbox.

源码Source agentscope/workspace/_e2b/_e2b_backend.py:124–147

write_file

async def write_file(path: str, data: bytes) -> None

async

执行写入文件相关操作。

Creates parent directories via exec_shell first.

参数Parameters

名称Name	类型Type	说明Description
`path`	str	路径（类型 `str`）。Destination path inside the sandbox.
`data`	bytes	原始字节到写入。The raw bytes to write.

返回Returns None

无返回值。No value is returned.

源码Source agentscope/workspace/_e2b/_e2b_backend.py:149–163

继承成员Inherited Members

继承自Inherited from BackendBase

join_path, dirname, basename, isabs, normpath, abspath, write_stream, read_stream, expanduser, file_exists, is_dir, list_dir, scandir, stat, stat_mtime, delete_path, os_name