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
• 体系的なエラー分析 — トレースの読み取り、障害分類の構築、修正対象の決定：references/error-analysis.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_HOST=https://cloud.langfuse.com # EU クラウドの例。US クラウドの場合は us.cloud.langfuse.com、自ホスト URL の場合もあります。Langfuse にアクセスするには、サーバーを常に指定する必要があります。

設定されていない場合は、ユーザーにシェルまたは .env ファイルで設定するよう依頼してください（セキュリティ上の理由から、チャットにキーを貼り付けるよう求めないでください）。キーは Langfuse UI → Settings → API Keys で見つかります。

詳細な CLI リファレンス

一般的なワークフロー、ヒント、および完全な使用パターンについては、references/cli.md を参照してください。

2. Langfuse ドキュメント

Langfuse ドキュメントにアクセスする 3 つの方法（優先順）。利用可能な場合は、常に curl より WebFetch、WebSearch、mcp_fetch などのアプリケーションネイティブな Web 取得およびサーチツールを優先してください。以下の 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 とディスカッションもすべてインデックス化されているため、問題のデバッグに特に役立ちます。レスポンスは大きい可能性があります — 関連する部分のみを抽出してください。

ドキュメントワークフロー

1. llms.txt で方向性を確認 — 関連するページタイトルをスキャン
2. 適切なページを特定したときに 特定ページを取得
3. トピックが不明確で、より多くのコンテキストが必要な場合は 検索 にフォールバック

スキルフィードバック

ユーザーがこのスキルについて期待どおりに機能していない、不正確なガイダンスがある、情報が不足している、または改善される可能性があると表現した場合 — Langfuse スキルメンテナーにフィードバックを送信することを申し出てください。これは以下の場合を含みます：

• スキルが間違ったまたは古い指示を提供した
• ワークフローが期待される結果を生じなかった
• ユーザーがスキルにカバーされていない何かをカバーすることを希望している
• ユーザーが明示的に「これは異なる方法で機能すべき」または「これは間違っている」のようなことを言う

このことを発火させないでください：Langfuse 自体（製品）の問題の場合 — このスキルの指示と動作の問題のみ。

トリガーされた場合は、references/skill-feedback.md のプロセスに従ってください。