• 観察
  • 監査
  • 修復
  • 判断

AIを活用してLangGraphエージェントのスレッド状態をデバッグする方法

エージェントをLangGraph Cloudに接続すれば、実行中のスレッド内部を直接確認できます。プロセスのどこで停止したかを特定し、最初からやり直すことなく修正が可能です。

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

すぐに答え

エージェントのスレッド状態をどうやってデバッグしますか?

AIがLangGraph Cloudのツールを使用して、特定のスレッドの状態を取得したり、アクティブなスレッドを一覧表示したりします。エラーが見つかったら、新しい状態をスレッドに書き込むことで、バグを回避したりロジックを修正したりできます。停止したエージェントを確実に復旧させるための最短ルートを提供します。

デバッグ作業のプロセス

エージェントのロジックを修正する

データの取得や状態の注入はAIが行うため、あなたはロジックの判断に集中できます。

観察

ボトルネックの特定

AIが特定のスレッドの現在の状態を取得します。停止の原因となっている変数や履歴を明確に把握できます。

監査

対象スレッドの検索

AIがアクティブなセッションをスキャンします。対応が必要な特定のスレッドIDを迅速に見つけ出せます。

修復

修正済み状態の注入

AIがスレッドに手動で更新を書き込みます。これにより、誤ったデータを上書きしてエージェントの進行を再開できます。

判断

人間による介入

AIがエラーを特定しますが、状態変更が安全かどうかはあなたが判断します。最終的なロジックの決定権は常にあなたにあります。

ワークフロー

AIが行う一連の動作

AIはチャットインターフェースとLangGraph Cloudランタイムの架け橋となります。

  1. スレッドの特定

    AIが既存の全スレッドを調査し、問題が発生している特定の会話やプロセスを見つけ出します。

    list_threads
  2. データの調査

    AIがそのスレッドに保存されている正確な値、チェックポイントの履歴、現在の変数を読み取ります。

    get_thread_state
  3. エラーの分析

    現在の状態と期待されるロジックを比較し、ループやエラーが発生した箇所を特定します。

    get_thread_state
  4. 状態の修正

    AIがスレッドに新しいデータを書き込み、ミスを修正したり、壊れたノードをスキップしたりします。

    update_thread_state

試してみる

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

これらのプロンプトを使って、すぐにデバッグを開始できます。

出発点

スレッドIDや変数名は、実際のLangGraphのデータに置き換えて使用してください。

LangGraph Cloud Connector

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

コネクタリンクhttps://edge.vinkius.com/vk_preview_W9eYJ3x7BufqP9zavlkhkY5HUux0v9z8z0xZYWei/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 — LangGraph Cloud capabilities are ready to use.
設定 · claude_desktop_config.jsonコピー
{
  "mcpServers": {
    "langgraph-cloud-stateful-ai-agents-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_W9eYJ3x7BufqP9zavlkhkY5HUux0v9z8z0xZYWei/mcp"
    }
  }
}
チャットにコピー04
  • 停止しているスレッドを見つけたいので、アクティブなLangGraphスレッドをすべてリストアップして。

  • エージェントが停止した理由を確認したいので、スレッドID 'abc-123' の現在の状態を教えて。

  • スレッド 'xyz-789' の状態を更新して、'user_input' 変数の値を 'retry' に設定して。

  • スレッド 'debug-456' の状態を確認して、最後に正常に実行されたノードを教えて。

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

ここから始める

LangGraph Cloudと一度連携すれば、あとは指示するだけです。

アカウントをリンクするだけで準備完了です。認証情報は暗号化されて保護されます。お使いのAIクライアントからすぐにスレッドのデバッグを開始できます。

LangGraph CloudをAIと連携させる

FAQ

機能に関する詳細

  • 01

    AIはスレッドを削除できますか?

    いいえ。AIができるのはスレッド状態のリスト表示、読み取り、更新のみです。スレッドの削除はLangGraph Cloud上で手動で行う必要があります。

  • 02

    状態を更新すると、すぐに新しいノードが実行されますか?

    AIは状態を更新しますが、次のノードが実際に実行されるかどうかは、LangGraphの設定やグラフのトリガー方法に依存します。

  • 03

    AIはデータベース全体を見ることができますか?

    いいえ。AIがアクセスできるのは、LangGraph Cloudのツールを通じて提供される特定のスレッド状態とメタデータのみです。

  • 04

    AIはグラフのコードを変更できますか?

    いいえ。AIは実行中のスレッド内のデータを修正することはできますが、基盤となるPythonロジックやグラフの構造自体を変更することはできません。

  • 05

    特定のスレッドIDを見つけるにはどうすればいいですか?

    AIにすべてのスレッドをリストアップするよう依頼してください。利用可能なIDの一覧が返されるので、そこから選択できます。

  • LangGraph Cloudに関するその他の質問は、Connectorのページで確認できます。 LangGraph Cloud Connectorの全機能を見る

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