AS AgentScopeAPI 手册 / API Reference

AgentEventConverterRegistry

public class AgentEventConverterRegistry
源码Source 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.

源码Source io/agentscope/core/agui/adapter/strategy/AgentEventConverterRegistry.java:40–42

AgentEventConverterRegistry

public AgentEventConverterRegistry(List<AgentEventConverter> customConverters, List<AguiEventEnricher> enrichers)

初始化 AgentEventConverterRegistry 实例。

Create a registry with built-in converters, custom converters, and event enrichers.

参数Parameters
名称Name类型Type说明Description
customConvertersList<AgentEventConverter>自定义 Converters(类型 `List`)。converters registered after built-in converters
enrichersList<AguiEventEnricher>enrichers(类型 `List`)。enrichers applied after each conversion
源码Source io/agentscope/core/agui/adapter/strategy/AgentEventConverterRegistry.java:50–53

AgentEventConverterRegistry

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.

参数Parameters
名称Name类型Type说明Description
customConvertersList<AgentEventConverter>自定义 Converters(类型 `List`)。converters registered after built-in converters
enrichersList<AguiEventEnricher>enrichers(类型 `List`)。enrichers applied after each conversion
emitSubagentEventsAsNativeboolean发出子智能体事件 As 原生(类型 `boolean`)。when `true`, child events use the same converters as the parent; when `false` (default), `source != null` events become ` subagent.*` CUSTOM / RAW events
源码Source 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.

参数Parameters
名称Name类型Type说明Description
eventAgentEvent事件(类型 `AgentEvent`)。source AgentScope event
contextAguiStreamContext上下文(类型 `AguiStreamContext`)。stream conversion context
返回Returns List<AguiEvent>
返回列出。converted and enriched AG-UI events
源码Source io/agentscope/core/agui/adapter/strategy/AgentEventConverterRegistry.java:96–108

enrich

public List<AguiEvent> enrich(AgentEvent source, List<AguiEvent> events, AguiStreamContext context)

执行 enrich 方法。

Apply configured enrichers to AG-UI events in registration order.

参数Parameters
名称Name类型Type说明Description
sourceAgentEvent来源(类型 `AgentEvent`)。source AgentScope event, or `null` for framework-created events
eventsList<AguiEvent>事件列表(类型 `List`)。AG-UI events to enrich
contextAguiStreamContext上下文(类型 `AguiStreamContext`)。stream conversion context
返回Returns List<AguiEvent>
返回列出。enriched AG-UI events
源码Source io/agentscope/core/agui/adapter/strategy/AgentEventConverterRegistry.java:118–131
基于官方固定版本源码静态生成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.