@hdkiller/pi-langfuse
为Pi提供生产级Langfuse可观测性
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@hdkiller/pi-langfuse。 它的用途是：为Pi提供生产级Langfuse可观测性 完整的 Skill 内容见：https://321skill.com/skills/hdkiller-pi-langfuse/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我分析上个月所有与客服对话Pi的交互，找出令牌消耗最高的十个对话。’ 它会通过Langfuse后台，自动拉取并可视化相关追踪数据，展示详细的成本分布和对话内容。开发者可以据此优化提示词或调整模型调用策略。
介绍
该Skill旨在解决开发者在构建基于Pi（AI助手）的应用时，难以追踪和分析AI交互过程、成本及性能的问题。它通过集成Langfuse，自动记录每一次与Pi的交互，包括用户提示、助手回复、工具调用以及流式响应，形成完整的可观测链路。
使用时，开发者只需在Pi项目中安装并配置此Skill，它便会自动捕获所有与AI模型的交互数据，并将其发送到Langfuse平台。在Langfuse的仪表盘中，开发者可以清晰地查看请求的层级关系、令牌消耗、延迟以及成本估算，无需手动埋点。
它非常适合正在使用Pi进行应用开发，并希望将AI交互过程透明化、可度量化的开发者和团队。无论是进行调试、优化提示词、控制成本，还是进行生产环境的监控，这个Skill都能提供关键的数据支持。
建议在生产环境或需要进行严格成本与性能监控的项目中使用。请注意，使用前需要拥有Langfuse的账户和项目配置，以确保数据能够正确上报。对于仅进行原型验证或对成本不敏感的个人玩具项目，其必要性可能不高。
核心特点
专为Pi框架深度集成，能原生捕获其内部的对话轮次、工具调用和流式响应，并自动构建符合Pi交互逻辑的追踪层级，而不仅仅是简单的API调用日志。
注意事项
不适合没有Langfuse账户或仅需简单日志记录、无需深度可观测性的轻量级或一次性项目。
常见问题
这个Skill和直接调用Langfuse SDK有什么区别？
它封装了Pi框架的特定上下文和生命周期，能自动捕获Pi特有的结构（如对话轮次、工具流），减少手动集成代码。
使用它会增加多少延迟？
数据上报是异步进行的，对主请求链路的延迟影响极小。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/hdkiller-pi-langfuse/raw/index.md 读取 @hdkiller/pi-langfuse 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/hdkiller-pi-langfuse/raw/index.md（查看排版版本）