StudioClient
public class StudioClient
io/agentscope/core/studio/StudioClient.java:50–246Studio 客户端,封装与远端服务的连接和调用。位于 io.agentscope.core.studio 包。核心成员包括 registerRun、pushMessage、requestUserInput、shutdown、StudioClient。
HTTP client for communicating with AgentScope Studio.
This client handles HTTP requests to Studio's REST API endpoints using OkHttp. It provides methods for registering runs, pushing messages, and requesting user input. All operations are reactive and return Mono types for integration with Project Reactor.
The client includes automatic retry logic for failed requests (configurable via StudioConfig).
构造器摘要Constructor Summary
| 构造器Constructor | 说明Description |
|---|---|
public StudioClient(StudioConfig config) | 初始化 `StudioClient` 实例。 Creates a new Studio HTTP client. |
方法摘要Method Summary
| 方法Method | 说明Description |
|---|---|
public Mono<Void> registerRun() | 注册运行。 Registers a new run with Studio. |
public Mono<Void> pushMessage(Msg msg) | 设置推送消息。 Pushes a message to Studio for visualization. |
public Mono<String> requestUserInput(String agentId, String agentName, Object structuredSchema) | 执行请求用户输入相关操作。 Requests user input from Studio web interface. |
public void shutdown() | 关闭资源并释放连接。 Shuts down the HTTP client and releases resources. |
构造器详情Constructor Detail
StudioClient
public StudioClient(StudioConfig config)
初始化 StudioClient 实例。
Creates a new Studio HTTP client.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
config | StudioConfig | 配置对象(类型 `StudioConfig`)。Configuration for Studio connection |
io/agentscope/core/studio/StudioClient.java:67–77方法详情Method Detail
registerRun
public Mono<Void> registerRun()
注册运行。
Registers a new run with Studio.
Mono<Void>io/agentscope/core/studio/StudioClient.java:89–121pushMessage
public Mono<Void> pushMessage(Msg msg)
设置推送消息。
Pushes a message to Studio for visualization.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
msg | Msg | 消息到推送。The message to push |
Mono<Void>io/agentscope/core/studio/StudioClient.java:134–166requestUserInput
public Mono<String> requestUserInput(String agentId, String agentName, Object structuredSchema)
执行请求用户输入相关操作。
Requests user input from Studio web interface.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
agentId | String | 智能体标识(类型 `String`)。ID of the agent requesting input |
agentName | String | 智能体名称(类型 `String`)。Name of the agent requesting input |
structuredSchema | Object | 用于结构化输入的可选 JSON 模式。Optional JSON schema for structured input |
Mono<String>io/agentscope/core/studio/StudioClient.java:181–214shutdown
public void shutdown()
关闭资源并释放连接。
Shuts down the HTTP client and releases resources.
io/agentscope/core/studio/StudioClient.java:219–222