类class agentscope.workspace

E2BWorkspace

class E2BWorkspace(SandboxedWorkspaceBase)

源码Source agentscope/workspace/_e2b/_e2b_workspace.py:66–368

E2B 工作区，在隔离环境中安全执行代码和工具。位于 agentscope.workspace 包，继承自 SandboxedWorkspaceBase。核心成员包括 get_instructions、sandbox_id。

default_mcps and skill_paths are seed-time inputs and are not retained as instance state past :meth:initialize.

构造器摘要Constructor Summary

构造器Constructor	说明Description
`def __init__(*, workspace_id: str \| None = None, template: str = DEFAULT_TEMPLATE, api_key: str = '', domain: str = '',…`	初始化 `E2BWorkspace` 实例。 Construct an :class:`E2BWorkspace`.

属性摘要Property Summary

属性Property	说明Description
`sandbox_id`	获取沙箱标识。 E2B sandbox id, or ``None`` if not started.

方法摘要Method Summary

方法Method	说明Description
`async def get_instructions() -> str`async	获取指令。 Return the system-prompt fragment for this workspace.

构造器详情Constructor Detail

E2BWorkspace

def __init__(*, workspace_id: str | None = None, template: str = DEFAULT_TEMPLATE, api_key: str = '', domain: str = '', timeout_seconds: int = DEFAULT_TIMEOUT, gateway_port: int = DEFAULT_GATEWAY_PORT, env: dict[str, str] | None = None, sandbox_metadata: dict[str, str] | None = None, extra_pip: list[str] | None = None, instructions: str = DEFAULT_WORKSPACE_INSTRUCTIONS, default_mcps: list[MCPClient] | None = None, skill_paths: list[str] | None = None) -> None

初始化 E2BWorkspace 实例。

The sandbox is not started here — call :meth:initialize (or use the workspace as an async context manager).

参数Parameters

名称Name	类型Type	说明Description
`workspace_id`kw默认default `None`	str \| None	工作区标识（类型 `str \| None`）。Stable identifier; also stored in sandbox metadata for reattachment.
`template`kw默认default `DEFAULT_TEMPLATE`	str	模板（类型 `str`）。E2B template id.
`api_key`kw默认default `''`	str	API 密钥（类型 `str`）。E2B API key (`""` falls back to `E2B_API_KEY`).
`domain`kw默认default `''`	str	domain（类型 `str`）。Optional custom E2B domain.
`timeout_seconds`kw默认default `DEFAULT_TIMEOUT`	int	超时秒数（类型 `int`）。Sandbox keep-alive timeout.
`gateway_port`kw默认default `DEFAULT_GATEWAY_PORT`	int	网关 port（类型 `int`）。TCP port the in-sandbox gateway listens on.
`env`kw默认default `None`	dict[str, str] \| None	env（类型 `dict[str, str] \| None`）。Environment variables baked into the sandbox.
`sandbox_metadata`kw默认default `None`	dict[str, str] \| None	沙箱元数据（类型 `dict[str, str] \| None`）。Extra metadata merged with the workspace-id tag.
`extra_pip`kw默认default `None`	list[str] \| None	extra pip（类型 `list[str] \| None`）。Extra Python packages installed into the gateway venv during bootstrap.
`instructions`kw默认default `DEFAULT_WORKSPACE_INSTRUCTIONS`	str	指令（类型 `str`）。System-prompt fragment template (supports `{workdir}`).
`default_mcps`kw默认default `None`	list[MCPClient] \| None	默认 mcps（类型 `list[MCPClient] \| None`）。MCPs registered on first init when no persisted `.mcp` exists.
`skill_paths`kw默认default `None`	list[str] \| None	技能 paths（类型 `list[str] \| None`）。Local skill dirs seeded into `skills/` on first init.

源码Source agentscope/workspace/_e2b/_e2b_workspace.py:79–152

属性详情Property Detail

sandbox_id

def sandbox_id() -> str | None

获取沙箱标识。

E2B sandbox id, or None if not started.

返回Returns str | None

返回str|None。Returns str none.

源码Source agentscope/workspace/_e2b/_e2b_workspace.py:157–159

方法详情Method Detail

get_instructions

async def get_instructions() -> str

async

获取指令。

Substitutes {workdir} in the configured template with the sandbox-side path (/home/user/workspace).

返回Returns str

返回字符串结果。Returns a string.

源码Source agentscope/workspace/_e2b/_e2b_workspace.py:189–196