追踪

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

---

致谢

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

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

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

注意

• RAGFlow ≥ 0.20.0（包含 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 的差异视图来比较提示版本，或深入研究长时间运行的检索以识别瓶颈。