类class io.agentscope.core.studio 2.x

StudioManager

public class StudioManager

源码Source io/agentscope/core/studio/StudioManager.java:53–270

Studio 管理器，对智能体行为进行评测、追踪与可观测性分析。位于 io.agentscope.core.studio 包。核心成员包括 init、getClient、getWebSocketClient、getConfig、isInitialized、shutdown。

Central manager for AgentScope Studio integration.

This class provides a simplified API for initializing Studio integration and accessing Studio clients. It manages the lifecycle of HTTP and WebSocket connections to Studio.

Usage example:

`// Initialize Studio integration
StudioManager.init()
.studioUrl("http://localhost:8000")
.project("MyProject")
.runName("experiment_001")
.initialize()
.block();

// Create agent with Studio hook
ReActAgent agent = ReActAgent.builder()
.name("Assistant")
.model(model)
.hook(new StudioMessageHook(StudioManager.getClient()))
.build();

// Agent calls automatically send messages to Studio
agent.call(msg).block();
`

嵌套类摘要Nested Class Summary

类Class	类型Kind	说明Description
`Builder`	类class	构建器，用于构建并配置目标实例。 Builder for configuring and initializing Studio integration.

方法摘要Method Summary

方法Method	说明Description
`public static Builder init()` static	初始化 `StudioManager` 实例。 Creates a new initialization builder.
`public static` `StudioClient getClient()` static	获取客户端。 Gets the Studio HTTP client.
`public static` `StudioWebSocketClient getWebSocketClient()` static	获取WebSocket 客户端。 Gets the Studio WebSocket client.
`public static` `StudioConfig getConfig()` static	获取配置。 Gets the Studio configuration.
`public static boolean isInitialized()` static	判断是否已初始化。 Checks if Studio integration is initialized.
`public static void shutdown()` static	关闭资源并释放连接。 Shuts down Studio integration and releases resources.

方法详情Method Detail

init

public static Builder init()

static

初始化 StudioManager 实例。

Creates a new initialization builder.

返回Returns Builder

返回当前实例，以支持链式调用。A new builder for configuring Studio integration

源码Source io/agentscope/core/studio/StudioManager.java:69–71

getClient

public static StudioClient getClient()

static

获取客户端。

Gets the Studio HTTP client.

返回Returns StudioClient

返回StudioClient。The Studio HTTP client, or null if not initialized

源码Source io/agentscope/core/studio/StudioManager.java:78–80

getWebSocketClient

public static StudioWebSocketClient getWebSocketClient()

static

获取WebSocket 客户端。

Gets the Studio WebSocket client.

返回Returns StudioWebSocketClient

返回StudioWebSocketClient。The Studio WebSocket client, or null if not initialized

源码Source io/agentscope/core/studio/StudioManager.java:87–89

getConfig

public static StudioConfig getConfig()

static

获取配置。

Gets the Studio configuration.

返回Returns StudioConfig

返回StudioConfig。The Studio configuration, or null if not initialized

源码Source io/agentscope/core/studio/StudioManager.java:96–98

isInitialized

public static boolean isInitialized()

static

判断是否已初始化。

Checks if Studio integration is initialized.

返回Returns boolean

返回布尔值，表示判断结果。true if Studio is initialized, false otherwise

源码Source io/agentscope/core/studio/StudioManager.java:105–107

shutdown

public static void shutdown()

static

关闭资源并释放连接。

Shuts down Studio integration and releases resources.

源码Source io/agentscope/core/studio/StudioManager.java:112–123

嵌套类详情Nested Class Detail

Builder

public static class Builder

构建器，用于构建并配置目标实例。位于 io.agentscope.core.studio 包。核心成员包括 studioUrl、tracingUrl、project、runName、maxRetries、reconnectAttempts。

Builder for configuring and initializing Studio integration.