@lifanh/pi-langfuse-extension
为Pi Coding Agent添加Langfuse可观测性
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@lifanh/pi-langfuse-extension。 它的用途是：为Pi Coding Agent添加Langfuse可观测性 完整的 Skill 内容见：https://321skill.com/skills/lifanh-pi-langfuse-extension/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'安装pi-langfuse-extension并配置Langfuse密钥，然后运行一个Pi agent任务，之后在Langfuse中查看追踪详情。'它会自动将每次agent运行的结构化数据发送到Langfuse，你可以在UI中查看每个generation的token消耗、成本、工具调用和错误信息。
介绍
这个Skill解决了Pi Coding Agent运行过程不可见的问题。在实际开发中，开发者经常需要了解AI代理使用了哪个模型、消耗了多少token、花费了多少钱、调用了哪些工具、是否有错误发生，但默认情况下这些信息难以获取。
使用方式很简单，你只需要在Pi中安装该扩展并配置Langfuse的API密钥。之后每次运行Pi agent，扩展会自动将运行轨迹作为结构化trace发送到Langfuse，你可以在Langfuse UI中查看嵌套的agent、generation、tool观察。
它非常适合需要监控AI代理运行成本、调试代理行为、优化token消耗的团队或个人。尤其是那些已经使用Langfuse进行可观测性管理的开发者。
建议在开发和生产环境中统一使用此工具来追踪所有Pi agent运行。需要注意的是，它默认只发送元数据，内容捕获需要手动开启，且目前处于pre-1.0阶段，接口可能变化。
常见问题
如何安装这个扩展？
在Pi终端中运行 pi install npm:@lifanh/pi-langfuse-extension 即可安装。
如何配置Langfuse密钥？
安装后在Pi中执行 /langfuse-configure publicKey=... secretKey=... 命令，然后运行 /langfuse-test 验证连接。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/lifanh-pi-langfuse-extension/raw/index.md 读取 @lifanh/pi-langfuse-extension 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/lifanh-pi-langfuse-extension/raw/index.md（查看排版版本）