@braintrust/pi-extension
为Pi AI自动追踪会话与调用到Braintrust平台
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@braintrust/pi-extension。 它的用途是：为Pi AI自动追踪会话与调用到Braintrust平台 完整的 Skill 内容见：https://321skill.com/skills/braintrust-pi-extension/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我集成Braintrust到我的Pi助手项目里，监控所有用户对话。”，它会引导你安装此扩展并配置环境变量。集成后，每次用户与助手对话的完整流程、LLM的响应和工具调用都会被自动记录到Braintrust，方便你后续查看会话详情和进行效果对比。
介绍
这个Skill是一个专为Pi AI设计的Braintrust扩展。它解决了开发者在构建和调试基于Pi的AI应用时，难以全面、自动地追踪和评估AI会话、交互轮次、LLM调用及工具执行过程的问题。通过简单的集成，该扩展能自动将Pi应用运行中的所有关键事件和性能数据发送到Braintrust平台，帮助用户实现端到端的可观测性。
使用方式非常便捷。开发者只需通过npm安装此扩展包，并在其Pi应用中完成初始化配置，后续所有的会话、用户与AI的对话轮次、底层大语言模型的调用细节以及工具（如函数调用）的执行情况，都会被自动捕获并记录到指定的Braintrust项目中。用户无需手动插桩，即可在Braintrust的界面上查看详细的数据、进行对比实验和性能分析。
它非常适合正在使用Pi框架开发AI应用（如聊天机器人、智能助手）的工程师、研究员或产品团队。特别是那些关注AI应用质量、希望系统化评估不同提示词或模型版本效果、并需要可追溯的实验记录来进行迭代优化的团队。
使用建议方面，建议在项目开发早期就集成此扩展，以便积累完整的调试和评估数据。需要注意的是，确保Braintrust的API密钥等配置信息已正确设置，并且了解数据上传可能产生的网络开销。对于追求极致轻量级或无外部依赖的项目，需权衡引入此监控组件的必要性。
核心特点
与通用的日志记录或手动埋点方案相比，它深度集成Pi框架，能自动、结构化地捕获Pi会话特有的完整交互链路（如turns），并直接对接Braintrust这一专业的AI评估与实验平台，实现了开箱即用的生产级观测能力。
注意事项
仅适用于基于Pi框架开发的应用，不适用于其他AI框架或需要完全离线、私有化部署监控的场景。
常见问题
这个扩展会影响Pi应用的性能吗？
影响极小，它采用异步方式发送追踪数据，不会阻塞主线程。
数据会被发送到哪里？安全吗？
数据发送到您自己配置的Braintrust项目，通信经过加密，您拥有数据的完全控制权。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/braintrust-pi-extension/raw/index.md 读取 @braintrust/pi-extension 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/braintrust-pi-extension/raw/index.md（查看排版版本）