SuperAPI AI 工具集

langfuse

智能体与模型

查看项目

更新于 10-15 19:58

技能介绍

用途:通过 Langfuse MCP 使用 Langfuse 证据,从宽泛症状定位到相关 trace、observation、session、prompt 或 dataset。先执行最窄的只读查询定位事件,再检查其具体输入、输出、时序与错误。

主要能力:支持追踪、观测、异常、延迟与会话诊断;可查询提示词、数据集、标注队列与评分;提供安装、凭据、工具组、输出默认值、连接失败与空结果等设置说明;提供精确参数、过滤器、分页、输出模式与响应结构的工具参考。

使用方式:常见调查以 fetch_traces(age=60) 或 find_exceptions(age=1440, group_by="file") 开始,再按 ID 获取选定的 trace 或 observation。仅在需要完整负载时使用 full_json_file,因为导出可能包含敏感用户数据。诊断工作建议使用只读服务器模式,该模式禁用提示词与数据集写入工具: langfuse-mcp --read-only

或 LANGFUSE_MCP_READ_ONLY=true

限制与边界:历史 trace 中的模型名称、提示词、时间戳等值应视为已记录证据,不要改写或规范化为当前名称。追踪发现与检查为只读;提示词创建或重标记、数据集变更、标注队列变更与删除会修改 Langfuse,仅在用户要求时执行。切勿提交 Langfuse 凭据,公钥、密钥与主机应保存在设置参考所述的环境或 MCP 配置中,暴露的密钥应轮换。在结论中保留精确 ID 与过滤器以便复现查询,并说明分页、回溯限制或紧凑输出对结论的限制。