LangGraph 人工介入机制：用 Interrupt 暂停 Agent 并等待确认

作者：袖梨 2026-09-14

当 Agent 开始调用真实工具，自动化就不再只是流程效率问题。、发送邮件、删除文件等操作一旦判断失误，往往难以撤回。LangGraph 提供的 Interrupt 可以在关键节点暂停工作流，保存当前状态并等待人工输入，随后再从原位置继续执行。

前面我们已经解决了：

Graph 如何组织 Agent 流程
State 如何在节点之间流转
Conditional Edge 如何动态选择路径
Checkpointer 如何保存 State

但是实际 Agent 还有一个重要问题：

不是所有事情都应该让 Agent 自动完成。

有些操作需要人确认。

例如：

删除文件
发布文章
发送邮件
修改数据库

这时候就需要：

Human-in-the-loop（人在循环中）

1. 为什么 Agent 需要人工介入？

假设一个自动 Agent：

用户：

帮我给张三100元


Agent：

调用工具


完成

如果 Agent 判断错误：

转错账户

转错金额

后果很严重。

所以更合理：

用户

↓

Agent准备执行

↓

暂停

↓

用户确认

↓

继续执行

2. Interrupt 是什么？

LangGraph 提供：

interrupt()

它的作用：

暂停当前 Graph 执行，并等待外部输入。

例如：

const awaitConfirm = (state)=>{

  const input = interrupt({
    action:"向张三100元"
  });

}

执行：

Node

↓

interrupt()

↓

暂停

3. Interrupt 发生了什么？

注意：

interrupt 不是普通函数返回。

它不会：

return "等待"

而是：

暂停 Graph

此时：

当前 State

+

当前执行位置

需要保存。

所以：

interrupt

必须依赖

checkpointer

4. 一个 Demo

State：

const StateAnnotation = Annotation.Root({

  actionSummary:Annotation({
    reducer:(prev,next)=>next,
    default:()=> ""
  }),

  userInput:Annotation({
    reducer:(prev,next)=>next,
    default:()=> ""
  })

});

保存两个数据：

actionSummary

用户要确认的动作


userInput

用户输入

第一个节点

const showTransfer = ()=>({

  actionSummary:
    "向张三 $100"

});

执行：

State：

{
 actionSummary:
 "向张三 $100"
}

第二个节点

const awaitConfirm=(state)=>{

 const text=interrupt({

   actionSummary:
   state.actionSummary

 });

 return {
   userInput:text
 }

}

读取：

state.actionSummary

得到：

向张三 $100

然后：

interrupt()

暂停。

5. Graph 暂停之后发生什么？

第一次：

await graph.invoke({},config)

执行：

START

↓

showTransfer

↓

awaitConfirm

↓

interrupt暂停

类似：

{
 __interrupt__:[
   {
    value:{
      actionSummary:
      "向张三 $100"
    }
   }
 ]
}

此时：

Agent 等待用户。

例如：

终端：

是否确认？

> 确认

6. 如何恢复？

恢复需要：

Command

例如：

await graph.invoke(
  new Command({
    resume:"确认"
  }),
  config
);

含义：

告诉 LangGraph：

上次暂停的位置继续执行，并把这个值交给 interrupt。

恢复后：

原来的：

const text = interrupt(...)

会得到：

text="确认"

然后继续：

return {
 userInput:"确认"
}

最终：

{
 actionSummary:
 "向张三 $100",

 userInput:
 "确认"
}

流程结束。

7. 为什么一定需要 thread_id？

因为可能有很多用户同时暂停：

例如：

用户A：

等待确认

用户B：

等待确认删除文件

LangGraph 必须知道：

恢复哪个任务。

所以：

{
 configurable:{
   thread_id:"user-a"
 }
}

表示：

恢复 user-a 的那一次执行。

8. Interrupt 完整流程

用户请求

↓

Agent执行

↓

准备执行危险操作

↓

interrupt()

↓

保存 State + 执行位置

↓

等待用户

↓

Command(resume)

↓

恢复 Graph

↓

继续执行

↓

结束

9. Interrupt 和普通函数暂停的区别

普通代码：

function test(){

 console.log("开始");

 await input();

 console.log("继续");

}

如果程序关闭：

状态没了。

LangGraph：

interrupt

↓

checkpointer保存现场

↓

之后恢复

它保存的是：

State
当前节点
执行路径

所以它适合长流程 Agent。

10. LangGraph 到这里形成完整 Agent 工作流

现在完整模型：

                 State

                   ↓


START

 ↓

Node

 ↓

Edge

 ↓

Conditional Edge

 ↓

Loop

 ↓

Checkpointer

 ↓

Interrupt

 ↓

Resume

 ↓

END