跳到内容
九天共学
工具实操
工具实操 / Agent 执行

LangGraph

让一次任务,能暂停、能继续。

先跑一个不用模型密钥的真 LangGraph,观察状态、检查点和人工确认。

免费学习3 节微课 · 1 段视频 · 含练习约 42 分钟心晴九天整理
进阶案例 · 原声节选 · 06:55

LangGraph × 知识图谱:让查询返回需要的结果

从 coffeeAGNTCY 的网络拓扑案例,看 LangGraph 编排、MCP 接口、Cypher 查询与 Neo4j 图数据怎样分工。原讲 07:44–14:39 节选,保留原声与原画面,增加中文译文。

手机横屏或全屏看更清楚

完整课程免费开放 · 正在读取学习账号

双语文字稿 · 点一句回到视频

英文来自大会自动转写;KAG、LangGraph、Cypher 等专名按演示画面校订。中文为本站辅助译文。

先看一遍过程 · 交互图解1 / 3

记录:学员、课程、准备进度

节点读取输入,返回一份状态更新

适合需要明确状态流转、人工介入和故障恢复的人。图能安排执行过程,任务质量仍取决于节点、工具、数据与验收。

01 · 状态、节点和边分别做什么

从一个确定性的流程开始,先看清运行机制。

State 是共享状态,Nodes 是读取状态并返回更新的函数,Edges 决定接下来运行哪个节点。节点既可以执行普通代码,也可以调用模型;使用 LangGraph 不意味着每一步都必须消耗模型额度。

本例用 prepare 节点生成培训开通建议,再进入 review 节点等待人工输入。例子使用合成数据,不访问学校系统,也不发送通知。这样可以先把运行过程测清楚,再决定是否加入模型节点。

把 state 里的 prepared、decision、result 分开,能区分“建议已经生成”“有人做了决定”“流程给出了什么结果”。生产系统还应独立保存真实写入记录和操作者身份。

class State(TypedDict, total=False):
    learner: str
    prepared: bool
    decision: str
    result: str
一个节点没有调用模型,还算 LangGraph 节点吗?

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)
InMemorySaver 的示例进程退出后,能自动找回检查点吗?

03 · 人工输入,还需要应用校验

能恢复一段流程,不等于已经完成身份认证或真实业务授权。

本例只接受 approve 或 reject;遇到其他值会报错。即使值是 approve,例子也只返回“模拟批准”,不会真的开通课程。

真实系统需要先验证当前操作者是否有权审批这笔任务,再传入恢复值。thread_id 不能用作登录凭据,也不能把知道编号视为拥有权限。

先测同意、拒绝、非法输入和不同线程,再接真实模型与工具。如果未来加入模型,模型调用与存储分别计费;只运行本例的确定性节点不会产生模型调用费。

知道别人的 thread_id,就应该允许对方恢复审批吗?
动手试一下

走到人工确认前,先停下来。

这是本页的规则教学演示。完整工具运行请下载下方案例;演示不调用模型,刷新后重置。

  1. 准备
  2. 生成建议
  3. 等待确认
  4. 结束
任务已准备,尚未运行。
带走自己的案例

下载后,跑出真实结果。

一个本地可运行的 Python 图,观察暂停、批准、拒绝及线程隔离;不调用模型或真实业务接口。

下载完整练习包
单独下载文件
网站演示用于理解机制;工具样例的运行步骤、依赖和边界写在练习包 README 中。

对应原文与出处

中文内容为原创导读与自编案例,不是官方完整译本。外部原文用于进一步核对,本站微课与练习可先独立学习。

  • 官方教程 · 现行网页

    LangGraph overview

    运行时职责与适用范围;本地案例不包含模型调用。

  • 官方教程 · 现行网页

    LangGraph Graph API

    State、nodes、edges 与编译执行。

  • 官方教程 · 现行网页

    LangGraph Persistence

    检查点与跨线程存储分开理解。

  • 官方教程 · 现行网页

    LangGraph Interrupts

    暂停、Command 恢复、节点重入与副作用边界。

来源核验:2026-11-12 · 署名与许可说明
使用统计:关闭

帮助心晴了解哪些内容有用。默认关闭;不记录问题正文、私人笔记、手机号或聊天内容。

允许关联后,登录账号的页面与操作可由运营查看。已启用浏览器“不跟踪”时不采集。明细最多保留 90 天,后台读取或每日首次采集时清理。