可观测：事件 → Span 树 → 导出器扇出

可观测：事件 → Span 树 → 导出器扇出 由 Archify 生成的架构图。 AgentRuntime · 事件源 · 架构组件 AgentRuntime 事件源 AgentEventPublisher · 广播 · 监听者异常自吞 · 架构组件 AgentEventPublisher 广播 · 监听者异常自吞 AgentTraceListener · onEvent → span 生命周期 · 追踪管线（trace 包） · trace AgentTraceListener onEvent → span 生命周期 trace AgentFlowTraceBridge · 事件 → FlowGram 任务 · 架构组件 AgentFlowTraceBridge 事件 → FlowGram 任务 TraceSpan 树 · RUN>STEP>MODEL/TOOL/… · 追踪管线（trace 包） · trace TraceSpan 树 RUN>STEP>MODEL/TOOL/… trace TraceExporter · SPI · span 结束即导出 · 追踪管线（trace 包） · trace TraceExporter SPI · span 结束即导出 trace 导出实现 · Console/Jsonl/Langfuse/OTel · 追踪管线（trace 包） · trace 导出实现 Console/Jsonl/Langfuse/OTel trace TraceConfig · Masker·Pricing·Metrics · 追踪管线（trace 包） · trace TraceConfig Masker·Pricing·Metrics trace ① publish(event) ② onEvent ③ onEvent ④ 事件→span ⑤ end→export ⑥ 五实现+Composite ⑦ 配置 追踪管线（trace 包） 图例 后端 数据库 云服务 消息总线

事件到 Span 的映射

  • • RUN 根 span：一次 run；STEP：一轮循环步；MODEL：一次模型请求/响应；TOOL：一次工具执行（含 CodeAct 代码执行）
  • • HANDOFF/TEAM_TASK/MEMORY/SANDBOX/AGENT_FLOW/FLOWGRAM_* 覆盖委派、团队任务、压缩、沙箱与 FlowGram 集成

扇出与隔离

  • • Publisher.publish 同步广播所有 AgentListener——单个 listener 抛异常被吞掉，不影响 Agent 执行
  • • 同一条事件总线还挂着：SessionEventLog/HashChainedEventLog（审计）、IoCapture（回放录制）、CLI/TUI 渲染

配置与成本

  • • TraceConfig 默认记录完整模型 IO 与工具参数/输出；TraceMasker 脱敏、TracePricing(+Resolver) 按价表折算成本、TraceMetrics 聚合指标
  • • CompositeTraceExporter 多路扇出；JsonlTraceExporter 落行式 JSON 便于离线分析