跳到主内容

dsh-plugin-langfuse 使用指南

将 agent 会话导出为 OpenTelemetry 追踪到 Langfuse，用于可观测性和调试。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

将 agent 会话导出为 OpenTelemetry 追踪到 Langfuse，用于可观测性和调试。

— 源: plugins.ai_summary

安装与验证

dsh plugin --profile web add dsh-plugin-langfuse

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • id: session-telemetry-langfuse
  • sessionId 默认取 dsh session id；原始 dsh session id 始终以 dsh.session.id 留在每个逻辑根上——这是回查 $DSH_HOME/sessions 本地日志的指针。
  • 动态映射必须可从 dsh session id 确定性重建，且至少存活到该会话不再可能触发 FEEDBACK_ONLY 重放为止——否则重放出的树会带上与实时捕获不同的身份。
  • 静态 correlation 值不经过脱敏 waterfall：waterfall 只变换 record，而这些值从不途经 record。
  • 投递语义不变：correlation 是身份而非去重——重复仍然可能（见决策 5）。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则

dsh-plugin-langfuse 使用指南