02 追踪

工作坊资料在公开的 langfuse/langfuse-workshop 仓库中维护。使用该仓库获取可运行的应用、检查点分支和本地设置。

查看此 Markdown 文件

学习者指南：02 追踪

讲师笔记

• 按三个可见层讲授进度：OpenAI 生成、一个代理根，然后是工具观测。
• 保持代码更改小而局部。要点是展示 Langfuse 包装现有应用边界，而不是强制进行架构重写。
• 用户/会话传播部分是实时可选的，但后续检查点包含它，所以后续章节具有可用的属性。

演示节奏

1. 添加 LangfuseSpanProcessor 和 observeOpenAI，运行一次，显示单独的生成追踪。
2. 用 observe(...) 包装 runSupportConversationInner，再次运行，显示嵌套生成。
3. 包装两个本地工具帮助程序，再次运行，显示完整树。

注意事项

• 第 2 步后，dad-it-support-chat-turn 周围偶尔会有一个空白父容器。刷新一次，然后才能将其视为代码错误；如果它每次都出现，请检查是否在课程中的单个 observe(...) 之外意外有额外的追踪包装。
• 学习者在单独的工厂中包装 OpenAI 客户端。工作坊有意将包装保持内联。
• 学习者将第 3 步块粘贴在现有 executeTool 之上而不是替换它。服务器以 Multiple exports with the same name "executeTool" 退出；剩余的副本进一步 tools.ts。
• index.ts 中缺少关闭刷新；没有它追踪可能晚到。