AI Skills
langfuse

langfuse

熱門

與 Langfuse 互動並存取其文件。當需要 (1) 透過 CLI 以程式方式查詢或修改 Langfuse 資料（追蹤、提示、資料集、評分、工作階段及任何其他 API 資源），(2) 查閱 Langfuse 文件、概念、整合指南或 SDK 使用方式，或 (3) 了解任何 Langfuse 功能如何運作時使用。此技能涵蓋基於 CLI 的 API 存取（透過 npx）及多種文件檢索方法。

201星標
22分支
更新於 2026/7/10
獲取技能源代碼

相關技能

doc-coauthoring15萬planning-and-task-breakdown7.7萬ppt-master3.9萬
SKILL.md
readonlyread-only
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 文件的方法，依偏好順序排列。請優先使用您應用程式的原生網頁擷取與搜尋工具（例如 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 議題與討論也已建立索引。回應可能很大——請僅擷取相關部分。請注意，變更記錄文章也可能出現在此處：僅用於確認功能是否存在，切勿根據其實作——其範例可能已過時，請務必根據文件與 API/SDK 參考來實作。

文件工作流程

  1. 從 llms.txt 開始以取得方向——掃描相關頁面標題
  2. 在確定正確頁面後擷取特定頁面
  3. 當主題不明確且需要更多上下文時，備用搜尋

技能意見回饋

當使用者表示此技能有某些地方不如預期、提供錯誤指引、遺漏資訊或可以改進時——提議向 Langfuse 技能維護者提交意見回饋。這包括以下情況：

  • 技能提供錯誤或過時的指示
  • 工作流程未產生預期結果
  • 使用者希望技能涵蓋目前沒有的內容
  • 使用者明確表示「這應該以不同方式運作」或「這是錯的」

請勿針對 Langfuse 本身（產品）的問題觸發此機制——僅針對此技能的指示與行為問題。

觸發時，請遵循 references/skill-feedback.md 中的流程。