- TRACE
- OBSERVATION
- LOGIC
- HUMAN
すぐに答え
LLMチェーンのどこで失敗したかを見つけるには?
エージェントがLangfuseのテレメトリを使用して、特定のトレースやネストされたオブザベーションを取得します。実行パスを調査することで、エラーを引き起こしたプロンプト、入力、または出力をピンポイントで特定。トレース階層の中で、失敗した箇所を明確に把握できます。
調査結果の分類
特定される問題の種類
AIは調査結果を以下の4つの領域に分類します。
TRACE
実行パス全体
エラーを含む特定のトレースを特定します。実行全体の大まかなコンテキストを把握できます。
OBSERVATION
詳細なステップデータ
個々のスパンやコールを深掘りします。特定のステップにおける具体的な入出力が確認できます。
LOGIC
プロンプトとモデルのエラー
期待される出力とモデルが実際に生成した内容を比較します。推論がどこで逸脱したかを特定します。
HUMAN
手動での介入が必要なケース
Langfuseダッシュボード上で、プロンプトやロジックを手動調整する必要がある複雑なエッジケースをフラグ立てします。
ワークフロー
エラー発生時にAIが行うこと
エージェントはLangfuseのデータ階層をナビゲートし、デバッガーとして機能します。
エラーの特定
直近のアクティビティをスキャンし、関連する実行ログを見つけ出します。
list_tracesトレースの抽出
失敗した特定の実行に関する完全なコンテキストを取得します。
get_traceスパンの調査
エラーが発生した特定のネストされたコールを確認します。
get_observation失敗原因の要約
トレース全体の入出力を比較し、なぜ処理が中断されたのかを説明します。
get_observation
試してみる
以下のプロンプトをコピーして開始
デバッグを開始するには、これらのプロンプトを活用してください。
出発点
トレースIDや具体的なエラー内容を、実際のLangfuseのデータに置き換えて使用してください。
Langfuse Connector
準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。
https://edge.vinkius.com/vk_preview_sTXOynCd5hRTA7WbjY0nBUsTjmjwRIVY989VA7VU/mcpClaude Desktop
以下の手順で数秒で接続できます。
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — Langfuse capabilities are ready to use.
{
"mcpServers": {
"langfuse-llm-tracing-evals-mcp": {
"url": "https://edge.vinkius.com/vk_preview_sTXOynCd5hRTA7WbjY0nBUsTjmjwRIVY989VA7VU/mcp"
}
}
}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 などに接続
