LangGraph interrupt() 函数详解

原创

已于 2025-09-01 13:41:34 修改 · 269 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#langchain #langgraph

于 2025-09-01 13:13:11 首次发布

LangGraph interrupt() 函数详解

1. 基本功能

暂停当前节点执行并请求人工输入
抛出GraphInterrupt异常
需配合Command(resume=...)恢复执行

2. 执行流程

# 典型执行顺序
1. 节点开始执行
2. 遇到interrupt()调用
3. 抛出异常暂停执行
4. 等待人工输入
5. 通过resume命令恢复
6. 从节点入口重新开始执行

3. 使用限制

只能在节点函数内部调用
不能在图定义/边定义中使用
恢复后会重新执行整个节点

4. 多工具场景问题

中断恢复会导致工具重新执行
解决方案：
- 使用状态标记记录进度
- 将中断工具放在最后
- 拆分到不同节点

最低0.47元/天解锁文章

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

红蒲公英

关注关注

2
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

LangGraph react agent 执行过程原理详解

AI天才研究院

10-15

1553

三、节点级行为agent 节点（call_model）① 接收当前 state。② 把系统提示（system_prompt）拼到 messages 最前面：“你是助手，可用工具 xxx，尽量调用后再回答。③ 调用 ChatOpenAI（或任意支持 function-calling 的模型）。④ 返回 {“messages”: [response]} —— 若模型想调用工具，response 里会带 tool_calls 列表。tools 节点（ToolNode）

# 大模型应用开发技术：手动更新状态（五）

大模型与Agent智能体

06-21

639

MultiAgent

参与评论您还未登录，请先登录后发表或查看评论

LangGraph-2-interrupt 流程中断

路漫漫其修远兮，吾将上下而求索。

07-10

404

是 LangGraph 中一个强大的流程控制机制，允许在状态机执行过程中根据特定条件中断当前流程并跳转到其他节点。这一机制可以让开发者在关键操作执行前对条件进行检查，若不满足条件，就提前终止流程，避免不必要的计算或者操作。这一机制可以让开发者在关键操作执行前对条件进行检查，若不满足条件，就提前终止流程，避免不必要的计算或者操作。是两个强大的流程控制机制，允许在节点执行前或执行后插入中断检查。这些机制提供了更精细的流程控制能力，特别适合需要精确管理执行顺序和条件的复杂工作流。在 LangGraph 中，

开源模型应用落地-LangGraph101-探索 LangGraph人机交互-添加断点（一）

热门推荐

以微薄之力，予他人些许温暖.

03-05

2万+

通过“断点机制”实现了智能系统的可控自主性。

LangGraph 的 interrupt 机制概览

m0_53830442的博客

11-01

896

摘要：LangGraph中的interrupt功能用于在图执行过程中暂停运行，等待外部输入后恢复。它通过Command(resume=...)传回恢复值，适用于审批、确认等人工介入场景。中断触发时抛出GraphInterrupt并暂停图运行；恢复时会从节点开头重新执行，而非中断处继续。使用时需配合检查点持久化（如MemorySaver）和thread_id标识会话。典型用法包括节点内单次/多次中断、子图中断处理，需注意副作用应置于中断后以避免重复执行。静态断点（编译时预置）适合调试，动态断点（运行时触发）更

LangGraph官网学习之路——4.人工介入协助

03-12

1264

通过interrupt和Command再graph中中断AI自动执行流程，请求与用户交互，并根据用户的回答或决定执行相应的节点。

LangGraph 人工介入机制实战：interrupt 功能设计与应用模式解析

佑瞻的博客

06-22

2197

先来看一个完整的中断示例，注意代码中三个关键阶段的衔接：python# 1. 定义包含interrupt的节点函数"""当图执行到该节点时会暂停，等待人工输入"""# 传递需要人工处理的文本内容"instruction": "请将这段文本简化为50字以内"})# 返回人工处理后的结果，更新图状态# 2. 构建并编译图checkpointer = Checkpointer() # 必须指定检查点保存状态# 3. 执行图并处理中断# 首次调用触发中断。

2. LangGraph 动态中断教程

The cure for boredom is curiosity. This is the log of its adventures.

11-12

2237

介绍如何使用 LangGraph 库创建一个状态图，并在执行过程中处理动态中断。

