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 のドキュメントにアクセスする方法は 3 つあります。以下に優先順で示します。利用可能な場合は、curl よりも、アプリケーション標準の Web 取得・検索ツール（例：WebFetch、WebSearch、mcp_fetch など）を必ず優先してください。以下の URL とパターンは、どの取得方法でも使用できます。curl の例は説明用です。

2a. ドキュメントインデックス（llms.txt）

すべてのドキュメントページの完全なインデックスを取得します。

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

各ドキュメントページのタイトルと URL が、構造化された一覧で返されます。これを使ってトピックに適したページを見つけ、そのページを直接取得してください。

または、https://litefuse.ai/docs から始めてサイトを探索し、必要なページを見つけることもできます。

2b. 個別ページを Markdown として取得する

llms.txt に記載されたページは、パスに .md を追加するか、リクエストヘッダーで Accept: text/markdown を指定すると、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 の issue／discussion から情報を探したい場合に使用します。

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 の issue と discussion もすべてインデックス化されているため、問題のデバッグに特に役立ちます。レスポンスが大きくなることがあるため、関連部分だけを抽出してください。

ドキュメントの確認手順

1. llms.txt から始めて全体を把握し、関連するページタイトルを確認します。
2. 適切なページが見つかったら、そのページを取得します。
3. トピックが不明確で、さらに詳しい情報が必要な場合は、検索します。

スキルへのフィードバック

このスキルが期待どおりに動作しない、誤った案内をした、情報が不足している、または改善できる点があるとユーザーが伝えた場合は、Litefuse スキルのメンテナーへのフィードバック送信を提案してください。以下の場合が該当します。

• スキルが誤った手順や古い手順を案内した
• ワークフローで期待した結果が得られなかった
• スキルに含まれていない内容を扱ってほしいとユーザーが希望している
• 「これは動作が違うはずです」「これは間違っています」など、ユーザーが明示的に伝えた

Litefuse 自体（製品）に関する問題では、この処理を開始しないでください。対象は、このスキルの手順や動作に関する問題のみです。

該当する場合は、references/skill-feedback.md の手順に従ってください。