@traceroot-ai/pi-extension
为Pi框架自动注入OpenTelemetry追踪
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@traceroot-ai/pi-extension。 它的用途是：为Pi框架自动注入OpenTelemetry追踪 完整的 Skill 内容见：https://321skill.com/skills/traceroot-ai-pi-extension/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'为我的Pi应用添加OpenTelemetry追踪，使用@traceroot-ai/pi-extension'，它会自动执行npm install并初始化配置，之后所有Pi会话、LLM调用和工具执行的耗时、Token消耗、调用链都会实时上报到Traceroot，方便你定位性能瓶颈或排查异常。
介绍
Pi框架开发者在构建AI应用时，往往难以追踪会话、回合、LLM调用和工具执行的完整链路，导致调试和性能分析困难。该扩展通过自动集成OpenTelemetry，将Pi运行时的所有关键事件（session、turn、LLM请求、工具调用）实时上报至Traceroot，无需手动埋点，即可获得分布式追踪能力。
使用方式极其简单：在Pi项目中执行npm install @traceroot-ai/pi-extension，然后按照文档配置Traceroot端点即可。扩展会自动拦截Pi内部事件并生成Span，开箱即用，不侵入业务代码。
适合使用Pi框架构建AI Agent、智能客服、自动化工作流等应用的开发者，尤其是需要端到端可观测性来排查问题、优化Token消耗或监控服务健康的后端工程师、智能体开发者和运维工程师。
注意：本扩展仅兼容Pi框架，且需要运行Traceroot服务端接收追踪数据。如果使用其他AI框架（如LangChain、AutoGen）或自建追踪系统，请选择对应的集成方案。
核心特点
专为Pi框架深度定制，自动追踪Pi特有的会话（session）和回合（turn）生命周期，而非仅通用LLM调用，能完整还原多轮对话与工具调用链条。
注意事项
仅适用于基于Pi框架的AI应用，无法直接用于其他框架或纯LLM调用场景。
常见问题
安装后需要额外配置OpenTelemetry Collector吗？
不需要，扩展会自动创建并管理OpenTelemetry SDK，只需配置Traceroot的接收地址即可。
是否支持自定义span属性？
支持，可通过Pi扩展的API在回调中注入自定义属性，详情见文档。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/traceroot-ai-pi-extension/raw/index.md 读取 @traceroot-ai/pi-extension 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/traceroot-ai-pi-extension/raw/index.md（查看排版版本）