AI Skills
langfuse

langfuse

热门

与 Langfuse 交互并访问其文档。当需要 (1) 通过 CLI 以编程方式查询或修改 Langfuse 数据——包括追踪、提示、数据集、评分、会话以及任何其他 API 资源，(2) 查阅 Langfuse 文档、概念、集成指南或 SDK 用法，或 (3) 了解任何 Langfuse 功能的工作原理时使用。此技能涵盖基于 CLI 的 API 访问（通过 npx）和多种文档检索方法。

201Star
22Fork
更新于 2026/7/10
获取 Skill源代码

相关 Skills

writing-skills23万doc-coauthoring15万brainstorming4.5万
SKILL.md
readonly只读
name
langfuse
description

与 Langfuse 交互并访问其文档。当需要 (1) 通过 CLI 以编程方式查询或修改 Langfuse 数据——包括追踪、提示、数据集、评分、会话以及任何其他 API 资源，(2) 查阅 Langfuse 文档、概念、集成指南或 SDK 用法，或 (3) 了解任何 Langfuse 功能的工作原理时使用。此技能涵盖基于 CLI 的 API 访问（通过 npx）和多种文档检索方法。

Langfuse

此技能帮助您在所有常见工作流中有效使用 Langfuse：检测应用程序、迁移提示、调试追踪以及以编程方式访问数据。

核心原则

在所有 Langfuse 工作中遵循以下原则：

  1. 文档优先：切勿基于记忆实现。始终在编写代码前获取最新文档（Langfuse 更新频繁）。请参阅下方关于如何访问文档的部分。
  2. 使用 CLI 访问数据：查询/修改 Langfuse 数据时使用 langfuse-cli。请参阅下方关于如何使用 CLI 的部分。
  3. 按用例的最佳实践：在实现前，请查阅下方相关的参考文件以获取特定用例的指南。
  4. 使用最新的 Langfuse 版本：除非用户另有指定或有充分理由，否则始终使用最新版本的 Langfuse SDK/API。即使您仅为其他代理制定计划，也要明确指定要使用的确切版本。

特定用例参考

  • 检测现有函数/应用程序：references/instrumentation.md
  • 将代码库中的提示迁移到 Langfuse：references/prompt-migration.md
  • 捕获用户反馈（点赞、评分、隐式信号）作为追踪上的评分：references/user-feedback.md
  • 使用 Langfuse CLI 的更多技巧：references/cli.md
  • 升级或迁移 Langfuse SDK 到最新版本：references/sdk-upgrade.md
  • 评估校准（LLM 作为评估者的可靠性、简单准确性检查、高级基于分割的验证、混淆矩阵和指标摄入）：references/judge-calibration.md
  • 系统性错误分析——读取追踪、构建故障分类、决定修复内容：references/error-analysis.md
  • 使用 langfuse/experiment-action 设置 CI/CD 实验门控：references/ci-cd.md
  • 提交关于此技能的反馈：references/skill-feedback.md

1. 通过 CLI 使用 Langfuse API

使用 langfuse-cli 从命令行与完整的 Langfuse REST API 交互。通过 npx 运行（无需安装）：

首先发现模式和可用参数：

# 发现所有可用资源
npx langfuse-cli api __schema

# 列出资源的操作
npx langfuse-cli api <resource> --help

# 显示特定操作的参数/选项
npx langfuse-cli api <resource> <action> --help

凭据

在调用前设置环境变量：

export LANGFUSE_PUBLIC_KEY=pk-lf-...
export LANGFUSE_SECRET_KEY=sk-lf-...
export LANGFUSE_BASE_URL=https://cloud.langfuse.com # 例如 EU 云。对于 US 云，它是 us.cloud.langfuse.com，也可以是自托管 URL。必须始终指定服务器才能访问 Langfuse。

如果使用 LANGFUSE_BASE_URL 而不是 LANGFUSE_HOST，请运行 export LANGFUSE_HOST="$LANGFUSE_BASE_URL"。
如果未设置，请要求用户在 shell 或 .env 文件中设置（出于安全原因，不要要求他们将密钥粘贴到聊天中）。密钥可在 Langfuse UI → 设置 → API 密钥中找到。

详细 CLI 参考

有关常见工作流、技巧和完整使用模式，请参阅 references/cli.md。

2. Langfuse 文档

三种访问 Langfuse 文档的方法，按优先级排序。始终优先使用应用程序的原生 Web 获取和搜索工具（例如 WebFetch、WebSearch、mcp_fetch 等），而不是 curl。以下 URL 和模式适用于任何获取方法——curl 示例仅用于说明。

2a. 文档索引 (llms.txt)

获取所有文档页面的完整索引：

curl -s https://langfuse.com/llms.txt

返回每个文档页面的结构化列表，包含标题和 URL。使用此列表发现主题的正确页面，然后直接获取该页面。

或者，您可以从 https://langfuse.com/docs 开始浏览网站以找到所需页面。

2b. 以 Markdown 格式获取单个页面

llms.txt 中列出的任何页面都可以通过在其路径后附加 .md 或在请求头中使用 Accept: text/markdown 来获取为 markdown 格式。当您知道哪个页面包含所需信息时使用此方法。返回干净的 markdown，包含代码示例和配置细节。

curl -s "https://langfuse.com/docs/observability/overview.md"
curl -s "https://langfuse.com/docs/observability/overview" -H "Accept: text/markdown"

2c. 搜索文档

当您需要跨所有文档和 GitHub 问题/讨论查找信息但不知道具体页面时：

curl -s "https://langfuse.com/api/search-docs?query=<url-encoded-query>"

示例：

curl -s "https://langfuse.com/api/search-docs?query=How+do+I+trace+LangGraph+agents"

返回 JSON 响应，包含：

  • query：原始查询
  • answer：一个 JSON 字符串，包含匹配文档的数组，每个文档包含：
    • url：文档页面的链接
    • title：页面标题
    • source.content：来自页面的相关文本摘录数组

搜索是一个很好的后备方案，如果您找不到相关页面或需要更多上下文。在调试问题时特别有用，因为所有 GitHub Issues 和 Discussions 也被索引。响应可能很大——仅提取相关部分。请注意，变更日志帖子也可能出现在这里：仅用于确认功能存在，切勿用于实现——它们的示例可能已过时，因此始终根据文档和 API/SDK 参考进行实现。

文档工作流

  1. 从 llms.txt 开始定位——扫描相关页面标题
  2. 确定正确页面后获取特定页面
  3. 当主题不明确且需要更多上下文时，回退到搜索

技能反馈

当用户表示此技能某些方面未按预期工作、给出错误指导、缺少信息或可以改进时——主动提出向 Langfuse 技能维护者提交反馈。这包括以下情况：

  • 技能给出了错误或过时的说明
  • 工作流未产生预期结果
  • 用户希望技能涵盖其未涵盖的内容
  • 用户明确表示“这应该以不同方式工作”或“这是错误的”

不要针对 Langfuse 本身（产品）的问题触发此操作——仅针对此技能的说明和行为问题。

触发时，请遵循 references/skill-feedback.md 中的流程。