LangGraph--基础学习(Subgraphs 子图)

进击的菜鸟

06-25

3242

这几个章节，但是我觉得这些都是调试使用的，使用技巧也是中断的概念，所以大家去官网自己学习，我这边直接进入子图学习，为后续的多智能体学习做准备。子图允许您构建具有多个组件的复杂系统，这些组件本身就是图。该函数需要在调用子图之前将输入（父）状态转换为子图状态，并在从节点返回状态更新之前将结果转换回父状态。对于更复杂的系统，您可能希望定义与父图具有。如果您的应用程序是这种情况，则需要定义一个。中的共享状态键（通道）进行通信。的子图（没有共享键）。恢复图形后，将无法访问子图形状态。这将从父图和任何子图流输出。

【LangGraph】create_react_agent 方法详细解释

weiliang_Handan的博客

07-09

488

create_react_agent是LangGraph中用于创建支持工具调用的React(推理-行动)代理的核心函数。它接受语言模型对象和工具列表作为主要参数，通过状态图实现智能代理功能。该函数提供多种配置选项，包括系统提示、响应格式化、状态管理、检查点和中断控制等。其核心工作原理是通过Agent节点调用模型、Tools节点执行工具操作，并支持循环处理工具调用直到任务完成。函数还包含版本控制(v1/v2)，分别对应不同的工具处理方式。该功能适用于构建复杂的对话式AI应用，支持记忆、中断和异步等高级特性。

【Agent的革命之路——LangGraph】人机交互中的interrupt&Command

weixin_40143861的博客

01-11

3576

在LangGraph中，实现人机交互最核心的就是Command和interrupt，就是前面设计4种交互模式所使用的共同方法，简单点说就是中断图，获取人类提供的值，再恢复图。我们这次就来详细分析一下这两个语法。

LangGraph项目教程：深入理解控制流原语（Branch、Send、Interrupt）

gitblog_00001的博客

06-05

464

LangGraph项目教程：深入理解控制流原语（Branch、Send、Interrupt）【免费下载链接】Tutorial-Codebase-Knowledge Turns Codebase into Easy Tutorial with AI ...

【LangGraph】强大的功能人类和agent的交互（中）

weixin_40143861的博客

01-01

1214

在我们的代码中，这个更新状态和覆盖消息都是基于我们打断agent来的，在上面这些运行日志里也可以看到每一步包括agent在用tools工具搜索之前组装的内容是什么，然后我们覆盖的消息是什么，最后工具出来的结果是什么，很好的实现了我们控制agent的行为。下一节我们将实现人类和agent交互的最后一步，自定义状态。

【Agent的革命之路——LangGraph】人机交互中的细节（等待用户的指令）

weixin_40143861的博客

01-12

1315

这节我们探讨下如何使用interrupt等待用户输入，虽然前面都有讲过，但是有部分同学还是一知半解，我决定把这一块详细的逻辑整理出来，从头到尾给大家讲述一下。人机交互 (HIL) 交互对于agentic系统至关重要。等待人工输入是一种常见的HIL交互模式，允许agentic询问用户澄清问题并在继续之前等待输入。我们可以使用函数在LangGraph中实现这一点。interrupt允许我们停止图形执行以收集用户的输入，并使用收集的输入继续执行。

LangGraph SDK 人机环路，从中断处恢复

Hcy_code的博客

10-12

411

LangGraph SDK 人机环路演示

【大模型从入门到精通19】开源库框架LangChain LangChain文档加载器1

kaggle expert，全球排名前1000，清华计算机研究生，兴趣算法工程

08-13

2239

在数据驱动的应用领域，特别是涉及对话界面和大型语言模型（LLM）的应用中，从各种来源高效加载、处理并与数据进行交互的能力至关重要。这些加载器擅长处理来自公共源的数据，如 YouTube、Twitter 和 Hacker News，同时也适用于来自专有源的数据，如 Figma 和 Notion。保存清洗后的文本：可选地，脚本可以将清洗和分词后的文档文本保存到文件中。这个扩展的代码提供了一个更全面的示例，展示如何从加载和清洗文本到基本分析和处理特殊情况，对 PDF 文档进行程序化的处理。

这是一个基于Docker容器化技术实现的企业级私有云文档协作与在线编辑一体化部署解决方案项目_通过精心编排的DockerCompose配置将Seafile开源私有云盘系统与Onl.zip

