LangGraph
让一次任务,能暂停、能继续。
先跑一个不用模型密钥的真 LangGraph,观察状态、检查点和人工确认。
LangGraph × 知识图谱:让查询返回需要的结果
从 coffeeAGNTCY 的网络拓扑案例,看 LangGraph 编排、MCP 接口、Cypher 查询与 Neo4j 图数据怎样分工。原讲 07:44–14:39 节选,保留原声与原画面,增加中文译文。
完整课程免费开放 · 正在读取学习账号
双语文字稿 · 点一句回到视频
英文来自大会自动转写;KAG、LangGraph、Cypher 等专名按演示画面校订。中文为本站辅助译文。
记录:学员、课程、准备进度
节点读取输入,返回一份状态更新
适合需要明确状态流转、人工介入和故障恢复的人。图能安排执行过程,任务质量仍取决于节点、工具、数据与验收。
01 · 状态、节点和边分别做什么
从一个确定性的流程开始,先看清运行机制。
State 是共享状态,Nodes 是读取状态并返回更新的函数,Edges 决定接下来运行哪个节点。节点既可以执行普通代码,也可以调用模型;使用 LangGraph 不意味着每一步都必须消耗模型额度。
本例用 prepare 节点生成培训开通建议,再进入 review 节点等待人工输入。例子使用合成数据,不访问学校系统,也不发送通知。这样可以先把运行过程测清楚,再决定是否加入模型节点。
把 state 里的 prepared、decision、result 分开,能区分“建议已经生成”“有人做了决定”“流程给出了什么结果”。生产系统还应独立保存真实写入记录和操作者身份。
class State(TypedDict, total=False):
learner: str
prepared: bool
decision: str
result: str跟着做这三步
- 查看 graph.py 中的 State 定义。
- 找到 prepare、review 和 finish 三个节点。
- 指出哪些步骤使用模型:本例没有。
02 · 到关键一步,先停下来
暂停需要检查点,也需要能找到这次任务的线程标识。
interrupt() 将需要人处理的信息交给调用方,并暂停图。编译图时接入 checkpointer,调用时传入 thread_id,恢复时使用相同 thread_id 和 Command(resume=...)。
本例使用 InMemorySaver,因此检查点只保留在当前 Python 进程里。进程退出后不会自动恢复;需要跨重启保存时,应换成持久化存储,并配置账号隔离、访问权限与保留期限。
恢复会重新进入包含 interrupt 的节点;暂停前的代码可能再次执行。不要在这段代码里直接发送付款、通知或其他不可重复的外部动作。把副作用放到确认后的独立节点,并为真实动作设计幂等和审计。
app = builder.compile(checkpointer=InMemorySaver())
config = {"configurable": {"thread_id": "demo-approve"}}
paused = app.invoke({"learner": "Lin"}, config)
finished = app.invoke(Command(resume="approve"), config)跟着做这三步
- 运行 graph.py,先观察暂停信息。
- 使用 approve 恢复,观察最终结果。
- 再运行 reject 路径,确认没有变成批准。
03 · 人工输入,还需要应用校验
能恢复一段流程,不等于已经完成身份认证或真实业务授权。
本例只接受 approve 或 reject;遇到其他值会报错。即使值是 approve,例子也只返回“模拟批准”,不会真的开通课程。
真实系统需要先验证当前操作者是否有权审批这笔任务,再传入恢复值。thread_id 不能用作登录凭据,也不能把知道编号视为拥有权限。
先测同意、拒绝、非法输入和不同线程,再接真实模型与工具。如果未来加入模型,模型调用与存储分别计费;只运行本例的确定性节点不会产生模型调用费。
跟着做这三步
- 运行 verify.py 的四类验证。
- 确认不同 thread_id 的结果没有互相覆盖。
- 为自己的业务写一条审批权限要求和一个外部动作的防重复办法。
走到人工确认前,先停下来。
这是本页的规则教学演示。完整工具运行请下载下方案例;演示不调用模型,刷新后重置。
- 准备
- 生成建议
- 等待确认
- 结束
对应原文与出处
中文内容为原创导读与自编案例,不是官方完整译本。外部原文用于进一步核对,本站微课与练习可先独立学习。
- 官方教程 · 现行网页
LangGraph overview
运行时职责与适用范围;本地案例不包含模型调用。
- 官方教程 · 现行网页
LangGraph Graph API
State、nodes、edges 与编译执行。
- 官方教程 · 现行网页
LangGraph Persistence
检查点与跨线程存储分开理解。
- 官方教程 · 现行网页
LangGraph Interrupts
暂停、Command 恢复、节点重入与副作用边界。