• TRACE
  • OBSERVATION
  • LOGIC
  • HUMAN

AIを活用してLLMチェーンのデバッグを効率化する方法

Langfuseをエージェントに接続すれば、チェーンが脱線した正確なステップを特定できます。接続後は、AIが実行トレースを辿り、根本原因を突き止めます。

このページについてAIに聞く

すぐに答え

LLMチェーンのどこで失敗したかを見つけるには?

エージェントがLangfuseのテレメトリを使用して、特定のトレースやネストされたオブザベーションを取得します。実行パスを調査することで、エラーを引き起こしたプロンプト、入力、または出力をピンポイントで特定。トレース階層の中で、失敗した箇所を明確に把握できます。

調査結果の分類

特定される問題の種類

AIは調査結果を以下の4つの領域に分類します。

TRACE

実行パス全体

エラーを含む特定のトレースを特定します。実行全体の大まかなコンテキストを把握できます。

OBSERVATION

詳細なステップデータ

個々のスパンやコールを深掘りします。特定のステップにおける具体的な入出力が確認できます。

LOGIC

プロンプトとモデルのエラー

期待される出力とモデルが実際に生成した内容を比較します。推論がどこで逸脱したかを特定します。

HUMAN

手動での介入が必要なケース

Langfuseダッシュボード上で、プロンプトやロジックを手動調整する必要がある複雑なエッジケースをフラグ立てします。

ワークフロー

エラー発生時にAIが行うこと

エージェントはLangfuseのデータ階層をナビゲートし、デバッガーとして機能します。

  1. エラーの特定

    直近のアクティビティをスキャンし、関連する実行ログを見つけ出します。

    list_traces
  2. トレースの抽出

    失敗した特定の実行に関する完全なコンテキストを取得します。

    get_trace
  3. スパンの調査

    エラーが発生した特定のネストされたコールを確認します。

    get_observation
  4. 失敗原因の要約

    トレース全体の入出力を比較し、なぜ処理が中断されたのかを説明します。

    get_observation

試してみる

以下のプロンプトをコピーして開始

デバッグを開始するには、これらのプロンプトを活用してください。

出発点

トレースIDや具体的なエラー内容を、実際のLangfuseのデータに置き換えて使用してください。

Langfuse Connector

準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。

コネクタリンクhttps://edge.vinkius.com/vk_preview_sTXOynCd5hRTA7WbjY0nBUsTjmjwRIVY989VA7VU/mcp

Claude Desktop

以下の手順で数秒で接続できます。

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Langfuse capabilities are ready to use.
設定 · claude_desktop_config.jsonコピー
{
  "mcpServers": {
    "langfuse-llm-tracing-evals-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_sTXOynCd5hRTA7WbjY0nBUsTjmjwRIVY989VA7VU/mcp"
    }
  }
}
チャットにコピー04
  • Langfuse内の最新の失敗したトレースを見つけて、なぜ停止したのか教えてください。

  • トレースID 12345を確認し、ツール呼び出しが失敗した特定のオブザベーションを特定してください。

  • 直近のカスタマーサポート・ワークフローのネストされたオブザベーションを確認し、ロジックのどこで問題が起きたか調べてください。

  • 過去1時間以内にエラーとなったすべてのトレースをリストアップしてください。

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

ここから始める

Langfuseを接続して、すぐに質問を開始

LangfuseのAPI認証情報を提供するだけで準備完了です。接続は暗号化されており、すぐにエージェントへトレースの調査を依頼できます。

LangfuseをAIに接続する

FAQ

機能に関する詳細

  • 01

    AIはコードを自動的に修正できますか?

    いいえ。AIはエラーを特定し原因を説明することはできますが、コードやプロンプトの更新は手動で行う必要があります。

  • 02

    AIはLangfuse内のトレースを削除できますか?

    いいえ。提供されるツールはデータの読み取りと取得のみを許可しています。テレメトリの変更や削除はできません。

  • 03

    AIはプロンプトテンプレートの内容を見ることができますか?

    はい。ツールを通じて取得されるトレースのオブザベーションにテンプレートが含まれている場合は、確認可能です。

  • 04

    他のプラットフォームのトレースについても質問できますか?

    いいえ。AIがアクセスできるのは、Langfuseを通じて取得可能なデータのみです。

  • 05

    AIがLangfuseの設定を変更することはありませんか?

    はい。AIの権限はトレースとオブザベーションの読み取りに限定されています。

  • Langfuseについて他に質問がありますか? Langfuse Connectorの全機能を見る

『Langfuse』を Claude、Cursor、ChatGPT などに接続