AS AgentScopeAPI 手册 / API Reference

BaseClient

public abstract class BaseClient
源码Source io/agentscope/runtime/sandbox/manager/client/container/BaseClient.java:29–128

基类客户端,封装与远端服务的连接和调用。位于 io.agentscope.runtime.sandbox.manager.client.container 包。核心成员包括 connect、createContainer、startContainer、stopContainer、removeContainer、getContainerStatus。

Container management client base class Defines basic interfaces for container management, supports Docker and Kubernetes implementations

方法摘要Method Summary

方法Method说明Description
public abstract boolean connect()
abstract
建立连接并完成初始化。
Connect to container management service
public abstract ContainerCreateResult createContainer(String containerName, String imageName, List<String> ports, List<VolumeBinding> volumeBindings, Map<String, String> environment, Map<String, Object> runtimeConfig)
abstract
创建容器。
Create container
public abstract void startContainer(String containerId)
abstract
启动容器。
Start container
public abstract void stopContainer(String containerId)
abstract
停止容器。
Stop container
public abstract void removeContainer(String containerId)
abstract
移除容器。
Remove container
public abstract String getContainerStatus(String containerId)
abstract
获取容器状态。
Get container status
public void stopAndRemoveContainer(String containerId)
停止和移除容器。
Stop and remove container
public abstract boolean isConnected()
abstract
检查连接状态。
Check connection status
public abstract boolean imageExists(String imageName)
abstract
设置该参数。
Check if image exists locally
public abstract boolean inspectContainer(String containerIdOrName)
abstract
设置该参数。
Inspect container to check if it exists
public abstract boolean pullImage(String imageName)
abstract
设置该参数。
Pull image from registry
public boolean ensureImageAvailable(String imageName)
设置确保图像可用。
Ensure image is available (check and pull if needed)
public boolean containerNameExists(String containerName)
设置该参数。
Performs the container name exists operation.

方法详情Method Detail

connect

public abstract boolean connect()
abstract

建立连接并完成初始化。

Connect to container management service

返回Returns boolean
返回布尔值,表示判断结果。connection status
源码Source io/agentscope/runtime/sandbox/manager/client/container/BaseClient.java:35

createContainer

public abstract ContainerCreateResult createContainer(String containerName, String imageName, List<String> ports, List<VolumeBinding> volumeBindings, Map<String, String> environment, Map<String, Object> runtimeConfig)
abstract

创建容器。

Create container

参数Parameters
名称Name类型Type说明Description
containerNameString容器名称(类型 `String`)。container name
imageNameString图像名称(类型 `String`)。image name
portsList<String>ports(类型 `List`)。port list
volumeBindingsList<VolumeBinding>volume Bindings(类型 `List`)。volume bindings
environmentMap<String, String>环境(类型 `Map`)。environment variables
runtimeConfigMap<String, Object>运行时配置(类型 `Map`)。runtime configuration
返回Returns ContainerCreateResult
返回ContainerCreateResult。ContainerCreateResult containing containerId, ports, ip, and optional protocol
源码Source io/agentscope/runtime/sandbox/manager/client/container/BaseClient.java:47–50

startContainer

public abstract void startContainer(String containerId)
abstract

启动容器。

Start container

参数Parameters
名称Name类型Type说明Description
containerIdString容器标识(类型 `String`)。container ID
源码Source io/agentscope/runtime/sandbox/manager/client/container/BaseClient.java:56

stopContainer

public abstract void stopContainer(String containerId)
abstract

停止容器。

Stop container

参数Parameters
名称Name类型Type说明Description
containerIdString容器标识(类型 `String`)。container ID
源码Source io/agentscope/runtime/sandbox/manager/client/container/BaseClient.java:62

removeContainer

public abstract void removeContainer(String containerId)
abstract

移除容器。

Remove container

参数Parameters
名称Name类型Type说明Description
containerIdString容器标识(类型 `String`)。container ID
源码Source io/agentscope/runtime/sandbox/manager/client/container/BaseClient.java:68

getContainerStatus

public abstract String getContainerStatus(String containerId)
abstract

获取容器状态。

Get container status

参数Parameters
名称Name类型Type说明Description
containerIdString容器标识(类型 `String`)。container ID
返回Returns String
返回字符串结果。container status
源码Source io/agentscope/runtime/sandbox/manager/client/container/BaseClient.java:75

stopAndRemoveContainer

public void stopAndRemoveContainer(String containerId)

停止和移除容器。

Stop and remove container

参数Parameters
名称Name类型Type说明Description
containerIdString容器标识(类型 `String`)。container ID
源码Source io/agentscope/runtime/sandbox/manager/client/container/BaseClient.java:81–84

isConnected

public abstract boolean isConnected()
abstract

检查连接状态。

Check connection status

返回Returns boolean
判断是否已连接。whether connected
源码Source io/agentscope/runtime/sandbox/manager/client/container/BaseClient.java:90

imageExists

public abstract boolean imageExists(String imageName)
abstract

设置该参数。

Check if image exists locally

参数Parameters
名称Name类型Type说明Description
imageNameString图像名称(类型 `String`)。image name
返回Returns boolean
返回布尔值,表示判断结果。whether image exists locally
源码Source io/agentscope/runtime/sandbox/manager/client/container/BaseClient.java:97

inspectContainer

public abstract boolean inspectContainer(String containerIdOrName)
abstract

设置该参数。

Inspect container to check if it exists

参数Parameters
名称Name类型Type说明Description
containerIdOrNameString容器标识或名称(类型 `String`)。container ID or name
返回Returns boolean
返回布尔值,表示判断结果。true if container exists, false otherwise
源码Source io/agentscope/runtime/sandbox/manager/client/container/BaseClient.java:104

pullImage

public abstract boolean pullImage(String imageName)
abstract

设置该参数。

Pull image from registry

参数Parameters
名称Name类型Type说明Description
imageNameString图像名称(类型 `String`)。image name
返回Returns boolean
返回布尔值,表示判断结果。whether pull was successful
源码Source io/agentscope/runtime/sandbox/manager/client/container/BaseClient.java:111

ensureImageAvailable

public boolean ensureImageAvailable(String imageName)

设置确保图像可用。

Ensure image is available (check and pull if needed)

参数Parameters
名称Name类型Type说明Description
imageNameString图像名称(类型 `String`)。image name
返回Returns boolean
判断是否图像是可用。whether image is available
源码Source io/agentscope/runtime/sandbox/manager/client/container/BaseClient.java:118–123

containerNameExists

public boolean containerNameExists(String containerName)

设置该参数。

Performs the container name exists operation.

参数Parameters
名称Name类型Type说明Description
containerNameString容器名称(类型 `String`)。The container name.
返回Returns boolean
返回布尔值,表示判断结果。Returns a boolean result.
源码Source io/agentscope/runtime/sandbox/manager/client/container/BaseClient.java:125–127
基于官方固定版本源码静态生成Generated from pinned official sources · Python 2.0.11 · Java 2.0.4
签名与文档为静态抽取;如有疑问请以源码为准。Signatures and docs are extracted statically; verify against the source when in doubt.