LangGraph

一、项目简介

LangGraph 是 LangChain 团队推出的 Agent 编排框架。它用「图（节点 + 边）」来建模复杂的多步 Agent 流程与状态机，支持循环、条件分支、状态持久化与人机协同，适合构建可控、可恢复的生产级 Agent。

二、核心特性

• 图 / 状态机模型：节点执行逻辑，边控制流转；
• 支持循环与分支：能表达「重试」「反思」类流程；
• 状态持久化：checkpoint 机制，可中断恢复；
• 人机协同：支持 interrupt 等待人工确认；
• 与 LangChain 生态互通；
• 可视化与调试支持。

三、适用场景

• 复杂多步 Agent 工作流；
• 需要人工审核 / 中断恢复的长任务；
• 对可控性要求高于「全自动」的业务。

四、快速上手

pip install langgraph
from langgraph.graph import StateGraph
g = StateGraph(dict)
g.add_node("step1", fn)          # fn: state -> state
g.set_entry_point("step1")
app = g.compile()
print(app.invoke({"q": "你好"}))

五、注意事项

• 核心概念（state / node / edge / checkpointer）需要时间掌握；
• 与 LangChain 版本配套，注意版本兼容；
• 图过于复杂会降低可维护性，建议模块化拆分。