Langfuse

Langfuse 是一个开源的 LLM 可观测平台，提供追踪与监控能力，帮助开发者调试、分析和优化 AI 系统。Langfuse 可与多种工具和框架集成，其中也包括 SkillFlaw 这样的工作流构建器与运行时。

本指南说明如何将 SkillFlaw 配置为采集流程执行的 tracing 数据，并自动发送给 Langfuse。

前置条件

• 一个 Langfuse Cloud 或 Langfuse 自托管实例 账户
• 一个正在运行的 SkillFlaw 服务，以及你想追踪的一个 流程

提示

如果你需要一个流程来测试 Langfuse 集成，可参考 SkillFlaw 快速开始。

将 Langfuse 凭据设置为环境变量

1. 创建一组 Langfuse API Keys。

2. 复制以下 API Key 信息：

   • Secret Key
   • Public Key
   • Host URL

3. 在运行 SkillFlaw 的同一环境中，把 Langfuse 项目凭据设置为环境变量。

   在下面示例中，请将 SECRET_KEY、PUBLIC_KEY 与 HOST_URL 替换为你的实际值。

   Linux or macOS

   在 Linux 或 macOS 终端中，可以这样设置：

   
   

   _10

   export LANGFUSE_SECRET_KEY=SECRET_KEY

   _10

   export LANGFUSE_PUBLIC_KEY=PUBLIC_KEY

   _10

   export LANGFUSE_HOST=HOST_URL

   
   

   Windows

   在 Windows 命令行中，可以这样设置：

   
   

   _10

   set LANGFUSE_SECRET_KEY=SECRET_KEY

   _10

   set LANGFUSE_PUBLIC_KEY=PUBLIC_KEY

   _10

   set LANGFUSE_HOST=HOST_URL

   
   

启动 SkillFlaw 并在 Langfuse 中查看追踪

1. 在刚才设置好 Langfuse 环境变量的同一环境中启动 SkillFlaw：

   
   

   _10

   uv run skillflaw run

   
   

2. 运行一个流程。

   SkillFlaw 会自动采集流程执行的 tracing 数据并发送到 Langfuse。

3. 在 Langfuse 控制台 中查看收集到的数据。

   Langfuse 还提供了一个 公开 live trace 示例面板。

禁用 Langfuse tracing

如果要关闭 Langfuse 集成，请移除 Langfuse 环境变量，然后重启 SkillFlaw。

另请参阅

• Langfuse GitHub 仓库