LangChain と LlamaIndex:ナレッジエージェントは人の承認を待った後、どう処理を再開するか
社内ナレッジエージェントには、情報検索に加え、承認後に業務システムへ書き込む役割もある。再開位置と実行履歴が主な設計上の制約なら LangGraph を優先して評価する。既に LlamaIndex のデータとツールの基盤があれば Workflows を継続利用できるが、スナップショットと復旧を誰が担うかを明確にする必要がある。いずれも業務操作の重複排除を代替しない。
社内ナレッジアシスタントが制度の質問に答え、その回答に基づいてチケットまで作成するなら、リスクは「回答が正しいか」から「人は何を承認したか、プロセスの再起動後にもう1件作られないか」へと広がる。このような単一エージェントのアプリケーションを開発するチームにとって、LangChain も LlamaIndex も、ツール接続、状態保存、人の入力待ちに対応する。選択の鍵は、復旧の仕組みを自分たちのサービスにどう組み込むかにある。
一時停止位置、状態履歴、再起動後の復旧を統一した実行機構として扱いたいなら、LangChain エコシステムの LangGraph を優先して評価するとよい。既に LlamaIndex を中心に検索とツールを構築し、イベントと永続化を管理する意思があるなら、Workflows を継続利用する十分な理由がある。以下は 2026-11-10 に参照した公式 Python ドキュメントに基づく分析であり、実行テストではなく、障害復旧の効果を保証するものでもない。
まず比較するレイヤーを特定する
LangChain 公式概要は複数のレイヤーを区別している。LangChain の create_agent は組み合わせ可能なエージェントループを提供し、LangGraph は下位のオーケストレーションフレームワーク、Deep Agents はその上のより包括的なエージェントフレームワーク、LangSmith はトレース、デバッグ、評価などのプラットフォーム機能を担う。本稿が扱うのは自作エージェントの実行制御であり、LangSmith の購入や Deep Agents の採用を LangGraph の永続化設定と同一視してはいけない。
LlamaIndex フレームワークも既にエージェントとイベント駆動の Workflows を備えており、検索はエージェントが呼び出せるツールの一種にすぎない。LlamaCloud のドキュメントサービスとは分けて評価すべきであり、現在の公式ページでは関連するマネージド解析・インデックス機能が LlamaParse プラットフォームの下にも示されている。これらのサービスを接続しても、自分たちのエージェントプロセスに復旧能力が備わったことにはならない。
同じ承認ポイントを表す2つの方法
アシスタントが設備の修理申請規定を見つけ、チケットを作ろうとしているとする。承認画面には送信予定の設備、問題の説明、受信先キューを表示し、同意をそのバージョンのパラメーターに結び付けるべきだ。これは本稿の設計シナリオであり、ベンダーの顧客事例ではない。
LangGraph は interrupt で一時停止し、再開時には Command で人の入力を渡す。アプリケーションは checkpointer を設定し、同じ thread_id で実行状態を取得する必要がある。「検索、承認待ち操作の作成、書き込みの実行」を明示的なノードに分ける構成に適し、各段階で何が保存されたかを確認しやすい。
一方、LlamaIndex の人を介在させる例では、ツールがイベントを待つ。InputRequiredEvent で入力を要求し、HumanResponseEvent で応答を返し、wait_for_event が待機を担当する。既にイベントを消費するサービスがあるチームは、このインターフェースに沿って承認画面を接続できる。ただし、承認者の本人確認、パラメーターのバージョン、拒否後の業務処理は、引き続きアプリケーションで定義する必要がある。
いずれも人の入力を実行フローに組み込める。承認ボタン自体は権限システムではない。任意のクライアントが「同意」だけを送信して、他人のチケット処理を再開できるようにしてはいけない。
コンテキストは適切なタイミングで保存する
LangGraph の checkpointer は super-step ごとにグラフ状態を保存し、thread 単位でチェックポイントを整理する。自前のランタイムでは永続化バックエンドと書き込み方針を選ぶ必要があり、メモリ内のサンプルをそのままプロセスをまたぐ復旧と同一視できない。その価値は統一されたチェックポイントモデルにあり、チームのデータベース運用を不要にすることではない。
LlamaIndex の Context は実行をまたいで再利用でき、シリアライズしてデータベースやファイルに書き込める。信頼できる状態保存とイベント処理のコードが既にあれば、この方法は既存サービスの境界に合わせやすい。ただし、実行全体の終了後にしか保存しなければ、途中でクラッシュする直前の最新進捗は保持できない。
永続ワークフローのドキュメントには、実行中の状態変化を捕捉し、スナップショットを書き込み、Context を復旧する方法が示されている。デフォルトのプロセス内実行では、このチェックポイントのループを自分たちで管理する必要がある。一方、公式には DBOS などのランタイムプラグインに永続化と復旧を任せる方法も挙げられている。したがって、LlamaIndex に復旧能力がないとはいえず、シリアライズ可能な Context を、デフォルトで設定済みの信頼できるストレージとみなすこともできない。
承認後でも重複実行は起こり得る
復旧は、特定のコード行からそのまま続行することを意味しない。LangGraph では中断が発生したノードが最初から実行される。LlamaIndex のドキュメントにも、スナップショット取得時に実行中だったステップは最初からやり直され、復旧は少なくとも1回の実行というセマンティクスを持つと記されている。どちらの設計でも副作用を慎重に扱う必要がある。
例えば、チケット作成要求がチケットシステムで成功したのに、エージェントが成功結果を保存する前にクラッシュした場合だ。承認の後に書き込みを置くことは、いつ実行を許可するかを制限するだけで、復旧後の重複送信は防げない。承認済み操作のそのバージョンに対し安定した操作識別子を保存し、受信システムでそれに基づき重複排除すべきである。システムが冪等な要求に対応しない場合、まず実行結果を照会するか人の確認に回す必要があり、むやみに再試行してはいけない。
承認済みパラメーター、承認者、操作識別子、外部チケット番号を一緒に保存する方が、チャット履歴だけを残すより有用である。承認後に対象設備や説明が変わったら、業務ルールに従って再承認するべきだ。以上はアプリケーション設計の助言であり、いずれかのフレームワークが自動提供するトランザクション保証ではない。
障害の境界を使って最終判断する
同じ修理申請フローで3つの地点を検証することを勧める。承認待ち中にプロセスを再起動する、承認を拒否した後に再度復旧する、チケット作成後かつ結果保存前に中断する、の3つだ。元の操作を見つけられるか、拒否の結果が保持されるか、外部システムに想定した1件のチケットだけが存在するかをそれぞれ確認する。これらは本番投入前に行うべき検証であり、本稿で得たテスト結果ではない。
チェックポイントとノードの境界で上記フローを統一管理したいチームは、LangGraph を優先的に試し、状態バックエンドと冪等なツールもプロジェクトに含めるとよい。LlamaIndex の検索とイベントワークフローを既に持つチームは、まず Context のスナップショットや適切な永続ランタイムを検証でき、「Agent に対応する」だけのために既存のデータ層を書き直す必要はない。
アプリケーションが常に読み取り専用で、失敗後は最初から回答し直してよいなら、どちらの長時間実行の復旧設計も、直ちに導入する価値があるとは限らない。本格的な投資が必要になるのは、アシスタントが承認を待ち、外部システムを変更し始める時だ。その時には、同じ承認が業務操作の重複を起こさないと証明できるかの方が、フレームワーク名よりも実用性を左右する。
内容説明:本記事は公開情報をもとに整理した、ツール選定の参考情報です。機能、料金、関連ポリシーは随時変更される場合があります。最新の公式情報をご確認ください。
元の出典:docs.langchain.com