AI Agent / 系统课时

用 interrupt 暂停关键节点

用 interrupt 暂停关键节点

高风险工具调用不应由智能体一路自动执行到底。本节在真正执行动作前调用 interrupt(),让 LangGraph 保存可恢复状态并把审批内容交给外部界面,再用同一个线程恢复执行。

学习目标

  • 在关键节点中调用 interrupt() 暂停图执行并返回审批载荷
  • 理解 checkpointer、thread_id 与可恢复暂停之间的关系
  • 使用 Command(resume=...) 把审批结果送回节点并继续运行

暂停不是普通函数返回

interrupt() 会中断当前图运行,把传入的值暴露给调用方,并依赖 checkpointer 保存当前线程状态。调用方看到待审批信息后,可以等待几秒、几小时甚至由另一个请求完成审批;恢复时只要使用同一个 thread_id,图就能从保存的状态继续。

LangGraph interrupt 从暂停到恢复的审批流程

因此,interrupt() 更像“可持久化的暂停点”,而不是 input() 或普通回调。真正决定能否跨请求恢复的是 checkpointer 与稳定的线程标识。

构建最小审批图

下面的可运行示例只有一个审批节点。第一次调用会停在 interrupt();第二次使用同一个配置并传入 Command(resume=True),把审批结果作为 interrupt() 的返回值交回节点。

python
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"])

预期输出:

text
{'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 可恢复人工交互的最小闭环。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 interrupt 暂停关键节点

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通