litefuse

Litefuse

此技能可帮助你在各种常见工作流中有效使用 Litefuse：为应用添加埋点、迁移提示词、调试追踪记录，以及以编程方式访问数据。

核心原则

所有 Litefuse 工作都应遵循以下原则：

1. 文档优先：绝不要凭记忆实现。编写代码前，务必获取最新文档（Litefuse 更新频繁）。有关如何访问文档，请参阅下文。
2. 使用 CLI 访问数据：查询或修改 Litefuse 数据时，请使用 litefuse-cli。有关如何使用 CLI，请参阅下文。
3. 根据使用场景遵循最佳实践：实现之前，请查看下方相关参考文件中的使用场景专属指南。
4. 使用最新 Litefuse 版本：除非用户另有指定，或有充分理由，否则始终使用最新版本的 Langfuse SDK/API。

使用场景专属参考资料

• 为现有函数/应用添加埋点：references/instrumentation.md
• 将代码库中的提示词迁移到 Litefuse：references/prompt-migration.md
• 将用户反馈（赞踩、评分、隐式信号）作为评分记录到追踪记录中：references/user-feedback.md
• 使用 Litefuse CLI 的更多技巧：references/cli.md
• 将 Langfuse SDK 升级或迁移到最新版本：references/sdk-upgrade.md
• 提交有关此技能的反馈：references/skill-feedback.md

1. 通过 CLI 使用 Langfuse API

使用 litefuse-cli，即可在命令行中与完整的 Litefuse REST API 交互。通过 npx 运行（无需安装）：

# Discover all available resources
npx litefuse-cli api __schema

# List actions for a resource
npx litefuse-cli api <resource> --help

# Show args/options for a specific action
npx litefuse-cli api <resource> <action> --help

首先，查看架构和可用参数：

凭据

调用前请设置环境变量：

export LANGFUSE_PUBLIC_KEY=pk-lf-...
export LANGFUSE_SECRET_KEY=sk-lf-...
export LANGFUSE_HOST=https://litefuse.cloud # default Litefuse cloud host. Can also be a self-hosted URL. The server must always be specified in order to access Litefuse.

如果尚未设置，请向用户索取 API 密钥（可在 Litefuse UI → Settings → API Keys 中找到）。

CLI 详细参考

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

2. Litefuse 文档

访问 Litefuse 文档有三种方式，按优先顺序排列。始终优先使用应用原生的网页抓取和搜索工具（例如 WebFetch、WebSearch、mcp_fetch 等），而不是 curl。以下 URL 和用法适用于任何抓取方式；curl 示例仅供说明。

2a. 文档索引（llms.txt）

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

curl -s https://litefuse.ai/llms.txt

返回包含每个文档页面标题和 URL 的结构化列表。可利用它查找相关主题的页面，然后直接获取该页面。

或者，也可以从 https://litefuse.ai/docs 开始浏览，找到所需页面。

2b. 将单个页面作为 Markdown 获取

可通过在路径后附加 .md，或在请求标头中使用 Accept: text/markdown，将 llms.txt 中列出的任意页面作为 Markdown 获取。已知所需信息所在页面时，请使用此方式。返回的 Markdown 格式清晰，包含代码示例和配置详情。

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

2c. 搜索文档

如果不知道具体页面，且需要在所有文档、GitHub 问题和讨论中查找信息：

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

示例：

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

返回的 JSON 响应包含：

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

如果找不到相关页面或需要更多上下文，搜索是很好的备用方案。调试问题时尤其有用，因为所有 GitHub 问题和讨论也都已编入索引。响应可能很长，请仅提取相关部分。

文档工作流

1. 从 llms.txt 开始了解文档概况——浏览相关页面标题
2. 确定合适的页面后，获取具体页面
3. 主题不明确且需要更多上下文时，再使用搜索

技能反馈

当用户表示此技能的某些内容未按预期运行、给出了错误指导、缺少信息或可以改进时，请主动提出向 Litefuse 技能维护者提交反馈。这包括以下情况：

• 此技能提供了错误或过时的说明
• 工作流未能产生预期结果
• 用户希望此技能涵盖目前未涵盖的内容
• 用户明确表示类似“这应该采用不同的工作方式”或“这是错的”

遇到 Litefuse 本身（产品）的问题时，不要触发此流程——此流程仅适用于此技能的说明和行为相关问题。

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