KubernetesSandboxClient
public class KubernetesSandboxClient implements io.agentscope.harness.agent.sandbox.SandboxClient< KubernetesSandboxClientOptions>源码Source
io/agentscope/extensions/sandbox/kubernetes/KubernetesSandboxClient.java:48–320Kubernetes 沙箱客户端，封装与远端服务的连接和调用。位于 io.agentscope.extensions.sandbox.kubernetes 包，实现 io.agentscope.harness.agent.sandbox.SandboxClient<KubernetesSandboxClientOptions>。核心成员包括 create、resume、delete、serializeState、deserializeState、toConnectionConfig。
Harness io.agentscope.harness.agent.sandbox.SandboxClient for
agent-sandbox backed Kubernetes sandboxes.
Delegates lifecycle and transport to the Java agent-sandbox client SDK
(SandboxClient).
构造器摘要Constructor Summary
方法摘要Method Summary
| 方法Method | 说明Description |
|---|---|
public Sandbox create(WorkspaceSpec workspaceSpec, SandboxSnapshotSpec snapshotSpec, KubernetesSandboxClientOptions options) | 创建并返回实例。 Creates and returns an instance. |
public Sandbox resume(SandboxState state) | 设置恢复。 Performs the resume operation. |
public void delete(Sandbox sandbox) | 删除数据。 Performs the delete operation. |
public String serializeState(SandboxState state) | 执行状态。 Performs the serialize state operation. |
public SandboxState deserializeState(String json) | 执行状态。 Performs the deserialize state operation. |
public SandboxState deserializeState(String json, SandboxSnapshotSpec snapshotSpec) | 执行状态。 Restores the runtime storage client omitted from remote snapshot JSON while keeping the
persisted archive id. |
public static SandboxConnectionConfig toConnectionConfig(KubernetesSandboxClientOptions opts)static | 设置到连接配置。 Maps harness options to an SDK connection config. |
构造器详情Constructor Detail
KubernetesSandboxClient
public KubernetesSandboxClient()初始化 KubernetesSandboxClient 实例。
Creates a new instance.
源码Source
io/agentscope/extensions/sandbox/kubernetes/KubernetesSandboxClient.java:57–59KubernetesSandboxClient
public KubernetesSandboxClient(KubernetesSandboxClientOptions defaultOptions)初始化 KubernetesSandboxClient 实例。
Creates a new instance.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
defaultOptions | KubernetesSandboxClientOptions | 默认选项（类型 `KubernetesSandboxClientOptions`）。The default options. |
源码Source
io/agentscope/extensions/sandbox/kubernetes/KubernetesSandboxClient.java:61–63KubernetesSandboxClient
public KubernetesSandboxClient(KubernetesSandboxClientOptions defaultOptions, ObjectMapper objectMapper)初始化 KubernetesSandboxClient 实例。
Creates a new instance.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
defaultOptions | KubernetesSandboxClientOptions | 默认选项（类型 `KubernetesSandboxClientOptions`）。template options merged into each `#create` call |
objectMapper | ObjectMapper | 对象 Mapper（类型 `ObjectMapper`）。optional mapper; when null a default mapper is created with harness and Kubernetes Jackson modules |
源码Source
io/agentscope/extensions/sandbox/kubernetes/KubernetesSandboxClient.java:70–81方法详情Method Detail
create
public Sandbox create(WorkspaceSpec workspaceSpec, SandboxSnapshotSpec snapshotSpec, KubernetesSandboxClientOptions options)创建并返回实例。
Creates and returns an instance.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
workspaceSpec | WorkspaceSpec | 工作区规格（类型 `WorkspaceSpec`）。The workspace spec. |
snapshotSpec | SandboxSnapshotSpec | 快照规格（类型 `SandboxSnapshotSpec`）。The snapshot spec. |
options | KubernetesSandboxClientOptions | 选项（类型 `KubernetesSandboxClientOptions`）。The options. |
Sandbox返回沙箱。Returns sandbox.
源码Source
io/agentscope/extensions/sandbox/kubernetes/KubernetesSandboxClient.java:83–146resume
public Sandbox resume(SandboxState state)设置恢复。
Performs the resume operation.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
state | SandboxState | 状态对象（类型 `SandboxState`）。The state. |
Sandbox返回沙箱。Returns sandbox.
源码Source
io/agentscope/extensions/sandbox/kubernetes/KubernetesSandboxClient.java:148–166delete
public void delete(Sandbox sandbox)删除数据。
Performs the delete operation.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
sandbox | Sandbox | 沙箱（类型 `Sandbox`）。The sandbox. |
源码Source
io/agentscope/extensions/sandbox/kubernetes/KubernetesSandboxClient.java:168–171serializeState
public String serializeState(SandboxState state)执行状态。
Performs the serialize state operation.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
state | SandboxState | 状态对象（类型 `SandboxState`）。The state. |
String返回字符串结果。Returns a string.
源码Source
io/agentscope/extensions/sandbox/kubernetes/KubernetesSandboxClient.java:173–181deserializeState
public SandboxState deserializeState(String json)执行状态。
Performs the deserialize state operation.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
json | String | JSON（类型 `String`）。The json. |
SandboxState返回SandboxState。Returns sandbox state.
源码Source
io/agentscope/extensions/sandbox/kubernetes/KubernetesSandboxClient.java:183–191deserializeState
public SandboxState deserializeState(String json, SandboxSnapshotSpec snapshotSpec)执行状态。
Restores the runtime storage client omitted from remote snapshot JSON while keeping the persisted archive id.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
json | String | JSON（类型 `String`）。The json. |
snapshotSpec | SandboxSnapshotSpec | 快照规格（类型 `SandboxSnapshotSpec`）。The snapshot spec. |
SandboxState返回SandboxState。Returns sandbox state.
源码Source
io/agentscope/extensions/sandbox/kubernetes/KubernetesSandboxClient.java:198–206toConnectionConfig
public static SandboxConnectionConfig toConnectionConfig(KubernetesSandboxClientOptions opts)static
设置到连接配置。
Maps harness options to an SDK connection config.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
opts | KubernetesSandboxClientOptions | opts（类型 `KubernetesSandboxClientOptions`）。harness options |
SandboxConnectionConfig返回SandboxConnectionConfig。SDK connection config
源码Source
io/agentscope/extensions/sandbox/kubernetes/KubernetesSandboxClient.java:224–245