@ravan08/pi-langfuse
为Pi智能体集成Langfuse可观测性，实现追踪、评分与记忆观察。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@ravan08/pi-langfuse。 它的用途是：为Pi智能体集成Langfuse可观测性，实现追踪、评分与记忆观察。 完整的 Skill 内容见：https://321skill.com/skills/ravan08-pi-langfuse/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我分析一下最近智能体处理用户查询的响应时间和准确率。”，它会通过集成的Langfuse扩展，自动拉取并汇总指定时间段的追踪数据，向你展示平均耗时、各步骤分布以及你预先设置的质量评分趋势图。
介绍
该Skill为Pi智能体开发平台提供了与Langfuse集成的可观测性扩展。它主要解决了开发者在构建和调试AI智能体时，难以追踪其内部执行流程、评估输出质量以及分析其决策依据的问题。通过此扩展，Pi智能体的每次调用、工具使用和内部步骤都可以被自动记录为Langfuse中的追踪轨迹，并支持添加自定义评分和可选的记忆观察功能。
使用方式非常简单。开发者只需在Pi智能体项目中安装此npm包，并进行简单的配置，即可将Langfuse的追踪能力注入到智能体的运行过程中。配置完成后，智能体在运行时会自动向指定的Langfuse项目发送追踪数据，开发者便可在Langfuse的仪表板中实时查看详细的执行链路、耗时、输入输出以及自定义的评估分数。
这个Skill非常适合正在使用Pi平台开发复杂AI应用（如自动化客服、代码生成、数据分析助手）的开发者或团队。特别是那些需要深入理解智能体行为、优化提示词、调试错误或需要对AI输出进行质量监控和评估的场景。
在使用建议上，建议在开发测试和生产环境都启用此扩展，以便全面收集数据。需要注意的是，由于会发送数据到外部服务，请确保网络连通性，并妥善管理Langfuse的API密钥等敏感信息，避免泄露。对于高频调用场景，需留意Langfuse的用量限制和可能产生的成本。
核心特点
这是首个专为Pi智能体平台深度定制的Langfuse集成方案，原生支持将Pi智能体的内部执行步骤（如工具调用、LLM请求）自动映射为结构化的Langfuse追踪，并提供了可选的“记忆”上下文观察功能，而同类通用集成往往需要大量手动埋点。
注意事项
不适合仅需简单对话、无需深入分析和监控的轻量级AI应用场景。
常见问题
如何查看Pi智能体的运行追踪？
安装配置后，所有追踪会自动发送到你的Langfuse项目仪表板，登录即可查看。
这个扩展会影响Pi智能体的运行速度吗？
会有轻微的网络延迟，因为需发送数据到Langfuse服务器，但通常不影响核心功能。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/ravan08-pi-langfuse/raw/index.md 读取 @ravan08/pi-langfuse 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/ravan08-pi-langfuse/raw/index.md（查看排版版本）