用途:通过 Langfuse 公共 API 进行 LLM 可观测性与追踪,包括写入追踪数据、查询 trace、管理提示词、附加评估分数和读取每日指标。
主要能力:批量写入 trace、span、generation、event 和 score;按 userId、name、sessionId、tags 及时间范围分页查询 trace;获取单个 trace 详情;创建数值或分类评分;列出会话;列出与获取提示词模板;读取每日聚合指标(token、延迟、成本、trace 数)。
使用方式:需设置 LANGFUSE_PUBLIC_KEY 与 LANGFUSE_SECRET_KEY,采用 HTTP Basic Auth,公钥为用户名、密钥为密码,curl 使用 -u "$LANGFUSE_PUBLIC_KEY:$LANGFUSE_SECRET_KEY"。默认 EU Cloud 为 https://cloud.langfuse.com,US Cloud 为 https://us.cloud.langfuse.com,自托管使用自身 base URL。写入统一用 POST /api/public/ingestion,单批上限 5 MB 或 1000 事件;trace id 需自行预生成 UUID;时间戳须为带时区偏移的 ISO 8601;score 的 source 可设 API、HUMAN 或 EVAL。
限制:资料未提供收费、价格、平台支持范围及具体效果数据;请求失败时可运行 zero doctor check-connector --env-name LANGFUSE_PUBLIC_KEY 或 zero doctor check-connector --url https://cloud.langfuse.com/api/public/traces --method GET 排查。