Message 和 Event 的关系是:
- Event 是 Msg 的“建造过程日志”,Msg 是 Event 流的“最终物化结果”。
- 一对一映射 + 可完全重建 是核心契约:
- 单次 reply → 一系列 Event → 恰好一条 assistant Msg。
设计本质:
- 关注点分离:Event 解决“实时 + 流式 + 中断恢复”;Msg 解决“持久 + 上下文 + 跨 Agent 通信”。
- 最终一致性保障:只要事件流不丢,就能从任意 checkpoint 重建出完整 Msg(支持弱网、断线重连、审计回放)。
- 生产级必需:尤其是你要做物联网场景(弱网、需要人机介入、实时仪表盘),这套机制比单纯的流式 token 输出强太多。
实践建议:
- 后端/Agent 内部:优先操作 Msg,做上下文管理、记忆、跨 Agent 传递。
- 前端/UI/车机大屏:订阅 Event 流,用 append_event 实时渲染 + 支持断线续传。
- 人机回环场景:善用 RequireUserConfirmEvent 这类事件,实现“敏感操作先问人”。
- 调试/审计:直接回放 Event 日志,就能完整复现 Msg 的构建过程。
👍 1🚀 1