AI Agent / 系统课时
处理多个中断与恢复顺序
处理多个中断与恢复顺序
当同一条 LangGraph 线程里同时挂起多个人工交互时,最危险的做法是按界面顺序猜测“第一个回答属于第一个中断”。本篇用并行中断示例建立稳定做法:读取中断 ID、按 ID 绑定回复,并在恢复时保持节点内中断调用顺序不变。
学习目标
- 区分并行任务产生的多个待处理中断与单节点内连续中断
- 使用中断 ID 将人工回复准确映射到对应的
interrupt() - 设计不会因刷新、乱序提交或代码改动而错配的恢复流程
为什么不能只依赖返回顺序
LangGraph 的一次执行可以让多个并行分支分别调用 interrupt()。此时线程里不是“一个暂停点”,而是一组待处理交互;每个中断都带有自己的 ID 和业务载荷。前端可以改变卡片排序,人工也可能先回答后出现的卡片,因此数组下标不应成为业务关联键。
恢复时应把“中断 ID → 人工返回值”作为真正的对应关系。对于同一任务中的连续多个 interrupt(),规则又不同:节点恢复时会从节点开头重新执行,已提供的恢复值按该任务内部的中断调用顺序匹配,所以不能在新版本代码里随意调换这些调用。

用 ID 一次恢复多个待处理中断
下面的完整示例让两个节点并行暂停,再读取两个中断的 id 与 value。人工答案先按业务载荷准备,真正恢复时再转换为以中断 ID 为键的 resume_map,因此不会依赖返回数组的排列。
import operator
from typing import Annotated
from typing_extensions import TypedDict
from langgraph.checkpoint.memory import InMemorySaver
from langgraph.graph import END, START, StateGraph
from langgraph.types import Command, interrupt
class State(TypedDict):
vals: Annotated[list[str], operator.add]
def node_a(state: State):
answer = interrupt("question_a")
return {"vals": [f"a:{answer}"]}
def node_b(state: State):
answer = interrupt("question_b")
return {"vals": [f"b:{answer}"]}
builder = StateGraph(State)
builder.add_node("a", node_a)
builder.add_node("b", node_b)
builder.add_edge(START, "a")
builder.add_edge(START, "b")
builder.add_edge("a", END)
builder.add_edge("b", END)
graph = builder.compile(checkpointer=InMemorySaver())
config = {"configurable": {"thread_id": "review-001"}}
first = graph.invoke({"vals": []}, config)
pending = first["__interrupt__"]
print("pending:")
for item in sorted(pending, key=lambda x: x.value):
print(f"- {item.value} -> {item.id}")
answers = {"question_a": "alice", "question_b": "42"}
resume_map = {item.id: answers[item.value] for item in pending}
final = graph.invoke(Command(resume=resume_map), config)
print("final:")
for value in sorted(final["vals"]):
print(f"- {value}")预期输出
pending:
- question_a -> <ID>
- question_b -> <ID>
final:
- a:alice
- b:42<ID> 每次运行都可能不同;实际程序会打印真实中断 ID。关键不是 ID 的具体内容,而是恢复前始终从当前线程的待处理中断中读取它,再构造 Command(resume=resume_map)。
恢复顺序的两套规则
并行分支的多个中断可以在一次恢复调用中一起提交。此时无需把“谁先回答”转换成某种固定顺序,只要每个值使用正确的中断 ID 作为键,运行时就能把值送回对应的 interrupt()。
单个节点内如果连续调用多个 interrupt(),节点在恢复时会从头执行,并复用已经收到的恢复值。这里的匹配依赖该任务内部的调用次序,所以发布新版本时不能把原来的“姓名 → 年龄 → 城市”改成“年龄 → 姓名 → 城市”,否则尚未完成的旧线程可能得到错误语义。需要改变交互流程时,更稳妥的做法是拆成不同节点,或让旧线程先完成。
让人工界面保持可恢复
实际系统应把当前 checkpoint 返回的待处理中断视为唯一有效任务清单。页面刷新后重新读取线程状态,而不是继续使用浏览器内存里的旧数组;提交时携带对应中断 ID,并在服务器端确认该 ID 仍处于待处理状态。
如果一次只允许审批一个项目,也可以只渲染一个待处理卡片,但后端仍应保存 ID 映射。这样以后改成并行审批、批量审核或多角色协作时,不需要重写恢复协议。只要坚持“线程由 thread_id 定位,交互由 interrupt ID 定位,节点内连续中断保持稳定顺序”,多个中断就不会因为显示顺序或人工响应先后而错配。