AgentEventConverterRegistry
public class AgentEventConverterRegistry
io/agentscope/core/agui/adapter/strategy/AgentEventConverterRegistry.java:32–140智能体事件转换器注册表,在智能体、模型与前端之间传递结构化消息和事件。位于 io.agentscope.core.agui.adapter.strategy 包。核心成员包括 convert、enrich、AgentEventConverterRegistry。
Registry that maps AgentScope AgentEvent instances to AG-UI protocol events.
Built-in converters are registered first and custom converters are registered afterwards, so
a custom converter can override the mapping for the same AgentEvent type. Event
enrichers run after conversion and can add cross-cutting AG-UI base properties.
构造器摘要Constructor Summary
| 构造器Constructor | 说明Description |
|---|---|
public AgentEventConverterRegistry() | 初始化 `AgentEventConverterRegistry` 实例。 Creates a new instance. |
public AgentEventConverterRegistry(List<AgentEventConverter> customConverters, List<AguiEventEnricher> enrichers) | 初始化 `AgentEventConverterRegistry` 实例。 Create a registry with built-in converters, custom converters, and event enrichers. |
public AgentEventConverterRegistry(List<AgentEventConverter> customConverters, List<AguiEventEnricher> enrichers, boolean emitSubagentEventsAsNative) | 初始化 `AgentEventConverterRegistry` 实例。 Create a registry with built-in converters, custom converters, enrichers, and subagent
presentation mode. |
方法摘要Method Summary
| 方法Method | 说明Description |
|---|---|
public List<AguiEvent> convert(AgentEvent event, AguiStreamContext context) | 执行转换相关操作。 Convert one AgentScope event to zero or more AG-UI events. |
public List<AguiEvent> enrich(AgentEvent source, List<AguiEvent> events, AguiStreamContext context) | 执行 `enrich` 方法。 Apply configured enrichers to AG-UI events in registration order. |
构造器详情Constructor Detail
AgentEventConverterRegistry
public AgentEventConverterRegistry()
初始化 AgentEventConverterRegistry 实例。
Creates a new instance.
io/agentscope/core/agui/adapter/strategy/AgentEventConverterRegistry.java:40–42AgentEventConverterRegistry
public AgentEventConverterRegistry(List<AgentEventConverter> customConverters, List<AguiEventEnricher> enrichers)
初始化 AgentEventConverterRegistry 实例。
Create a registry with built-in converters, custom converters, and event enrichers.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
customConverters | List<AgentEventConverter> | 自定义 Converters(类型 `List`)。converters registered after built-in converters |
enrichers | List<AguiEventEnricher> | enrichers(类型 `List`)。enrichers applied after each conversion |
io/agentscope/core/agui/adapter/strategy/AgentEventConverterRegistry.java:50–53AgentEventConverterRegistry
public AgentEventConverterRegistry(List<AgentEventConverter> customConverters, List<AguiEventEnricher> enrichers, boolean emitSubagentEventsAsNative)
初始化 AgentEventConverterRegistry 实例。
Create a registry with built-in converters, custom converters, enrichers, and subagent presentation mode.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
customConverters | List<AgentEventConverter> | 自定义 Converters(类型 `List`)。converters registered after built-in converters |
enrichers | List<AguiEventEnricher> | enrichers(类型 `List`)。enrichers applied after each conversion |
emitSubagentEventsAsNative | boolean | 发出子智能体事件 As 原生(类型 `boolean`)。when `true`, child events use the same converters as the parent; when `false` (default), `source != null` events become ` subagent.*` CUSTOM / RAW events |
io/agentscope/core/agui/adapter/strategy/AgentEventConverterRegistry.java:65–87方法详情Method Detail
convert
public List<AguiEvent> convert(AgentEvent event, AguiStreamContext context)
执行转换相关操作。
Convert one AgentScope event to zero or more AG-UI events.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
event | AgentEvent | 事件(类型 `AgentEvent`)。source AgentScope event |
context | AguiStreamContext | 上下文(类型 `AguiStreamContext`)。stream conversion context |
List<AguiEvent>io/agentscope/core/agui/adapter/strategy/AgentEventConverterRegistry.java:96–108enrich
public List<AguiEvent> enrich(AgentEvent source, List<AguiEvent> events, AguiStreamContext context)
执行 enrich 方法。
Apply configured enrichers to AG-UI events in registration order.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
source | AgentEvent | 来源(类型 `AgentEvent`)。source AgentScope event, or `null` for framework-created events |
events | List<AguiEvent> | 事件列表(类型 `List`)。AG-UI events to enrich |
context | AguiStreamContext | 上下文(类型 `AguiStreamContext`)。stream conversion context |
List<AguiEvent>io/agentscope/core/agui/adapter/strategy/AgentEventConverterRegistry.java:118–131