【rpi 更新0.2.8】RPI 增加Langfuse Package扩展 — 让 Agent 运行透明可见
内容提要
rpi-langfuse 安装后零配置自动追踪 Agent 生命周期，通过 12 个事件处理器将 Session、Agent、Provider、Tool、Turn 等事件映射到 Langfuse 的 trace、generation、span，记录模型调用、Token 消耗、工具执行、延迟等数据，并在 Dashboard 展示追踪概览、成本分析与延迟监控。
延伸解读
零配置追踪如何实现
rpi-langfuse 安装后无需额外配置即可自动生效，这得益于其内置的 12 个事件处理器。这些处理器监听 Agent 生命周期中的关键事件，如 SessionStart、BeforeProviderRequest、ToolCall 等，并将它们映射到 Langfuse 的 trace、generation 和 span。这种设计降低了接入门槛，让开发者能快速获得可观测性，而不必手动埋点或编写集成代码。
追踪数据覆盖哪些维度
通过事件处理器，rpi-langfuse 记录了模型调用、Token 消耗、工具执行和延迟等数据。例如，BeforeProviderRequest 和 AfterProviderResponse 捕获模型输入输出及 Token 使用量，ToolCall 和 ToolResult 记录工具名称、参数、结果和耗时。这些数据在 Langfuse Dashboard 中展示为追踪概览、成本分析和延迟监控，帮助定位性能瓶颈与成本异常。
上下文压缩事件的意义
文章特别提到 SessionBeforeCompact 和 SessionCompact 事件，分别映射为 span-create 和 span-update，记录上下文压缩的开始与统计信息。对于长对话或复杂 Agent 任务，上下文压缩可能影响模型表现与成本。追踪这些事件有助于理解压缩发生的时机和效果，从而优化会话管理策略，避免因压缩导致的信息丢失或性能下降。
Q&A
rpi-langfuse 是什么？它有什么作用？
rpi-langfuse 是 rpi 0.2.8 版本新增的 Langfuse Package 扩展，安装后零配置自动追踪 Agent 生命周期，通过 12 个事件处理器将 Session、Agent、Provider、Tool、Turn 等事件映射到 Langfuse 的 trace、generation、span，记录模型调用、Token 消耗、工具执行、延迟等数据，并在 Dashboard 展示追踪概览、成本分析与延迟监控。
rpi-langfuse 安装后需要配置吗？
不需要，安装后零配置生效，rpi-langfuse 会自动监听 Agent 生命周期事件。
rpi-langfuse 如何将 Agent 事件映射到 Langfuse？
rpi-langfuse 通过 12 个事件处理器进行映射：SessionStart 映射为 trace-create，BeforeProviderRequest 映射为 generation-create，ToolCall 映射为 span-create 等，从而将 Session、Agent、Provider、Tool、Turn 等事件对应到 Langfuse 的 trace、generation、span。
rpi-langfuse 会记录哪些具体数据？
rpi-langfuse 记录的数据包括：traceId、userId、sessionId、metadata、prompt 文本、图片数量、model、input messages、modelParameters、output、usage（input/output tokens）、TTFT、tool name、arguments、result、duration 等。
安装 rpi-langfuse 后 Langfuse Dashboard 会展示什么？
Langfuse Dashboard 会自动收到完整的追踪数据，展示追踪概览、成本分析与延迟监控。
rpi-langfuse 的源码仓库在哪里？
源码仓库位于 pi-rust/rpi-package/packages/rpi-langfuse。
