- 観察
- 監査
- 修復
- 判断
すぐに答え
エージェントのスレッド状態をどうやってデバッグしますか?
AIがLangGraph Cloudのツールを使用して、特定のスレッドの状態を取得したり、アクティブなスレッドを一覧表示したりします。エラーが見つかったら、新しい状態をスレッドに書き込むことで、バグを回避したりロジックを修正したりできます。停止したエージェントを確実に復旧させるための最短ルートを提供します。
デバッグ作業のプロセス
エージェントのロジックを修正する
データの取得や状態の注入はAIが行うため、あなたはロジックの判断に集中できます。
観察
ボトルネックの特定
AIが特定のスレッドの現在の状態を取得します。停止の原因となっている変数や履歴を明確に把握できます。
監査
対象スレッドの検索
AIがアクティブなセッションをスキャンします。対応が必要な特定のスレッドIDを迅速に見つけ出せます。
修復
修正済み状態の注入
AIがスレッドに手動で更新を書き込みます。これにより、誤ったデータを上書きしてエージェントの進行を再開できます。
判断
人間による介入
AIがエラーを特定しますが、状態変更が安全かどうかはあなたが判断します。最終的なロジックの決定権は常にあなたにあります。
ワークフロー
AIが行う一連の動作
AIはチャットインターフェースとLangGraph Cloudランタイムの架け橋となります。
スレッドの特定
AIが既存の全スレッドを調査し、問題が発生している特定の会話やプロセスを見つけ出します。
list_threadsデータの調査
AIがそのスレッドに保存されている正確な値、チェックポイントの履歴、現在の変数を読み取ります。
get_thread_stateエラーの分析
現在の状態と期待されるロジックを比較し、ループやエラーが発生した箇所を特定します。
get_thread_state状態の修正
AIがスレッドに新しいデータを書き込み、ミスを修正したり、壊れたノードをスキップしたりします。
update_thread_state
試してみる
以下のプロンプトをコピーして開始
これらのプロンプトを使って、すぐにデバッグを開始できます。
出発点
スレッドIDや変数名は、実際のLangGraphのデータに置き換えて使用してください。
LangGraph Cloud Connector
準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。
https://edge.vinkius.com/vk_preview_W9eYJ3x7BufqP9zavlkhkY5HUux0v9z8z0xZYWei/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 — LangGraph Cloud capabilities are ready to use.
{
"mcpServers": {
"langgraph-cloud-stateful-ai-agents-mcp": {
"url": "https://edge.vinkius.com/vk_preview_W9eYJ3x7BufqP9zavlkhkY5HUux0v9z8z0xZYWei/mcp"
}
}
}停止しているスレッドを見つけたいので、アクティブな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 などに接続
