跳到主要内容

跟踪

使用Langfuse实现可观测性和跟踪。

特别鸣谢

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

RAGFlow 内置了与 Langfuse 的集成，这样您可以在近乎实时的情况下检查和调试您的 RAG 管道中的每个检索和生成步骤。

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

注意

• RAGFlow ≥ 0.20.3（包含 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 在 Langfuse 中的示例跟踪

一旦保存，RAGFlow 将自动开始生成跟踪 — 无需修改代码。

3. 运行管道并查看跟踪​

  1. 在 RAGFlow 中执行任意聊天或检索管道（例如快速入门演示）。
  2. 打开您的 Langfuse 项目 ▸ 跟踪。
  3. 使用名称过滤器查找 ragflow-*（RAGFlow 将每个跟踪前缀为 ragflow-）。

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

• 表示整个请求的 跟踪 • 检索、排名和生成步骤的 跨度 • 完整的提示、检索到的文档以及大模型响应作为元数据

RAGFlow 在 Langfuse 中的示例跟踪

（Langfuse 中的示例跟踪)

注意

使用 Langfuse 的差异视图来比较提示版本或深入调查长时间运行的检索以确定瓶颈。