消息·事件·格式化Messages, events & formatting
Msg、内容块、流式事件与各家模型格式化器。它定义了 AgentScope 内部以及对外协议之间的数据契约,是排查“消息丢失/顺序错乱/格式不兼容”的第一站。Messages, content blocks, streaming events and provider formatters: the data contracts inside AgentScope and at protocol boundaries.
心智模型Mental model
Msg 与内容块是系统内唯一的数据契约;事件把流式增量、工具调用和生命周期状态结构化,便于前端和中间件消费。Msg and content blocks are the single data contract; events structure streaming deltas, tool calls and lifecycle state for UIs and middleware.
先学什么What to learn first
- 消息角色只有 system/user/assistant/tool 四类,工具结果绑定 tool_call id。There are only system/user/assistant/tool roles; tool results bind to tool-call ids.
- 流式场景处理增量块与最终消息的合并,避免重复渲染。In streaming UIs, merge incremental blocks with the final message to avoid duplicates.
- 跨语言或跨协议时先转换到 Msg,再交给 Formatter。Convert across languages or protocols into Msg first, then hand it to a Formatter.
生产常见坑Production pitfalls
- 把 HTML/Markdown 当作结构化内容塞进 text 块,前端无法安全渲染。Packing HTML or Markdown into text blocks makes rendering unsafe and lossy.
- 工具结果缺少 tool_call id,模型无法关联。Tool results without tool-call ids cannot be correlated by the model.
域内图谱Domain map
点击节点打开 API 页面;拖拽平移,滚轮缩放。Click a node to open its API page. Drag to pan, scroll to zoom.
Python API 集Python API set 68
归入本功能域的全部 Python 公开类型,按所属包分组。Every public Python type classified into this domain, grouped by owning package.
agentscope.event33
ConfirmResult | class | 用于工具调用的确认结果。 |
CustomEvent | class | 自定义事件,描述执行过程中的事件。 |
DataBlockDeltaEvent | class | 数据块增量事件,描述执行过程中的事件。 |
DataBlockEndEvent | class | 数据块结束事件,描述执行过程中的事件。 |
DataBlockStartEvent | class | 数据块启动事件,描述执行过程中的事件。 |
EventBase | class | 基类事件。 |
EventType | class | 事件类型,在智能体、模型与前端之间传递结构化消息和事件。 |
ExceedMaxItersEvent | class | 超出最大迭代次数事件,描述执行过程中的事件。 |
ExternalExecutionResultEvent | class | 外部执行结果事件,描述执行过程中的事件。 |
HintBlockEvent | class | Hint 块事件,描述执行过程中的事件。 |
ModelCallEndEvent | class | 模型调用结束事件,描述执行过程中的事件。 |
ModelCallStartEvent | class | 模型调用启动事件,描述执行过程中的事件。 |
ReplyEndEvent | class | 回复结束事件,描述执行过程中的事件。 |
ReplyEndReason | class | 回复结束推理,在智能体、模型与前端之间传递结构化消息和事件。 |
ReplyFinishedReason | class | 回复 Finished 推理,在智能体、模型与前端之间传递结构化消息和事件。 |
ReplyStartEvent | class | 回复启动事件,描述执行过程中的事件。 |
RequireExternalExecutionEvent | class | Require 外部执行事件,描述执行过程中的事件。 |
RequireUserConfirmEvent | class | Require 用户确认事件,描述执行过程中的事件。 |
TextBlockDeltaEvent | class | 文本块增量事件,描述执行过程中的事件。 |
TextBlockEndEvent | class | 文本块结束事件,描述执行过程中的事件。 |
TextBlockStartEvent | class | 文本块启动事件,描述执行过程中的事件。 |
ThinkingBlockDeltaEvent | class | Thinking 块增量事件,描述执行过程中的事件。 |
ThinkingBlockEndEvent | class | Thinking 块结束事件,描述执行过程中的事件。 |
ThinkingBlockStartEvent | class | Thinking 块启动事件,描述执行过程中的事件。 |
ToolCallDeltaEvent | class | 工具调用增量事件,描述执行过程中的事件。 |
ToolCallEndEvent | class | 工具调用结束事件,描述执行过程中的事件。 |
ToolCallStartEvent | class | 工具调用启动事件,描述执行过程中的事件。 |
ToolResultDataDeltaEvent | class | 工具结果数据增量事件,描述执行过程中的事件。 |
ToolResultEndEvent | class | 工具结果结束事件,描述执行过程中的事件。 |
ToolResultStartEvent | class | 工具结果启动事件,描述执行过程中的事件。 |
ToolResultTextDeltaEvent | class | 工具结果文本增量事件,描述执行过程中的事件。 |
UserConfirmResultEvent | class | 用户确认结果事件,描述执行过程中的事件。 |
UserInterruptEvent | class | 用户中断事件,描述执行过程中的事件。 |
agentscope.formatter23
AnthropicChatFormatter | class | Anthropic 聊天格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
AnthropicMultiAgentFormatter | class | Anthropic Multi 智能体格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
DashScopeChatFormatter | class | DashScope 聊天格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
DashScopeMultiAgentFormatter | class | DashScope Multi 智能体格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
DeepSeekChatFormatter | class | DeepSeek 聊天格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
DeepSeekMultiAgentFormatter | class | DeepSeek Multi 智能体格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
FormatterBase | class | 消息格式转换基类 |
GeminiChatFormatter | class | Gemini 聊天格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
GeminiMultiAgentFormatter | class | Gemini Multi 智能体格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
MiniMaxChatFormatter | class | MiniMax 聊天格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
MiniMaxMultiAgentFormatter | class | MiniMax Multi 智能体格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
MoonshotChatFormatter | class | Moonshot 聊天格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
MoonshotMultiAgentFormatter | class | Moonshot Multi 智能体格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
OllamaChatFormatter | class | Ollama 聊天格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
OllamaMultiAgentFormatter | class | Ollama Multi 智能体格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
OpenAIChatFormatter | class | OpenAI 聊天格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
OpenAIMultiAgentFormatter | class | OpenAI Multi 智能体格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
OpenAIResponseFormatter | class | OpenAIResponse 格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
OpenAIResponseMultiAgentFormatter | class | OpenAIResponse Multi 智能体格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
VolcengineChatFormatter | class | 火山引擎聊天格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
VolcengineMultiAgentFormatter | class | 火山引擎 Multi 智能体格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
XAIChatFormatter | class | 用于xAI 聊天模型的格式化器。 |
XAIMultiAgentFormatter | class | xAI Multi 智能体格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
agentscope.message12
Base64Source | class | base64 来源。 |
DataBlock | class | 数据块,在智能体、模型与前端之间传递结构化消息和事件。 |
HintBlock | class | Hint 块,在智能体、模型与前端之间传递结构化消息和事件。 |
Msg | class | 统一消息对象 |
TextBlock | class | 文本块。 |
ThinkingBlock | class | Thinking 块,在智能体、模型与前端之间传递结构化消息和事件。 |
ToolCallBlock | class | 工具调用块。 |
ToolCallState | class | 工具调用的状态。 |
ToolResultBlock | class | 工具结果块。 |
ToolResultState | class | 工具结果状态。 |
URLSource | class | URL 来源。 |
Usage | class | 用量,在智能体、模型与前端之间传递结构化消息和事件。 |
Java API 集Java API set 145
归入本功能域的全部 Java 公开类型,按包分组并标注构件。Every public Java type classified into this domain, grouped by package with its artifact.
io.agentscope.core.message38
AssistantMessage | class | agentscope-core | Assistant 消息,在智能体、模型与前端之间传递结构化消息和事件。 |
AudioBlock | class | agentscope-core | 表示音频内容 in 消息。 |
Base64Source | class | agentscope-core | 基类 64 来源,在智能体、模型与前端之间传递结构化消息和事件。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
ContentBlock | class | agentscope-core | 内容块,在智能体、模型与前端之间传递结构化消息和事件。 |
DataBlock | class | agentscope-core | 数据块,在智能体、模型与前端之间传递结构化消息和事件。 |
GenerateReason | enum | agentscope-core | 定义Generate 推理相关取值的枚举。 |
HintBlock | class | agentscope-core | Hint 块,在智能体、模型与前端之间传递结构化消息和事件。 |
ImageBlock | class | agentscope-core | 表示图像内容 in 消息使用 URL 或 Base64 来源。 |
MessageMetadataKeys | class | agentscope-core | 消息元数据密钥,在智能体、模型与前端之间传递结构化消息和事件。 |
Msg | class | agentscope-core | Java 消息模型 |
MsgRole | enum | agentscope-core | 定义消息角色相关取值的枚举。 |
Source | class | agentscope-core | 来源,在智能体、模型与前端之间传递结构化消息和事件。 |
SystemMessage | class | agentscope-core | 系统消息,在智能体、模型与前端之间传递结构化消息和事件。 |
TextBlock | class | agentscope-core | 文本块,在智能体、模型与前端之间传递结构化消息和事件。 |
ThinkingBlock | class | agentscope-core | Thinking 块,在智能体、模型与前端之间传递结构化消息和事件。 |
ToolCallState | enum | agentscope-core | 定义工具调用状态的枚举。 |
ToolResultBlock | class | agentscope-core | 表示结果的工具执行。 |
ToolResultMessage | class | agentscope-core | 工具结果消息,在智能体、模型与前端之间传递结构化消息和事件。 |
ToolResultState | enum | agentscope-core | 定义工具结果状态的枚举。 |
ToolUseBlock | class | agentscope-core | 工具使用块,在智能体、模型与前端之间传递结构化消息和事件。 |
URLSource | class | agentscope-core | URL 来源,在智能体、模型与前端之间传递结构化消息和事件。 |
UserMessage | class | agentscope-core | 用户消息,在智能体、模型与前端之间传递结构化消息和事件。 |
VideoBlock | class | agentscope-core | 表示视频内容 in 消息。 |
io.agentscope.core.agui.event36
ActivityDelta | record | agentscope-extensions-agui | 承载 Activity 增量数据的记录类型。 |
ActivitySnapshot | record | agentscope-extensions-agui | 承载 Activity 快照数据的记录类型。 |
AguiEvent | interface | agentscope-extensions-agui | 定义 AGUI 事件契约的接口。 |
AguiEvents | class | agentscope-extensions-agui | AGUI 事件,描述执行过程中的事件。 |
AguiEventType | enum | agentscope-extensions-agui | 定义AGUI 事件类型的枚举。 |
Custom | record | agentscope-extensions-agui | 承载自定义数据的记录类型。 |
Interrupt | record | agentscope-extensions-agui | 承载中断数据的记录类型。 |
JsonPatchOperation | record | agentscope-extensions-agui | 承载 JSON Patch Operation数据的记录类型。 |
MessagesSnapshot | record | agentscope-extensions-agui | 承载消息快照数据的记录类型。 |
Raw | record | agentscope-extensions-agui | 承载原始数据的记录类型。 |
ReasoningEncryptedValue | record | agentscope-extensions-agui | 承载推理已加密值数据的记录类型。 |
ReasoningEnd | record | agentscope-extensions-agui | 承载推理结束数据的记录类型。 |
ReasoningMessageChunk | record | agentscope-extensions-agui | 承载推理消息分块数据的记录类型。 |
ReasoningMessageContent | record | agentscope-extensions-agui | 承载推理消息内容数据的记录类型。 |
ReasoningMessageEnd | record | agentscope-extensions-agui | 承载推理消息结束数据的记录类型。 |
ReasoningMessageStart | record | agentscope-extensions-agui | 承载推理消息启动数据的记录类型。 |
ReasoningStart | record | agentscope-extensions-agui | 承载推理启动数据的记录类型。 |
RunError | record | agentscope-extensions-agui | 承载运行错误数据的记录类型。 |
RunFinished | record | agentscope-extensions-agui | 承载运行 Finished数据的记录类型。 |
RunFinishedInterruptOutcome | record | agentscope-extensions-agui | 承载运行 Finished 中断 Outcome数据的记录类型。 |
RunFinishedOutcome | interface | agentscope-extensions-agui | 定义运行 Finished Outcome契约的接口。 |
RunFinishedSuccessOutcome | record | agentscope-extensions-agui | 承载运行 Finished 成功 Outcome数据的记录类型。 |
RunStarted | record | agentscope-extensions-agui | 承载运行已启动数据的记录类型。 |
StateDelta | record | agentscope-extensions-agui | 承载状态增量数据的记录类型。 |
StateSnapshot | record | agentscope-extensions-agui | 承载状态快照数据的记录类型。 |
StepFinished | record | agentscope-extensions-agui | 承载步骤 Finished数据的记录类型。 |
StepStarted | record | agentscope-extensions-agui | 承载步骤已启动数据的记录类型。 |
TextMessageChunk | record | agentscope-extensions-agui | 承载文本消息分块数据的记录类型。 |
TextMessageContent | record | agentscope-extensions-agui | 承载文本消息内容数据的记录类型。 |
TextMessageEnd | record | agentscope-extensions-agui | 承载文本消息结束数据的记录类型。 |
TextMessageStart | record | agentscope-extensions-agui | 承载文本消息启动数据的记录类型。 |
ToolCallArgs | record | agentscope-extensions-agui | 承载工具调用参数数据的记录类型。 |
ToolCallChunk | record | agentscope-extensions-agui | 承载工具调用分块数据的记录类型。 |
ToolCallEnd | record | agentscope-extensions-agui | 承载工具调用结束数据的记录类型。 |
ToolCallResult | record | agentscope-extensions-agui | 承载工具调用结果数据的记录类型。 |
ToolCallStart | record | agentscope-extensions-agui | 承载工具调用启动数据的记录类型。 |
io.agentscope.core.event35
AgentEndEvent | class | agentscope-core | 智能体结束事件,描述执行过程中的事件。 |
AgentEvent | class | agentscope-core | 智能体事件,描述执行过程中的事件。 |
AgentEventEmitter | interface | agentscope-core | 定义智能体事件 Emitter契约的接口。 |
AgentEventType | enum | agentscope-core | 定义智能体事件类型的枚举。 |
AgentResultEvent | class | agentscope-core | 智能体结果事件,描述执行过程中的事件。 |
AgentStartEvent | class | agentscope-core | 智能体启动事件,描述执行过程中的事件。 |
AllToolsDeniedEvent | class | agentscope-core | 所有工具已拒绝事件,描述执行过程中的事件。 |
ConfirmResult | class | agentscope-core | 确认结果,在智能体、模型与前端之间传递结构化消息和事件。 |
CustomEvent | class | agentscope-core | 自定义事件,描述执行过程中的事件。 |
DataBlockDeltaEvent | class | agentscope-core | 数据块增量事件,描述执行过程中的事件。 |
DataBlockEndEvent | class | agentscope-core | 数据块结束事件,描述执行过程中的事件。 |
DataBlockStartEvent | class | agentscope-core | 数据块启动事件,描述执行过程中的事件。 |
ExceedMaxItersEvent | class | agentscope-core | 超出最大迭代次数事件,描述执行过程中的事件。 |
ExternalExecutionResultEvent | class | agentscope-core | 外部执行结果事件,描述执行过程中的事件。 |
HintBlockEvent | class | agentscope-core | Hint 块事件,描述执行过程中的事件。 |
ModelCallEndEvent | class | agentscope-core | 模型调用结束事件,描述执行过程中的事件。 |
ModelCallStartEvent | class | agentscope-core | 模型调用启动事件,描述执行过程中的事件。 |
RequestStopEvent | class | agentscope-core | 请求停止事件,描述执行过程中的事件。 |
RequireExternalExecutionEvent | class | agentscope-core | Require 外部执行事件,描述执行过程中的事件。 |
RequireUserConfirmEvent | class | agentscope-core | Require 用户确认事件,描述执行过程中的事件。 |
SubagentExposedEvent | class | agentscope-core | 子智能体 Exposed 事件,描述执行过程中的事件。 |
TextBlockDeltaEvent | class | agentscope-core | 文本块增量事件,描述执行过程中的事件。 |
TextBlockEndEvent | class | agentscope-core | 文本块结束事件,描述执行过程中的事件。 |
TextBlockStartEvent | class | agentscope-core | 文本块启动事件,描述执行过程中的事件。 |
ThinkingBlockDeltaEvent | class | agentscope-core | Thinking 块增量事件,描述执行过程中的事件。 |
ThinkingBlockEndEvent | class | agentscope-core | Thinking 块结束事件,描述执行过程中的事件。 |
ThinkingBlockStartEvent | class | agentscope-core | Thinking 块启动事件,描述执行过程中的事件。 |
ToolCallDeltaEvent | class | agentscope-core | 工具调用增量事件,描述执行过程中的事件。 |
ToolCallEndEvent | class | agentscope-core | 工具调用结束事件,描述执行过程中的事件。 |
ToolCallStartEvent | class | agentscope-core | 工具调用启动事件,描述执行过程中的事件。 |
ToolResultDataDeltaEvent | class | agentscope-core | 工具结果数据增量事件,描述执行过程中的事件。 |
ToolResultEndEvent | class | agentscope-core | 工具结果结束事件,描述执行过程中的事件。 |
ToolResultStartEvent | class | agentscope-core | 工具结果启动事件,描述执行过程中的事件。 |
ToolResultTextDeltaEvent | class | agentscope-core | 工具结果文本增量事件,描述执行过程中的事件。 |
UserConfirmResultEvent | class | agentscope-core | 用户确认结果事件,描述执行过程中的事件。 |
io.agentscope.core.formatter8
AbstractBaseFormatter | class | agentscope-core | 抽象基类格式化器,在智能体、模型与前端之间传递结构化消息和事件。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Builder | class | agentscope-core | 构建器,用于构建并配置目标实例。 |
Formatter | interface | agentscope-core | 请求与响应格式转换器 |
FormatterException | class | agentscope-core | 格式化器异常,表示执行过程中的错误。 |
JsonSchema | class | agentscope-core | JSON 模式,在智能体、模型与前端之间传递结构化消息和事件。 |
MediaUtils | class | agentscope-core | Media Utils,在智能体、模型与前端之间传递结构化消息和事件。 |
ResponseFormat | class | agentscope-core | 用于模型 APIs的响应格式配置。 |
io.agentscope.core.agui5
AgentNotFoundException | class | agentscope-extensions-agui | 智能体未找到异常,表示执行过程中的错误。 |
AguiException | class | agentscope-extensions-agui | AGUI 异常,表示执行过程中的错误。 |
AguiInterruptConstants | class | agentscope-extensions-agui | AGUI 中断 Constants,在智能体、模型与前端之间传递结构化消息和事件。 |
AguiUtil | class | agentscope-extensions-agui | AGUI Util,在智能体、模型与前端之间传递结构化消息和事件。 |
EncodingException | class | agentscope-extensions-agui | Encoding 异常,表示执行过程中的错误。 |
io.agentscope.core.agui.adapter.strategy5
AgentEventConverter | interface | agentscope-extensions-agui | 定义智能体事件转换器契约的接口。 |
AgentEventConverterRegistry | class | agentscope-extensions-agui | 智能体事件转换器注册表,在智能体、模型与前端之间传递结构化消息和事件。 |
AguiEventEnricher | interface | agentscope-extensions-agui | 定义 AGUI 事件 Enricher契约的接口。 |
AguiStreamContext | class | agentscope-extensions-agui | AGUI 流上下文,在智能体、模型与前端之间传递结构化消息和事件。 |
BaseEventPropertiesEnricher | class | agentscope-extensions-agui | 基类事件属性 Enricher,在智能体、模型与前端之间传递结构化消息和事件。 |
io.agentscope.core.agui.runtime5
AguiRequestBodyParser | class | agentscope-extensions-agui | AGUI 请求正文解析器,在智能体、模型与前端之间传递结构化消息和事件。 |
AguiRuntimeContextRequest | class | agentscope-extensions-agui | AGUI 运行时上下文请求,在智能体、模型与前端之间传递结构化消息和事件。 |
AguiRuntimeContextResolver | interface | agentscope-extensions-agui | 定义 AGUI 运行时上下文解析器契约的接口。 |
Builder | class | agentscope-extensions-agui | `AguiRuntimeContextRequest`的构建器。 |
Transport | enum | agentscope-extensions-agui | 定义传输层相关取值的枚举。 |
io.agentscope.core.agui.adapter4
AguiAdapterConfig | class | agentscope-extensions-agui | 用于AG-UI 智能体适配器的配置。 |
AguiAgentAdapter | class | agentscope-extensions-agui | AGUI 智能体适配器,在智能体、模型与前端之间传递结构化消息和事件。 |
AguiAgentAdapterFactory | interface | agentscope-extensions-agui | 定义 AGUI 智能体适配器工厂契约的接口。 |
Builder | class | agentscope-extensions-agui | AguiAdapterConfig的构建器。 |
io.agentscope.core.agui.processor4
AgentResolver | interface | agentscope-extensions-agui | 定义智能体解析器契约的接口。 |
AguiRequestProcessor | class | agentscope-extensions-agui | AGUI 请求处理器,在智能体、模型与前端之间传递结构化消息和事件。 |
Builder | class | agentscope-extensions-agui | AguiRequestProcessor的构建器。 |
ProcessResult | record | agentscope-extensions-agui | 承载 Process 结果数据的记录类型。 |
io.agentscope.core.agui.converter3
AguiMessageConverter | class | agentscope-extensions-agui | AGUI 消息转换器,在智能体、模型与前端之间传递结构化消息和事件。 |
AguiStateConverter | class | agentscope-extensions-agui | 用于状态管理,使用 AG-UI 协议的转换器。 |
AguiToolConverter | class | agentscope-extensions-agui | AGUI 工具转换器,在智能体、模型与前端之间传递结构化消息和事件。 |
io.agentscope.core.agui.encoder1
AguiEventEncoder | class | agentscope-extensions-agui | AGUI 事件 Encoder,在智能体、模型与前端之间传递结构化消息和事件。 |
io.agentscope.core.agui.registry1
AguiAgentRegistry | class | agentscope-extensions-agui | AGUI 智能体注册表,在智能体、模型与前端之间传递结构化消息和事件。 |
Python ↔ Java 对照Python ↔ Java
两套实现共享同一概念模型,但在并发(async/await 与 Reactor)、打包(wheel 模块与 Maven 构件)和生命周期 API 上存在差异。需要精确签名时请使用 API 全景。The two implementations follow the same conceptual model but differ in concurrency (async/await vs Reactor), packaging (wheel modules vs Maven artifacts) and lifecycle APIs. Use the full API map to locate exact signatures.