mcpField
L
langfuse-api

langfuse-api

github.com/langfuseAgent 工作流31955 次安装1 天前更新
代码仓库

关于 langfuse-api

langfuse-api 是通过 Langfuse REST API 执行操作的技能，涵盖追踪、提示词、数据集、评分、项目和 API 密钥。它要求在发起请求前查阅当前 API 文档。

主要功能

  1. 01查询和导出追踪
  2. 02以编程方式管理提示词
  3. 03创建数据集及其条目
  4. 04获取和创建评分
  5. 05管理项目与 API 密钥
  6. 06查阅当前 API 文档并处理分页

适用场景

  1. 01导出指定时间段的追踪
  2. 02创建数据集并添加条目
  3. 03获取与追踪关联的评分
  4. 04列出或获取 Langfuse 提示词

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/langfuse/skills --skill langfuse-api

安装后在 Claude Code 中输入/langfuse-api确认已加载。

详细介绍

Langfuse API

通过 REST API 帮助用户与 Langfuse 交互。

使用场景

  • 用户想要查询或导出追踪记录
  • 用户想要以编程方式管理提示词
  • 用户想要创建或更新数据集或数据集条目
  • 用户想要获取或创建评分
  • 用户想要管理项目或 API 密钥
  • 其他任何 Langfuse API 交互

工作流

1. 检查凭据

进行任何 API 调用之前，请确认凭据可用：

echo $LANGFUSE_PUBLIC_KEY   # pk-...
echo $LANGFUSE_SECRET_KEY   # sk-...
echo $LANGFUSE_HOST         # https://cloud.langfuse.com (or self-hosted/EU/US URL)

如果未设置，请询问用户：

  • “我需要你的 Langfuse API 凭据。你可以在 Langfuse 界面的 Settings → API Keys 中找到。”
  • “你使用的是哪个 Langfuse 主机？（cloud.langfuse.com、us.cloud.langfuse.com、eu.cloud.langfuse.com，或自托管 URL）”
2. 获取最新 API 参考文档

调用 API 之前，务必获取当前的 API 参考文档。 API 可能新增了端点或更改了参数。

获取：https://api.reference.langfuse.com

查找用户请求所需的具体端点。参考文档包含：

  • 所有可用端点
  • 必需和可选参数
  • 请求和响应架构
  • 身份验证详情
3. 发起 API 调用

身份验证： 使用 LANGFUSE_PUBLIC_KEY 作为用户名、LANGFUSE_SECRET_KEY 作为密码进行 Basic Auth 身份验证。

基础 URL： {LANGFUSE_HOST}/api/public

示例：

curl -X GET "${LANGFUSE_HOST}/api/public/traces" \
  -u "${LANGFUSE_PUBLIC_KEY}:${LANGFUSE_SECRET_KEY}" \
  -H "Content-Type: application/json"
4. 处理分页

许多端点会返回分页结果。请检查：

  • page 和 limit 参数
  • 响应中的 meta.totalItems 和 meta.totalPages
  • 如果用户需要全部结果，则进行迭代

常见使用场景

用户请求要查找的端点
“获取我最近的追踪记录”GET /traces
“导出上周的追踪记录”GET /traces with date filters
“获取特定提示词”GET /prompts/{name}
“创建数据集”POST /datasets
“向数据集添加条目”POST /dataset-items
“获取某条追踪记录的评分”GET /scores with traceId filter
“列出所有提示词”GET /prompts

重要说明

  • 务必获取最新文档——不要依赖缓存的 API 知识
  • 检查速率限制——API 有速率限制；请处理 429 响应
  • 验证响应——处理数据之前，请检查是否存在错误
  • 大型导出——对于批量数据，请使用分页，并考虑流式写入文件

OpenAPI 规范

用于编程访问或生成类型：

https://cloud.langfuse.com/generated/api/openapi.yml

评论

支持 Markdown