WorkspaceSpecApplier

public class WorkspaceSpecApplier

源码Source io/agentscope/harness/agent/sandbox/WorkspaceSpecApplier.java:50–165

工作区规格 Applier，承载智能体的部署、调度与服务化运行。位于 io.agentscope.harness.agent.sandbox 包。核心成员包括 applyWorkspaceSpec、WorkspaceSpecApplier。

Applies a WorkspaceSpec to a target directory by materializing declared entries (files, directories, local copies).

Supports two materialization modes:

onlyEphemeral=false: apply all entries (Branch C / D of sandbox start)
onlyEphemeral=true: apply only entries where WorkspaceEntry#isEphemeral() is true (Branch A / B of sandbox start)

构造器摘要Constructor Summary

构造器Constructor	说明Description
`public` `WorkspaceSpecApplier(String workspaceRoot)`	初始化 `WorkspaceSpecApplier` 实例。 Creates a new instance.
`public` `WorkspaceSpecApplier(Path workspaceRoot)`	初始化 `WorkspaceSpecApplier` 实例。 Creates a new instance.

方法Method	说明Description
`public void applyWorkspaceSpec(WorkspaceSpec spec, boolean onlyEphemeral) throws Exception`	应用工作区规格。 Performs the apply workspace spec operation.

public WorkspaceSpecApplier(String workspaceRoot)

初始化 WorkspaceSpecApplier 实例。

Creates a new instance.

参数Parameters

名称Name	类型Type	说明Description
`workspaceRoot`	String	工作区根（类型 `String`）。The workspace root.

源码Source io/agentscope/harness/agent/sandbox/WorkspaceSpecApplier.java:56–58

public WorkspaceSpecApplier(Path workspaceRoot)

初始化 WorkspaceSpecApplier 实例。

Creates a new instance.

参数Parameters

名称Name	类型Type	说明Description
`workspaceRoot`	Path	工作区根（类型 `Path`）。The workspace root.

源码Source io/agentscope/harness/agent/sandbox/WorkspaceSpecApplier.java:60–62

public void applyWorkspaceSpec(WorkspaceSpec spec, boolean onlyEphemeral) throws Exception

应用工作区规格。

Performs the apply workspace spec operation.

参数Parameters

名称Name	类型Type	说明Description
`spec`	WorkspaceSpec	规格（类型 `WorkspaceSpec`）。The spec.
`onlyEphemeral`	boolean	only Ephemeral（类型 `boolean`）。The only ephemeral.

抛出Throws

源码Source io/agentscope/harness/agent/sandbox/WorkspaceSpecApplier.java:64–70