追踪

使用 Langfuse 进行可观测性和追踪。

---

致谢

本文档由我们的社区贡献者 jannikmaierhoefer 贡献。👏

RAGFlow 内置了 Langfuse 集成，因此您可以近乎实时地检查和调试 RAG 管道的每个检索和生成步骤。

Langfuse 将追踪、跨度和提示负载存储在专门构建的可观测性后端中，并提供过滤和可视化功能。

注意

• RAGFlow ≥ 0.20.5（包含 Langfuse 连接器） • 具有_项目公钥_和_密钥_的 Langfuse 工作空间（云或自托管）

---

1. 收集您的 Langfuse 凭据

1. 登录您的 Langfuse 仪表板。
2. 打开设置 ▸ 项目，创建新项目或选择现有项目。
3. 复制公钥和密钥。
4. 记录 Langfuse 主机（例如 https://cloud.langfuse.com）。如果您自托管，请使用您自己安装的基础 URL。

密钥是_项目范围的_：一对密钥足以让所有环境写入同一项目。

---

2. 将密钥添加到 RAGFlow

RAGFlow 按_租户_存储凭据。您可以通过 Web UI 或 HTTP API 配置它们。

1. 登录 RAGFlow 并点击右上角的头像。
2. 选择API ▸ 滚动到底部 ▸ Langfuse 配置。
3. 填写您的 Langfuse 主机、公钥和密钥。
4. 点击保存。

保存后，RAGFlow 开始自动发出追踪——无需更改代码。

---

3. 运行管道并查看追踪

1. 在 RAGFlow 中执行任何聊天或检索管道（例如快速开始演示）。
2. 打开您的 Langfuse 项目 ▸ 追踪。
3. 按名称 ~ ragflow-* 过滤（RAGFlow 为每个追踪添加 ragflow- 前缀）。

对于每个用户请求，您将看到：

• 表示整体请求的追踪 • 检索、排名和生成步骤的跨度 • 完整的提示、检索文档和LLM 响应作为元数据

(Langfuse 中的示例追踪)

注意

使用 Langfuse 的差异视图来比较提示版本或深入分析长时间运行的检索以识别瓶颈。