功能域Functional domain

沙箱与执行环境Sandboxes & execution

Docker、Kubernetes、E2B、Daytona、Bubblewrap 等隔离执行后端，以及文件系统、浏览器等运行时工具。生产环境执行模型生成代码的第一道安全边界。Isolated execution backends (Docker, Kubernetes, E2B, Daytona, Bubblewrap) and runtime tools such as filesystem and browser access.

86类型总数types total

17Python

69Java

3学习锚点learning anchors

心智模型Mental model

沙箱层为代码执行和工具运行提供隔离：工作区、容器、远程执行器与资源回收。Sandboxes isolate code and tool execution: workspaces, containers, remote executors and resource reclamation.

先学什么What to learn first

默认拒绝网络与文件系统访问，按需最小授权。Deny network and filesystem access by default and grant the minimum.
为每次执行设置 CPU/内存/时长上限，并强制回收。Cap CPU, memory and duration per execution, then reclaim forcibly.
不可信代码永远不要在主进程内执行。Never run untrusted code inside the main process.

生产常见坑Production pitfalls

沙箱实例未复用导致启动延迟和资源泄漏。Unreused sandboxes cause startup latency and leaks.
把宿主目录直接挂载进沙箱，隔离形同虚设。Mounting host directories defeats isolation.

进入对应闯关单元Practice this domain →

域内图谱Domain map

点击节点打开 API 页面；拖拽平移，滚轮缩放。Click a node to open its API page. Drag to pan, scroll to zoom.

Python API 集Python API set 17

归入本功能域的全部 Python 公开类型，按所属包分组。Every public Python type classified into this domain, grouped by owning package.

agentscope.workspace17

`AppleContainerBackend`	class	Apple 容器 Backend，在隔离环境中安全执行代码和工具。
`AppleContainerWorkspace`	class	Apple 容器工作区，在隔离环境中安全执行代码和工具。
`BubblewrapBackend`	class	Bubblewrap Backend，在隔离环境中安全执行代码和工具。
`BubblewrapWorkspace`	class	Bubblewrap 工作区，在隔离环境中安全执行代码和工具。
`DaytonaBackend`	class	Daytona Backend，在隔离环境中安全执行代码和工具。
`DaytonaWorkspace`	class	Daytona 工作区，在隔离环境中安全执行代码和工具。
`DockerBackend`	class	Docker Backend，在隔离环境中安全执行代码和工具。
`DockerWorkspace`	class	Docker 工作区，在隔离环境中安全执行代码和工具。
`E2BBackend`	class	E2B Backend，在隔离环境中安全执行代码和工具。
`E2BWorkspace`	class	E2B 工作区，在隔离环境中安全执行代码和工具。
`K8sBackend`	class	K 8 s Backend，在隔离环境中安全执行代码和工具。
`K8sWorkspace`	class	K 8 s 工作区，在隔离环境中安全执行代码和工具。
`LocalWorkspace`	class	本地工作区，在隔离环境中安全执行代码和工具。
`Offloader`	class	Offloader，在隔离环境中安全执行代码和工具。
`OpenSandboxBackend`	class	OpenSandbox Backend，在隔离环境中安全执行代码和工具。
`OpenSandboxWorkspace`	class	OpenSandbox 工作区，在隔离环境中安全执行代码和工具。
`WorkspaceBase`	class	工作区基类，在隔离环境中安全执行代码和工具。

Java API 集Java API set 69

归入本功能域的全部 Java 公开类型，按包分组并标注构件。Every public Java type classified into this domain, grouped by package with its artifact.

io.agentscope.extensions.sandbox.kubernetes.client.crd11