最新发布

12-04

C++编程面向对象核心特性的技术解析：封装继承多态在软件工程中的应用与实现

12-04

内容概要：本文系统梳理了C++的核心基础知识，涵盖面向对象三大特性（封装、继承、多态）、动态内存管理（new/delete与malloc/free的区别）、作用域、引用与指针、类与对象、构造与析构函数、静态成员、常函数、运算符重载、拷贝构造、赋值操作符、单例与工厂设计模式、STL常用容器（vector、list、deque、map、set、unordered_map）及其操作，以及迭代器、算法和函数对象等内容。文章通过代码示例深入讲解了C++中关键机制的实现原理，如多态的虚函数表机制、智能指针替代方案、内存泄漏防范等。; 适合人群：具备C++基础语法知识，有一定编程经验，希望深入理解C++面向对象机制、内存管理和常用设计模式的初中级开发者，尤其适合准备面试或提升系统编程能力的学习者；使用场景及目标：①掌握C++面向对象核心机制的底层原理与实现方式；②理解常见设计模式在C++中的应用；③熟练使用STL容器与算法进行高效编程；④辨析C++中易混淆概念（如new/malloc、引用/指针、深拷贝/浅拷贝）；阅读建议：建议结合代码示例动手实践，重点关注类的构造与析构过程、多态实现机制、STL容器的操作特性及设计模式的应用场景，理解其背后的设计思想而不仅仅是语法使用。

interrupt函数用法

07-15

在编程中，`interrupt`函数或机制主要用于处理中断服务例程（Interrupt Service Routine, ISR），特别是在嵌入式系统和底层开发中。C51编译器提供对中断的直接支持，允许开发者在C语言源程序中编写中断服务函数，而无需使用汇编语言。这种功能通过关键字`interrupt`实现，它将一个普通函数定义为中断服务函数。 ### `interrupt`函数的基本用法在C51编译器中，定义一个中断服务函数需要指定中断号，并且该函数没有返回值和参数。语法格式如下： ```c void 函数名(void) interrupt 中断号 { // 中断服务代码 } ``` 例如，定义一个用于处理外部中断0的服务函数： ```c void external_interrupt_0(void) interrupt 0 { // 处理中断逻辑 P1 = ~P1; // 假设操作：翻转P1端口的状态 } ``` 上述代码中的`interrupt 0`表示该函数是外部中断0的中断服务程序。当中断0被触发时，处理器会自动调用此函数执行相应的中断处理逻辑[^1]。 ### 示例：定时器中断以下是一个使用定时器中断的示例，展示了如何利用`interrupt`关键字实现定时器中断服务程序： ```c #include <reg51.h> sbit LED = P2^0; // 定义LED连接到P2.0引脚 void Timer0_ISR(void) interrupt 1 { TH0 = 0xFC; // 设置定时器高8位初值 TL0 = 0x18; // 设置定时器低8位初值 LED = ~LED; // 翻转LED状态 } void main(void) { TMOD = 0x01; // 设置定时器0为模式1（16位定时器） TH0 = 0xFC; // 初始化定时器高8位 TL0 = 0x18; // 初始化定时器低8位 ET0 = 1; // 使能定时器0中断 EA = 1; // 使能全局中断 TR0 = 1; // 启动定时器0 while (1); // 主循环为空，所有工作由中断完成 } ``` 在这个例子中，`Timer0_ISR`函数通过`interrupt 1`声明为定时器0的中断服务程序。每当定时器溢出时，LED的状态会被翻转，从而实现定时闪烁的效果[^1]。 ### 注意事项 - **中断号**：每个中断源都有唯一的中断号，需根据硬件手册确定。 - **无返回值和参数**：中断服务函数不能有返回值或参数。 - **上下文保存**：编译器通常会自动保存寄存器状态，但在某些情况下可能需要手动干预。 - **中断优先级**：可以通过设置中断优先级寄存器来管理不同中断的重要性。 ### 应用场景 - **外设控制**：如键盘扫描、ADC采样等。 - **实时处理**：如定时任务、PWM波形生成等。 - **异常处理**：如错误检测与恢复机制。通过合理使用`interrupt`函数，可以显著简化中断服务程序的开发过程，提高系统的响应速度和效率。