← 概念解説に戻る

Concept Fable

LangGraph

LangGraph · エージェントワークフローフレームワーク

まず物語を読む。ここでは急いで定義を示さず、まず問題そのものを立ち上がらせる。

寓話

織坊は逸れやすい仕事を状態を持つ図に描いた

織坊は仕事の割り振りができる親方を招いた。彼は染坊、仕立て屋、経理係、検品人を交代で働かせ、簡単な注文は口頭で伝えるだけで完了できた。

注文が複雑になると、口頭の指示が効かなくなった。ある布は先に色を検めてから裁つ、あるものは顧客の確認を待つ、あるものは失敗後に前の段階に戻る。師匠が頭に覚えるフローはますます増えていった。

徒弟はまず、すべての手順を長い一覧に書いた。一覧は完全に見えるが、分岐、待機、再試行を扱えない。途中で誰かが割り込むと、仕事がどこで止まっているか分からなくなる。

ある大口顧客がサイズを変更した。仕立て屋はすでに裁断し、染め工房はまだ色を補正し、経理係は旧仕様で見積もっていた。プロセスはどこか一工程で壊れたのではなく、状態が共同で保存されていなかったことで壊れた。

親方は一枚の織り図に切り替えた。各ノードは一工程、各辺は次の条件を示し、注文状態は図の中央に書かれる。顧客確認が必要な箇所では止まり、確認後に正しい辺に沿って続行する。

織り図は重要なノードで結び目を作る。夜間に作業を止めても、翌日は前回のチェックポイントから再開できる。あるノードが失敗すれば、図に従って再試行するか、人手の分岐に回せる。最も有用なのは人手の停車点だ。顧客がなかなか確認せず、検品者が色差を見つけ、帳簿係が価格を変更する必要があるとき、織り図は無理に進まず、止まるべきノードで止まり、人が判断を終えるのを待ってから続ける。

後に、織坊は同時に多種の注文を処理できるようになった。順序実行するもの、並行待機するもの、複数の師匠が協力するもの。複雑さは消えなかったが、見える、回復可能な構造に収められた。後に管事はこの経験を日常の規律に書き込んだ。まず場面を見て、次に境界を見て、最後に失敗時に誰が引き継げるかを見る。これらがすべて明確になって初めて、美しいデモは納品可能な仕事になる。

師匠は理解した。多段階の自動処理は、思いつきの呼び出しの連続ではなく、状態、条件、チェックポイント、人手介入位置を備えたワークグラフである。図を織ることは最初は鈍重に感じられた。しかし注文が増えるにつれ、師匠はそれが「今どこまで進んだか」を個人の記憶から取り出し、誰もが引き継げる位置に置くことに気づいた。

明らかにする

この物語が語るのは:LangGraph

LangGraph は、ステートフルで多段階、制御可能な Agent ワークフローを構築するためのグラフ型フレームワークである。ノード、エッジ、共有状態、checkpoint、永続化、human-in-the-loop によって複雑なフローを支え、分岐、ループ、復旧、マルチ Agent 連携、実行の制御性を必要とする企業向け LLM アプリケーションに適している。

重要なのは、それが単なる用語ではなく、実際のAI/Agentシステムで繰り返し現れる構造的な問題だという点だ。これを理解して初めて、いつモデルを足すべきか、いつプロセスを変えるべきか、いつガバナンスを補うべきかを判断できる。

メタファーのマッピング

  • 織工房の注文:企業における多段階Agentタスク
  • 長いリスト:線形 chain は複雑な状態を扱いにくい
  • 大口顧客がサイズを変更:運用中断、変更、状態の不整合
  • 織図ノード:LangGraph nodes
  • 辺と条件:graph edges / conditional routing
  • 図の中央にある注文状態:shared state
  • 重要ノードで結ぶ:checkpointing と persistence
  • 顧客確認で停止:human-in-the-loopワークフロー

Andy(任旭)判断

この概念の実戦的価値は、「賢く見えるAI機能」を納品可能、検収可能、ガバナンス可能な作業単位に分解する手助けをすることです。

state graphcheckpointinghuman-in-the-loopマルチエージェント・ワークフローLangChain
京ICP备2026014272号