SuperAPI AI 工具集

langfuse-data-handling

数据与分析

查看项目

更新于 10-15 23:27

技能介绍

用途:管理 Langfuse 数据生命周期,覆盖数据导出、保留策略、合规请求与匿名化。

主要能力:通过 @langfuse/client 的 LangfuseClient 调用 traces.list、observations.list、scores.list、traces.delete 等接口,分页导出 trace 与 score 到 JSON 文件;按时间范围导出并可选包含 observations;配置保留策略(自托管通过环境变量 LANGFUSE_RETENTION_DAYS,云端通过程序化清理旧数据);处理 GDPR 访问请求(导出某 userId 的全部数据)与删除请求(按 userId 删除 trace);对 userId、sessionId 做 SHA-256 哈希并遮蔽 input/output 以匿名化分析数据。

使用方式:先安装 @langfuse/client 并配置具备相应权限的 Langfuse API 密钥,明确合规要求(GDPR、SOC2、HIPAA)。导出时按 fromTimestamp/toTimestamp 分页拉取,每页 100 条,页间加 200ms 延迟以遵守速率限制;保留策略可写成 cron 任务定期执行;删除请求需使用 trace 中确切的 userId,并等待异步传播后再复查确认。

适用场景:trace/score 数据导出、保留期清理、数据主体访问与删除请求、面向分析的匿名化导出、审计记录维护。

限制与注意:资料未提供具体价格、平台支持范围或性能指标;删除为异步处理,不会立即生效;导出数据量大时可能超时,需缩小日期范围或分页;userId 格式不一致会导致查不到数据;输出报告不得包含原始 prompt、output 或 API 密钥。