`AdditionalPodMetadata`	class	`agentscope-extensions-sandbox-kubernetes`	Additional Pod 元数据，在隔离环境中安全执行代码和工具。
`ClaimSandboxStatus`	class	`agentscope-extensions-sandbox-kubernetes`	Claim 沙箱状态，在隔离环境中安全执行代码和工具。
`Condition`	class	`agentscope-extensions-sandbox-kubernetes`	Condition，在隔离环境中安全执行代码和工具。
`Lifecycle`	class	`agentscope-extensions-sandbox-kubernetes`	生命周期，在隔离环境中安全执行代码和工具。
`SandboxClaim`	class	`agentscope-extensions-sandbox-kubernetes`	用于`SandboxClaim`(扩展.智能体.x-k8s.io/v1beta1)的Fabric8 CRD 绑定。
`SandboxClaimSpec`	class	`agentscope-extensions-sandbox-kubernetes`	用于`SandboxClaim`的规格。
`SandboxClaimStatus`	class	`agentscope-extensions-sandbox-kubernetes`	用于`SandboxClaim`的状态。
`SandboxIdentity`	class	`agentscope-extensions-sandbox-kubernetes`	沙箱身份，在隔离环境中安全执行代码和工具。
`SandboxResource`	class	`agentscope-extensions-sandbox-kubernetes`	沙箱资源，在隔离环境中安全执行代码和工具。
`SandboxStatusData`	class	`agentscope-extensions-sandbox-kubernetes`	沙箱状态数据，在隔离环境中安全执行代码和工具。
`WarmPoolRef`	class	`agentscope-extensions-sandbox-kubernetes`	Warm 连接池引用，在隔离环境中安全执行代码和工具。

io.agentscope.extensions.sandbox.e2b9

`E2bCodec`	enum	`agentscope-extensions-sandbox-e2b`	定义E 2 b 编解码器相关取值的枚举。
`E2bFilesystemSpec`	class	`agentscope-extensions-sandbox-e2b`	E 2 b 文件系统规格，在隔离环境中安全执行代码和工具。
`E2bHarnessSandboxJacksonModule`	class	`agentscope-extensions-sandbox-e2b`	E 2 b Harness 沙箱 Jackson Module，在隔离环境中安全执行代码和工具。
`E2bPersistenceMode`	enum	`agentscope-extensions-sandbox-e2b`	定义E 2 b 持久化模式相关取值的枚举。
`E2bSandbox`	class	`agentscope-extensions-sandbox-e2b`	E 2 b 沙箱，在隔离环境中安全执行代码和工具。
`E2bSandboxClient`	class	`agentscope-extensions-sandbox-e2b`	用于E2B的`SandboxClient`。
`E2bSandboxClientOptions`	class	`agentscope-extensions-sandbox-e2b`	用于`E2bSandboxClient`的选项。
`E2bSandboxState`	class	`agentscope-extensions-sandbox-e2b`	E 2 b 沙箱状态，在隔离环境中安全执行代码和工具。
`E2bSnapshotRefs`	class	`agentscope-extensions-sandbox-e2b`	E 2 b 快照 Refs，在隔离环境中安全执行代码和工具。

io.agentscope.extensions.sandbox.agentrun8

`AgentRunFilesystemSpec`	class	`agentscope-extensions-sandbox-agentrun`	智能体运行文件系统规格，在隔离环境中安全执行代码和工具。
`AgentRunHarnessSandboxJacksonModule`	class	`agentscope-extensions-sandbox-agentrun`	智能体运行 Harness 沙箱 Jackson Module，在隔离环境中安全执行代码和工具。
`AgentRunNasMountConfig`	class	`agentscope-extensions-sandbox-agentrun`	智能体运行 Nas Mount 配置，保存相关配置项。
`AgentRunOssMountConfig`	class	`agentscope-extensions-sandbox-agentrun`	智能体运行 OSS Mount 配置，保存相关配置项。
`AgentRunSandbox`	class	`agentscope-extensions-sandbox-agentrun`	智能体运行沙箱，在隔离环境中安全执行代码和工具。
`AgentRunSandboxClient`	class	`agentscope-extensions-sandbox-agentrun`	智能体运行沙箱客户端，封装与远端服务的连接和调用。
`AgentRunSandboxClientOptions`	class	`agentscope-extensions-sandbox-agentrun`	用于`AgentRunSandboxClient`的选项。
`AgentRunSandboxState`	class	`agentscope-extensions-sandbox-agentrun`	智能体运行沙箱状态，在隔离环境中安全执行代码和工具。

