TrainingSandboxClient
public class TrainingSandboxClient extends SandboxClient源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:33–436Training 沙箱客户端，封装与远端服务的连接和调用。位于 io.agentscope.runtime.sandbox.manager.util 包，继承自 SandboxClient。核心成员包括 addMcpServers、checkHealth、waitUntilHealthy、getTaskIds、getEnvProfile、getToolsInfo。
A class in io.agentscope.runtime.sandbox.manager.util that deploys, schedules and serves agents. Declared in io.agentscope.runtime.sandbox.manager.util. Extends SandboxClient.
构造器摘要Constructor Summary
| 构造器Constructor | 说明Description |
|---|---|
public TrainingSandboxClient(ContainerModel containerModel, int timeout) | 初始化 `TrainingSandboxClient` 实例。 Constructor with ContainerModel |
public TrainingSandboxClient(String baseUrl, int timeout) | 初始化 `TrainingSandboxClient` 实例。 Constructor with base URL |
方法摘要Method Summary
构造器详情Constructor Detail
TrainingSandboxClient
public TrainingSandboxClient(ContainerModel containerModel, int timeout)初始化 TrainingSandboxClient 实例。
Constructor with ContainerModel
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
containerModel | ContainerModel | 容器模型（类型 `ContainerModel`）。Container model with base URL information |
timeout | int | 超时时间（类型 `int`）。Timeout in seconds |
源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:47–49TrainingSandboxClient
public TrainingSandboxClient(String baseUrl, int timeout)初始化 TrainingSandboxClient 实例。
Constructor with base URL
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
baseUrl | String | 基类 URL（类型 `String`）。Base URL of the training sandbox service |
timeout | int | 超时时间（类型 `int`）。Timeout in seconds |
源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:57–74方法详情Method Detail
addMcpServers
public Map<String, Object> addMcpServers(Map<String, Object> serverConfigs, boolean overwrite)添加 addMcpServers。
Adds the mcp servers.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
serverConfigs | Map<String, Object> | 服务端 Configs（类型 `Map`）。The server configs. |
overwrite | boolean | overwrite（类型 `boolean`）。The overwrite. |
Map<String, Object>返回映射。Returns map.
源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:76–79checkHealth
public boolean checkHealth()检查健康状态。
Returns the check health.
boolean返回布尔值，表示判断结果。Returns a boolean result.
源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:82–99waitUntilHealthy
public void waitUntilHealthy()等待 waitUntilHealthy。
Returns the wait until healthy.
源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:101–120getTaskIds
public Object getTaskIds(String envType, String split, Map<String, Object> params)获取任务 IDs 用于特定环境。
Get task IDs for a specific environment
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
envType | String | env 类型（类型 `String`）。Environment type |
split | String | 已拆分（类型 `String`）。Data split (e.g., "train", "test") |
params | Map<String, Object> | 参数（类型 `Map`）。Additional parameters |
Object返回对象。Task IDs data
源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:189–202getEnvProfile
public String getEnvProfile(String envType, String split, Map<String, Object> params)获取环境配置档案。
Get environment profile
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
envType | String | env 类型（类型 `String`）。Environment type |
split | String | 已拆分（类型 `String`）。Data split |
params | Map<String, Object> | 参数（类型 `Map`）。Additional parameters |
String返回字符串结果。Environment profile data
源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:212–230getToolsInfo
public Map<String, Object> getToolsInfo(String instanceId, Map<String, Object> messages, Map<String, Object> params)获取工具信息。
Get tools information for an instance
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
instanceId | String | 实例标识（类型 `String`）。Instance ID |
messages | Map<String, Object> | 消息列表（类型 `Map`）。Messages |
params | Map<String, Object> | 参数（类型 `Map`）。Parameters |
Map<String, Object>返回映射。BaseSandboxTool information
源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:240–270createInstance
public String createInstance(String envType, String taskId, String instanceId, Map<String, Object> params)创建实例。
Create a training instance
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
envType | String | env 类型（类型 `String`）。Environment type |
taskId | String | 任务标识（类型 `String`）。Task ID |
instanceId | String | 实例标识（类型 `String`）。Instance ID (optional) |
params | Map<String, Object> | 参数（类型 `Map`）。Additional parameters |
String返回字符串结果。Created instance information
源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:281–296step
public String step(String instanceId, Map<String, Object> action, Map<String, Object> params)执行步骤相关操作。
Execute a step in the training environment
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
instanceId | String | 实例标识（类型 `String`）。Instance ID |
action | Map<String, Object> | 动作（类型 `Map`）。Action to perform |
params | Map<String, Object> | 参数（类型 `Map`）。Additional parameters |
String返回字符串结果。Step result
源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:306–321evaluate
public String evaluate(String instanceId, Map<String, Object> messages, Map<String, Object> params)执行 evaluate 方法。
Evaluate instance performance
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
instanceId | String | 实例标识（类型 `String`）。Instance ID |
messages | Map<String, Object> | 消息列表（类型 `Map`）。Evaluation messages |
params | Map<String, Object> | 参数（类型 `Map`）。Additional parameters |
String返回字符串结果。Evaluation results
源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:331–346releaseInstance
public String releaseInstance(String instanceId)设置该参数。
Release a training instance
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
instanceId | String | 实例标识（类型 `String`）。Instance ID |
String返回字符串结果。true if released successfully
源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:354–365callTool
public String callTool(String name, Map<String, Object> arguments)调用工具。
Call a tool by name
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
name | String | 名称（类型 `String`）。BaseSandboxTool name |
arguments | Map<String, Object> | 参数（类型 `Map`）。Arguments |
String返回字符串结果。BaseSandboxTool result
源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:374–412listTools
public Map<String, Object> listTools(String toolType, Map<String, Object> arguments)列出工具。
Lists the tools.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
toolType | String | 工具类型（类型 `String`）。The tool type. |
arguments | Map<String, Object> | 参数（类型 `Map`）。The arguments. |
Map<String, Object>返回映射。Returns map.
源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:423–431close
public void close() throws IOException关闭连接并释放相关资源。
Releases resources and connections.
IOException可能抛出 `IOException`。Thrown when the operation cannot be completed.
源码Source
io/agentscope/runtime/sandbox/manager/util/TrainingSandboxClient.java:433–435