AI Agent / 系统课时
用 interrupt 暂停关键节点
用 interrupt 暂停关键节点
高风险工具调用不应由智能体一路自动执行到底。本节在真正执行动作前调用 interrupt(),让 LangGraph 保存可恢复状态并把审批内容交给外部界面,再用同一个线程恢复执行。
学习目标
- 在关键节点中调用
interrupt()暂停图执行并返回审批载荷 - 理解 checkpointer、
thread_id与可恢复暂停之间的关系 - 使用
Command(resume=...)把审批结果送回节点并继续运行
暂停不是普通函数返回
interrupt() 会中断当前图运行,把传入的值暴露给调用方,并依赖 checkpointer 保存当前线程状态。调用方看到待审批信息后,可以等待几秒、几小时甚至由另一个请求完成审批;恢复时只要使用同一个 thread_id,图就能从保存的状态继续。

因此,interrupt() 更像“可持久化的暂停点”,而不是 input() 或普通回调。真正决定能否跨请求恢复的是 checkpointer 与稳定的线程标识。
构建最小审批图
下面的可运行示例只有一个审批节点。第一次调用会停在 interrupt();第二次使用同一个配置并传入 Command(resume=True),把审批结果作为 interrupt() 的返回值交回节点。
from typing_extensions import NotRequired, TypedDict
from langgraph.checkpoint.memory import InMemorySaver
from langgraph.graph import END, START, StateGraph
from langgraph.types import Command, interrupt
class ApprovalState(TypedDict):
action: str
approved: NotRequired[bool]
def approval_node(state: ApprovalState):
decision = interrupt({
"kind": "approval",
"action": state["action"],
})
return {"approved": bool(decision)}
builder = StateGraph(ApprovalState)
builder.add_node("approval", approval_node)
builder.add_edge(START, "approval")
builder.add_edge("approval", END)
graph = builder.compile(checkpointer=InMemorySaver())
config = {"configurable": {"thread_id": "approval-demo"}}
paused = graph.invoke(
{"action": "refund order <ID> 1000 CNY"},
config=config,
)
print(paused["__interrupt__"][0].value)
resumed = graph.invoke(
Command(resume=True),
config=config,
)
print(resumed["approved"])预期输出:
{'kind': 'approval', 'action': 'refund order <ID> 1000 CNY'}
True<ID> 是动态订单标识占位符,实际运行时应替换为真实 ID。示例使用内存 checkpointer 便于本地验证;如果进程重启后仍要恢复,生产环境必须使用可持久化的 checkpointer。
把审批内容设计成可执行决策
传给 interrupt() 的值应足够让审批者独立判断,但不要包含无法安全展示的秘密。一个实用的审批载荷通常包含动作类型、目标对象、关键参数、风险说明和必要的业务摘要。
恢复值也应保持简单明确。若只有“通过/拒绝”,布尔值即可;如果还允许修改参数,可以让审批界面返回结构化对象,例如 {"approved": true, "amount": 800},节点恢复后再做一次服务端校验。
避免在 interrupt 前执行不可重复副作用
恢复图时,包含 interrupt() 的节点会从节点开头重新执行,因此 interrupt() 之前的代码必须可重复,或至少不能提前产生不可逆副作用。不要先扣款、发邮件或修改数据库,再调用 interrupt() 等待审批。
更安全的顺序是:先读取状态并生成审批摘要,随后 interrupt();拿到恢复值并校验通过后,再执行真正的外部动作。若必须在暂停前写入数据,应使用幂等键、事务或“待审批”状态,确保重复执行不会产生第二次副作用。
验证可恢复交互
本地验证时可以分别检查暂停和恢复两个阶段:第一次 invoke() 必须返回 __interrupt__,且高风险动作尚未执行;第二次用同一 thread_id 恢复后,审批结果应写回状态并进入后续节点。
如果恢复时像新任务一样重新开始,优先检查三点:图是否编译了 checkpointer、两次调用是否复用了同一个 thread_id、恢复调用是否传入 Command(resume=...)。这三者构成了 LangGraph 可恢复人工交互的最小闭环。