io.agentscope.extensions.sandbox.kubernetes.client.exceptions8

`SandboxException`	class	`agentscope-extensions-sandbox-kubernetes`	沙箱异常，表示执行过程中的错误。
`SandboxMetadataException`	class	`agentscope-extensions-sandbox-kubernetes`	沙箱元数据异常，表示执行过程中的错误。
`SandboxNotFoundException`	class	`agentscope-extensions-sandbox-kubernetes`	沙箱未找到异常，表示执行过程中的错误。
`SandboxNotReadyException`	class	`agentscope-extensions-sandbox-kubernetes`	沙箱不就绪异常，表示执行过程中的错误。
`SandboxPortForwardException`	class	`agentscope-extensions-sandbox-kubernetes`	沙箱 Port Forward 异常，表示执行过程中的错误。
`SandboxRequestException`	class	`agentscope-extensions-sandbox-kubernetes`	沙箱请求异常，表示执行过程中的错误。
`SandboxTemplateNotFoundException`	class	`agentscope-extensions-sandbox-kubernetes`	沙箱模板未找到异常，表示执行过程中的错误。
`SandboxWarmPoolNotFoundException`	class	`agentscope-extensions-sandbox-kubernetes`	沙箱 Warm 连接池未找到异常，表示执行过程中的错误。

io.agentscope.extensions.sandbox.kubernetes.client7

`Builder`	class	`agentscope-extensions-sandbox-kubernetes`	`CreateSandboxOptions`的构建器。
`CommandExecutor`	class	`agentscope-extensions-sandbox-kubernetes`	命令执行器，在隔离环境中安全执行代码和工具。
`Constants`	class	`agentscope-extensions-sandbox-kubernetes`	Constants，在隔离环境中安全执行代码和工具。
`CreateSandboxOptions`	class	`agentscope-extensions-sandbox-kubernetes`	用于`SandboxClient#createSandbox(CreateSandboxOptions)`的选项。
`Filesystem`	class	`agentscope-extensions-sandbox-kubernetes`	文件系统，在隔离环境中安全执行代码和工具。
`Sandbox`	class	`agentscope-extensions-sandbox-kubernetes`	处理用于运行中沙箱实例。
`SandboxClient`	class	`agentscope-extensions-sandbox-kubernetes`	沙箱客户端，封装与远端服务的连接和调用。

io.agentscope.extensions.sandbox.daytona6

`DaytonaFilesystemSpec`	class	`agentscope-extensions-sandbox-daytona`	Daytona 文件系统规格，在隔离环境中安全执行代码和工具。
`DaytonaHarnessSandboxJacksonModule`	class	`agentscope-extensions-sandbox-daytona`	Daytona Harness 沙箱 Jackson Module，在隔离环境中安全执行代码和工具。
`DaytonaSandbox`	class	`agentscope-extensions-sandbox-daytona`	Daytona 沙箱，在隔离环境中安全执行代码和工具。
`DaytonaSandboxClient`	class	`agentscope-extensions-sandbox-daytona`	Daytona 沙箱客户端，封装与远端服务的连接和调用。
`DaytonaSandboxClientOptions`	class	`agentscope-extensions-sandbox-daytona`	用于`DaytonaSandboxClient`的选项。
`DaytonaSandboxState`	class	`agentscope-extensions-sandbox-daytona`	Daytona 沙箱状态，在隔离环境中安全执行代码和工具。

io.agentscope.extensions.sandbox.kubernetes6

