LangGraph 1.2.20 更新了什么?4.46 万星的图运行时开始拒绝「过期的审批」,部署也改姓 LangSmith(基础篇)

LangGraph 1.2.20 更新了什么?4.46 万星的图运行时开始拒绝「过期的审批」,部署也改姓 LangSmith(基础篇)

10 月 10 日我们写过一次 LangGraph,当时它 4.3 万星,讲的是”把 Agent 画成一张图”这件事。不到一个月,这个库涨到 44,560 星,11 月 5 日发了 1.2.20。版本号只到 1.2.20,改的却是生产环境最疼的地方:同一个任务里每个 interrupt() 有了独立 id,还多了一个严格恢复模式,过期的审批答案会被直接拒绝。对把 Agent 丢进流程里等人点确认的人来说,这比多几个花哨节点实在得多。

它到底是什么

官方定义很拗口:”low-level orchestration framework and runtime for long-running, stateful agents”——低层编排框架和运行时。翻成大白话:它不给你界面,也不规定 Agent 该怎么思考,只给你三样东西——一个带类型的共享状态(State)、一堆普通函数当节点(Node)、以及决定下一步走哪的边(Edge)。拼完 compile(),你得到的是一张能跑、能停、能续的图。

真正值钱的是运行时那三件事:

  • 持久化:compile(checkpointer=...) 之后,每个 super-step 结束都写一次快照,调用时传一个 thread_id,这条会话就能断点续跑、回放,甚至回到任意一步重跑。
  • 人工介入:节点里调 interrupt(),图停在原地、状态存好;人看完批一句,用 Command(resume=...) 从断点接着走,而不是从头再跑一遍。
  • 流式输出:token、节点进度、状态更新都能往外推,前端不用等整轮结束。

2026 年的格局得认清楚:LangGraph Platform 这个名字已经没了,部署产品改叫 LangSmith Deployment,调试界面改叫 LangSmith Studio。开源那层还是 MIT 的 langgraph 库,往上是 LangChain 1.x 的 create_agent(编译出来本来就是一张 LangGraph 图),再往上是 3.1 万星的 deepagents 那套座架。LangGraph 本身不依赖 LangChain,官方 FAQ 写得很直白:不用 LangChain 也能跑。

1.2 这条线改动集中在”跑久了会出事”的地方。1.2.18 把增量通道的默认快照频率从 1000 改成 100,长线程读得更快、存储涨得更快;error_handler 现在能在每条路径上兜住错误,并把失败任务的结果也流出来。1.2.20 则把中断做细:一个任务里多个 interrupt() 不再共用一个 id,恢复时还能开严格模式,拿到的是过期答案就直接拒。

LangGraph 一次运行:状态、检查点与人工中断
一次 LangGraph 运行:条件边决定调不调工具,每一步写检查点,命中审批就 interrupt() 停下,人批完从断点续跑

上手要几步

装包就一行:pip install -U langgraph,Python 3.10 以上。

最小的一张图大概十行:StateGraph(MessagesState) 起手,add_node 挂两个函数(一个调模型、一个跑工具),add_edge(START, "llm_call"),再用 add_conditional_edges 决定”继续调工具还是结束”,最后 compile()。

想让它记住会话,加两行:compile(checkpointer=InMemorySaver()),调用时传 config={"configurable": {"thread_id": "u1"}}。注意 InMemorySaver 重启就丢,生产换 PostgresSaver,建表用 setup()。

要图形界面,配个 langgraph.json,装 pip install "langgraph-cli[inmem]",跑 langgraph dev:不用 Docker,本地 2024 端口起一个 Agent Server,浏览器自动打开 Studio,节点一步步走给你看。

要上线,langgraph build -t my-agent --platform linux/amd64,linux/arm64 打成镜像——ARM64 是官方示例里明写的,A7Z 这种板子能跑,因为 langgraph 本身就是纯 Python 包;也可以 langgraph deploy 直接推到 LangSmith Deployment。

实话

第一,它是库,不是平台。 没有画布,没有”拖一个节点”,所有分支都是 Python 或 TypeScript。不想碰代码,回去用 Dify(1.19 刚补了子流程追踪)或 CrewAI(1.15.29 把执行器删了),别在这儿耗。

第二,开源免费只覆盖运行时。 开发者档 $0,一个月 5,000 条 base trace、1 个席位;Plus $39/席/月,10,000 条 trace,送一个小的 Serverless 部署;自托管和 BYOC 只对企业版开放。用量按 LSU 计,1 LSU = 1 美元。也就是说”装进自己机房”这件事,要么自己拿库拼服务,要么掏企业版的钱。

第三,升级是真会踩坑。 DeltaChannel 的检查点旧版本读不了,JS 那边 Postgres 迁移必须先跑完再放流量;增量通道的整份快照从每 1000 次改成每 100 次,存储跟着涨。升级不是 npm update,是运维事件。

第四,选型先看维护节奏。 AutoGen 的 README 已经挂上 Archived,Flowise 8 月 13 日转只读,都是前车之鉴。LangGraph 目前是这一档里更新最勤的,但反过来说,API 也一直在动。

一句话:Agent 要跑进生产,需要”停下等人、断了能续、账能对上”,LangGraph 是现在最稳的底座之一;只是想拖个聊天机器人出来,它比 Dify 重得多。想看它在整个 Agent 平台里站哪一层,可以翻之前那篇三层横评。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注