• TRACE
  • ERROR
  • INPUT
  • HUMAN

AIを活用してエージェントの実行エラーをデバッグする方法

LangSmithをエージェントに接続して、実行トレースを調査しましょう。接続後は、AIが特定の実行データを取得し、ロジックのどこに問題があったかを特定できます。

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

すぐに答え

AIを使ってエージェントの実行失敗の原因を特定できますか?

はい。AIがLangSmithを使用して、特定のエラーのトレースや実行詳細を取得します。ワークフローが失敗した正確なステップを特定し、修正に必要なコンテキストを提示します。

調査結果の分類

調査によって判明すること

AIは取得したデータを、以下の明確な項目に分類します。

TRACE

実行パスの全容

AIが実行時のイベントシーケンスを取得します。どのツールが呼び出され、何が返されたのかを正確に把握できます。

ERROR

根本原因の特定

AIが特定のエラーメッセージを抽出します。実行が停止した正確な理由がわかります。

INPUT

データの検証

AIが各ステップに送られた入力値をチェックします。不正なデータが原因で失敗した箇所を特定できます。

HUMAN

手動での修正が必要なケース

プロンプトやツールのロジック変更が必要な実行をAIがフラグ立てします。最終的な解決はユーザー自身で行います。

ワークフロー

実行失敗時にAIが行うこと

AIはLangSmithのデータを解析するフォレンジックツールとして機能します。

  1. 失敗箇所の特定

    AIが履歴をスキャンし、指定された実行エラーが発生した箇所を見つけ出します。

    langsmith_list_runs
  2. トレースの取得

    失敗した特定の実行に関する詳細なデータとメタデータを取得します。

    langsmith_get_run
  3. エラーの分析

    期待される出力と、システムから返された実際のエラーを比較・分析します。

    langsmith_get_run
  4. 修正案の提示

    実行が失敗した理由を説明し、エージェントのロジックをどう調整すべきか提案します。

    langsmith_get_run

試してみる

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

調査を開始するために、これらのプロンプトを活用してください。

出発点

括弧内のテキストを、実際の実行IDやエラー内容に書き換えて使用してください。

LangSmith Connector

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

コネクタリンクhttps://edge.vinkius.com/vk_preview_JBueIzhraYvzf2S9aR0UP9Q6bjldfIBgmwxTvRHt/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 — LangSmith capabilities are ready to use.
設定 · claude_desktop_config.jsonコピー
{
  "mcpServers": {
    "langsmith-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_JBueIzhraYvzf2S9aR0UP9Q6bjldfIBgmwxTvRHt/mcp"
    }
  }
}
チャットにコピー04
  • LangSmithで最後に失敗した実行を見つけて、なぜクラッシュしたのか教えてください。

  • 実行ID 'run_123abc' の詳細を取得し、ツール呼び出しで発生したエラーを説明してください。

  • 過去1時間以内に失敗したすべての実行をリストアップして、傾向を分析してください。

  • 実行 'run_456def' のトレースを確認し、最終ステップの入力値が何であったか教えてください。

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

ここから始める

一度接続すれば、あとは聞くだけです

LangSmithのAPIキーを入力して開始してください。認証情報は暗号化して保持されます。詳細な手順はコネクターのページで確認できます。

LangSmithをAIに接続する

FAQ

機能に関する詳細

  • 01

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

    いいえ。AIはエラーを特定して修正案を提示しますが、コードの更新は手動で行う必要があります。

  • 02

    AIはLangSmithから実行データを削除できますか?

    いいえ。このMCPは、実行データの読み取りとリスト表示の権限のみを持っています。

  • 03

    AIはどうやってデバッグ対象の実行を見つけるのですか?

    リスト取得ツールを使用して履歴をスキャンし、特定された実行のトレースを個別に取得します。

  • 04

    AIはLangSmithに新しいトレースを作成できますか?

    いいえ。AIの役割は、既存の実行データの調査と分析に限定されています。

  • 05

    AIはLangSmithプロジェクトの全データにアクセスできますか?

    AIは、使用するAPIキーの権限に基づき、リスト表示および取得が可能な実行データにアクセスできます。

  • LangSmithに関するその他の質問は、コネクターのページで回答しています。 LangSmith MCPの全機能を見る

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