`KubernetesFilesystemSpec`	class	`agentscope-extensions-sandbox-kubernetes`	Kubernetes 文件系统规格，在隔离环境中安全执行代码和工具。
`KubernetesHarnessSandboxJacksonModule`	class	`agentscope-extensions-sandbox-kubernetes`	Kubernetes Harness 沙箱 Jackson Module，在隔离环境中安全执行代码和工具。
`KubernetesSandbox`	class	`agentscope-extensions-sandbox-kubernetes`	Kubernetes 沙箱，在隔离环境中安全执行代码和工具。
`KubernetesSandboxClient`	class	`agentscope-extensions-sandbox-kubernetes`	Kubernetes 沙箱客户端，封装与远端服务的连接和调用。
`KubernetesSandboxClientOptions`	class	`agentscope-extensions-sandbox-kubernetes`	Kubernetes 沙箱客户端选项，保存相关配置项。
`KubernetesSandboxState`	class	`agentscope-extensions-sandbox-kubernetes`	Kubernetes 沙箱状态，在隔离环境中安全执行代码和工具。

io.agentscope.extensions.sandbox.kubernetes.client.config5

`DirectConnectionConfig`	class	`agentscope-extensions-sandbox-kubernetes`	Direct 连接配置，保存相关配置项。
`GatewayConnectionConfig`	class	`agentscope-extensions-sandbox-kubernetes`	网关连接配置，保存相关配置项。
`InClusterConnectionConfig`	class	`agentscope-extensions-sandbox-kubernetes`	In 集群连接配置，保存相关配置项。
`LocalTunnelConnectionConfig`	class	`agentscope-extensions-sandbox-kubernetes`	本地 Tunnel 连接配置，保存相关配置项。
`SandboxConnectionConfig`	interface	`agentscope-extensions-sandbox-kubernetes`	定义沙箱连接配置契约的接口。

io.agentscope.extensions.sandbox.kubernetes.client.internal.strategy5

`ConnectionStrategy`	interface	`agentscope-extensions-sandbox-kubernetes`	定义连接 Strategy契约的接口。
`DirectStrategy`	class	`agentscope-extensions-sandbox-kubernetes`	Direct Strategy，在隔离环境中安全执行代码和工具。
`GatewayStrategy`	class	`agentscope-extensions-sandbox-kubernetes`	网关 Strategy，在隔离环境中安全执行代码和工具。
`InClusterStrategy`	class	`agentscope-extensions-sandbox-kubernetes`	In 集群 Strategy，在隔离环境中安全执行代码和工具。
`PortForwardStrategy`	class	`agentscope-extensions-sandbox-kubernetes`	Port Forward Strategy，在隔离环境中安全执行代码和工具。

io.agentscope.extensions.sandbox.kubernetes.client.internal2

`K8sHelper`	class	`agentscope-extensions-sandbox-kubernetes`	K 8 s Helper，在隔离环境中安全执行代码和工具。
`SandboxConnector`	class	`agentscope-extensions-sandbox-kubernetes`	沙箱 Connector，在隔离环境中安全执行代码和工具。

io.agentscope.extensions.agentprotocol1

WorkspaceProtocolTaskRepository class agentscope-extensions-agent-protocol 工作区协议任务仓库，负责持久化与读取数据。

io.agentscope.extensions.sandbox.e2b.mounts1

E2bCloudBucketMountStrategy interface agentscope-extensions-sandbox-e2b 定义 E 2 b Cloud 存储桶 Mount Strategy契约的接口。

Python ↔ Java 对照Python ↔ Java

Python

WorkspaceBaseDockerWorkspaceE2BWorkspaceK8sWorkspaceLocalWorkspace

Java

WorkspaceSandboxSandboxManagerKubernetesSandboxE2bSandbox

两套实现共享同一概念模型，但在并发（async/await 与 Reactor）、打包（wheel 模块与 Maven 构件）和生命周期 API 上存在差异。需要精确签名时请使用 API 全景。The two implementations follow the same conceptual model but differ in concurrency (async/await vs Reactor), packaging (wheel modules vs Maven artifacts) and lifecycle APIs. Use the full API map to locate exact signatures.

打开 API 全景Open full API map →