コンテンツにスキップ

LangGraph 学習ロードマップ

ローカルで LangGraph を触りながら、AI エージェントの harness 設計を理解するための学習ノート。最終ゴールは 既存の ~/temporal-workflows に LangGraph で組んだ agent を Activity として組み込めるようになること。

学習方針

  • 公式ドキュメントを正本にする（docs.langchain.com）
  • 必ず手を動かす。読むだけで終わらせない。各章に「Try」セクションを置く
  • 何が durable / non-deterministic か を常に意識する（Temporal に橋渡しするため）

学習ステップ

# テーマ ファイル 所要
01 環境構築（uv + LangGraph + LangGraph Studio） 01_setup 30分
02 最初の ReAct エージェント 02_first_agent 1時間
03 State と Checkpoint（永続化） 03_state_and_checkpoint 1.5時間
04 Human-in-the-loop（interrupt / resume） 04_human_in_the_loop 1時間
05 Multi-agent / Subgraph 05_multi_agent 2時間
06 Temporal との統合パターン 06_temporal_integration 2時間
99 リンク集・参考資料 99_resources —

合計 8〜10時間で「自分で agent を設計して本番に乗せられる」レベルを目指す。

ゴール（チェックリスト）

学習後に以下が説明・実装できるようになっていればOK。

  • [ ] LangGraph の StateGraph / Node / Edge / Conditional Edge を口頭で説明できる
  • [ ] ReAct ループを LangGraph で自分で書ける（create_react_agent を使わず）
  • [ ] Checkpointer を SQLite と Postgres で動かせる
  • [ ] interrupt() で人間レビューを差し込み、Command(resume=...) で再開できる
  • [ ] Subgraph を使って「専門家 agent」を組み合わせる構成を組める
  • [ ] LangGraph Studio でグラフを可視化しながらデバッグできる
  • [ ] LangGraph agent を Temporal Activity から呼び出すサンプルが動く

Temporal との関係（地図）

┌─────────────────────────────────────────┐
│  Temporal Workflow（durable な外殻）        │
│  - 数日寝かせる・retry・signal・schedule    │
│  ┌───────────────────────────────────┐   │
│  │  Activity                          │   │
│  │  ┌─────────────────────────────┐  │   │
│  │  │ LangGraph Agent              │  │   │
│  │  │ - tool loop                  │  │   │
│  │  │ - state machine              │  │   │
│  │  │ - in-memory checkpointer     │  │   │
│  │  └─────────────────────────────┘  │   │
│  └───────────────────────────────────┘   │
└─────────────────────────────────────────┘
  • LangGraph: agent の中身（loop / tool / state）
  • Temporal: agent をどう信頼性高く動かすかの外殻
  • ローカル学習中は LangGraph 単体 で十分。Temporal 統合は最後の章で扱う

なぜ LangGraph から始めるか

  • AI ワークフローの本質は agent loop の設計（どうツールを呼び、どうstateを回し、どこで止めて人に渡すか）
  • LangGraph はこの本質を最小コードで触れる
  • Temporal は「動くものをどう壊さず動かし続けるか」の道具で、レイヤーが違う
  • 既に Temporal 運用中（~/temporal-workflows）なので、Step 6 で自然に橋がかかる

参考になる先行記事

作成: 2026-05-16 ／ 最終更新: 2026-05-16