Langfuse 是一个开源的大语言模型应用工程平台,帮助开发者记录模型调用、排查异常、管理提示词并评估输出质量。做聊天助手、知识库问答或智能体的团队,可以用它查看应用运行过程,协作改进效果。它支持云端托管和自行部署;按官方定位,它是开发平台,并非装入助手后直接调用的单个技能包。
适配哪些工具
官方提供 Python 和 JavaScript、TypeScript SDK,也提供公共 API。已列出的集成包括 OpenAI SDK、LangChain、LlamaIndex、Haystack、LiteLLM、Vercel AI SDK 和 Mastra,各集成支持的语言与接入方式有所不同。
官方还列出 Dify、Flowise、Langflow、OpenWebUI、Ollama、DSPy 和 Promptfoo 等生态工具。所给材料没有展开 DeepSeek 的接入方法,因此不能据此补写其专用配置。
安装步骤
使用托管版可从 Langfuse Cloud 注册进入。自行部署时,官方本地流程是获取 Langfuse 仓库,进入项目目录,再通过 Docker Compose 启动服务。材料没有完整列出环境准备、密钥设置及初始化过程,部署前需查阅对应文档。
官方也提供单台虚拟机部署、Kubernetes Helm 部署,以及三家云平台的 Terraform 模板,并将 Kubernetes 列为推荐的生产部署方式。具体版本和硬件要求未核实。
使用示例
已有 LangChain 应用可通过传入回调处理器接入追踪;使用 SDK 则可手动埋点。接入后,可以查看模型调用、检索、嵌入和智能体动作等记录,结合用户会话排查问题。
发现某次输出不理想时,可以从追踪记录跳转到 Playground,调整提示词和模型配置再测试。团队还可集中管理提示词版本,建立测试数据集,并使用模型评分、代码评估、人工标注或用户反馈检查结果。
注意事项
官方材料标有 MIT 许可证徽章,但完整许可证条款及适用范围未核实。云端提供免费额度且注册无需信用卡,具体额度、付费价格及性能数据未核实。
自托管需注意日志占用磁盘。默认配置继承 Docker 的日志设置,应配置日志轮转或保留策略。修改守护进程日志默认值后,需要重启 Docker 并重建容器,保留数据卷且安排服务中断;仅重启容器不足以生效。
同类 Skill
现有站内相关文章没有直接同类。Claude Code 技能 last30days 的主题是近期提示词调研,可作为相邻阅读;Langfuse 侧重应用追踪、评估和提示词管理,二者不能直接替代。
