尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
28. Agent 执行到一半想暂停?用 interrupt 给它设个“关卡“!
28. Agent 执行到一半想暂停用 interrupt 给它设个“关卡“在构建复杂的 Agent 系统时我们经常会遇到这样的场景Agent 正在执行一个多步骤的任务比如“下单购买商品”但执行到一半时我们需要它停下来等待用户确认或输入额外信息。如果没有一种机制让 Agent 在中间暂停整个过程就会失控——要么一次性执行完所有步骤可能出错要么不得不强行打断整个流程。今天我们就来深入探讨如何用interrupt中断机制给 Agent 设置“关卡”让它在执行到关键步骤时暂停、等待、再恢复。### 为什么需要 interrupt想象一个电商场景Agent 被要求“帮用户买一部手机”。正常流程是搜索手机 → 选择型号 → 加入购物车 → 确认订单 → 支付。但如果没有 interruptAgent 可能会直接执行支付步骤而用户可能还没确认价格或选择颜色。interrupt 允许我们在“确认订单”这个节点插入一个暂停点让用户检查信息然后决定继续或修改。在实际开发中interrupt 的典型用途包括-用户确认在关键操作前等待用户批准。-动态输入需要用户提供额外参数如地址、优惠码。-条件分支根据暂停点的状态决定后续流程。### 核心概念如何实现 interrupt在 Python 中我们可以利用asyncio的事件循环或自定义状态机来实现 interrupt。这里我们使用一个轻量级的模式用asyncio.Event或asyncio.Condition来阻塞 Agent 的执行直到外部信号触发恢复。下面我将用两个完整的代码示例来演示。—## 示例 1基础 interrupt —— 让 Agent 在步骤中暂停等待用户确认这个示例模拟一个简单的购物 Agent。它执行三步搜索商品、加入购物车、支付。我们在“支付”前插入一个 interrupt等待用户输入yes或no。pythonimport asyncioimport randomclass ShoppingAgent: def __init__(self): self.interrupt_event asyncio.Event() self.user_decision None async def search_item(self, item_name): print(f[Agent] 正在搜索商品{item_name}...) await asyncio.sleep(1) # 模拟搜索延迟 found_items [iPhone 15 Pro, Samsung Galaxy S24, Google Pixel 8] print(f[Agent] 找到商品{random.choice(found_items)}) return found_items[0] async def add_to_cart(self, item): print(f[Agent] 正在将 {item} 加入购物车...) await asyncio.sleep(0.5) print(f[Agent] {item} 已加入购物车当前价格$999) return True async def confirm_payment(self): print([Agent] 准备执行支付...) # --- 设置 interrupt 关卡 --- print([Agent] ⏸️ 暂停等待用户确认支付...) await self.interrupt_event.wait() # 阻塞在这里直到事件被设置 # --- 用户做出决定后恢复 --- if self.user_decision yes: print([Agent] 用户确认支付正在处理...) await asyncio.sleep(1) print([Agent] ✅ 支付成功订单完成。) return True else: print([Agent] ❌ 用户取消支付流程终止。) return False async def run(self, item_name): item await self.search_item(item_name) await self.add_to_cart(item) result await self.confirm_payment() return result def resume_with_decision(self, decision): 外部调用此方法来恢复 Agent self.user_decision decision self.interrupt_event.set() # 设置事件解除 await 阻塞async def main(): agent ShoppingAgent() # 启动 Agent 任务不等待完成 task asyncio.create_task(agent.run(手机)) # 模拟外部用户输入延迟 2 秒后 await asyncio.sleep(2) print(\n[用户] 正在查看订单信息...) # 假设用户输入 yes user_input yes # 在实际应用中这里可以是 input() 或 API 请求 print(f[用户] 输入决定{user_input}) agent.resume_with_decision(user_input) # 等待 Agent 完成 result await task print(f\n最终结果{成功 if result else 失败})if __name__ __main__: asyncio.run(main())运行结果示例[Agent] 正在搜索商品手机...[Agent] 找到商品iPhone 15 Pro[Agent] 正在将 iPhone 15 Pro 加入购物车...[Agent] iPhone 15 Pro 已加入购物车当前价格$999[Agent] 准备执行支付...[Agent] ⏸️ 暂停等待用户确认支付...[用户] 正在查看订单信息...[用户] 输入决定yes[Agent] 用户确认支付正在处理...[Agent] ✅ 支付成功订单完成。最终结果成功关键点解释-asyncio.Event是一个简单的同步原语await event.wait()会阻塞当前协程直到另一个协程调用event.set()。-resume_with_decision()是外部接口模拟用户或另一个系统向 Agent 发送恢复信号。- 这种模式非常适合需要人工介入的场景比如审批流程、动态确认。—## 示例 2高级 interrupt —— 带超时和多次中断的 Agent现实中的 Agent 可能需要多个中断点例如先确认商品再确认支付并且要处理超时情况。这个示例实现了一个更复杂的 Agent它有两个中断点并且每个中断点都有超时机制。pythonimport asyncioimport timeclass AdvancedAgent: def __init__(self): self.interrupts {} # 存储多个中断事件 def create_interrupt(self, name, timeout10): 创建一个新的中断点 event asyncio.Event() self.interrupts[name] { event: event, data: None, timeout: timeout, created_at: time.time() } return event def resolve_interrupt(self, name, data): 外部调用解决中断传入数据 if name in self.interrupts: self.interrupts[name][data] data self.interrupts[name][event].set() else: raise ValueError(f中断 {name} 不存在) async def wait_with_timeout(self, name): 等待中断带超时处理 interrupt self.interrupts[name] try: await asyncio.wait_for(interrupt[event].wait(), timeoutinterrupt[timeout]) return interrupt[data] except asyncio.TimeoutError: print(f[Agent] ⏰ 中断 {name} 超时) return None # 返回 None 表示超时 async def step1_search(self): print([Agent] 步骤1搜索商品...) await asyncio.sleep(1) products [Laptop, Tablet, Smartwatch] print(f[Agent] 找到商品{products}) # 第一个中断让用户选择商品 print([Agent] ⏸️ 中断点1请选择商品编号0-2) choice await self.wait_with_timeout(choose_product) if choice is None: return None selected products[int(choice)] print(f[Agent] 用户选择了{selected}) return selected async def step2_confirm(self, product): print(f[Agent] 步骤2确认购买 {product}...) await asyncio.sleep(0.5) # 第二个中断让用户确认 print([Agent] ⏸️ 中断点2请确认购买yes/no) decision await self.wait_with_timeout(confirm_purchase) if decision yes: print([Agent] ✅ 购买确认继续执行...) return True else: print([Agent] ❌ 购买取消) return False async def run(self): # 创建中断点 self.create_interrupt(choose_product, timeout5) self.create_interrupt(confirm_purchase, timeout5) product await self.step1_search() if product is None: print([Agent] 流程因超时而终止) return False result await self.step2_confirm(product) return resultasync def main(): agent AdvancedAgent() # 启动 Agent task asyncio.create_task(agent.run()) # 模拟外部输入延迟 1 秒后提供商品选择 await asyncio.sleep(1) print(\n[外部] 用户正在选择商品...) agent.resolve_interrupt(choose_product, 1) # 选择 Tablet # 模拟第二个中断输入延迟 2 秒后 await asyncio.sleep(2) print(\n[外部] 用户正在确认购买...) agent.resolve_interrupt(confirm_purchase, yes) # 等待结果 result await task print(f\n最终结果{成功 if result else 失败})if __name__ __main__: asyncio.run(main())运行结果示例[Agent] 步骤1搜索商品...[Agent] 找到商品[Laptop, Tablet, Smartwatch][Agent] ⏸️ 中断点1请选择商品编号0-2[外部] 用户正在选择商品...[Agent] 用户选择了Tablet[Agent] 步骤2确认购买 Tablet...[Agent] ⏸️ 中断点2请确认购买yes/no[外部] 用户正在确认购买...[Agent] ✅ 购买确认继续执行...最终结果成功关键点解释- 使用create_interrupt()动态创建多个中断点每个都有自己的事件和超时。-wait_with_timeout()利用asyncio.wait_for实现超时超时后返回NoneAgent 可以据此做降级处理。- 外部通过resolve_interrupt()传入数据实现了灵活的双向通信。—## 总结通过以上两个示例我们看到了 interrupt 机制在 Agent 系统中的强大作用。它不仅仅是暂停执行更是一种流程控制和人机协作的桥梁。**核心要点**1.中断是状态机的一部分每个中断点代表 Agent 的一个状态等待外部事件触发状态转换。2.异步事件是基础asyncio.Event提供了简单可靠的阻塞/唤醒机制适合大多数场景。3.超时处理必不可少在真实系统中用户可能无响应超时机制能防止 Agent 永久挂起。4.多中断管理复杂 Agent 需要多个中断点建议用字典或类属性统一管理。5.生产环境扩展在实际项目中可以将中断点对外暴露为 REST API 或消息队列实现分布式协作。最佳实践建议- 每个中断点赋予唯一 ID方便追踪。- 中断数据尽量序列化如 JSON以便在分布式系统中传递。- 考虑中断的幂等性防止重复恢复导致错误。有了 interrupt 这个“关卡”你的 Agent 就不再是“闭眼狂奔”的机器而是一个可以随时沟通、灵活调整的智能助手。下次构建复杂流程时记得给它加几个关卡
RELATED

相关推荐

轨道交通PIS系统工控主板选型指南(宽温高可靠工业级嵌入式硬件解决方案)

轨道交通PIS系统工控主板选型指南(宽温高可靠工业级嵌入式硬件解决方案)

随着城市轨道交通网络化运营持续推进,乘客信息系统(Passenger Information System, PIS)已成为地铁、轻轨等城轨车辆的标配系统,承担乘车信息播报、运营公告发布、商业媒体播放等核心功能。车载工况具有持续性振动、供电品质波动大、环境温变范围宽、电磁…

📅 2026/9/29 2:26:46
KMS智能激活工具:一站式解决Windows和Office激活难题

KMS智能激活工具:一站式解决Windows和Office激活难题

KMS智能激活工具:一站式解决Windows和Office激活难题 【免费下载链接】KMS_VL_ALL_AIO Smart Activation Script 项目地址: https://gitcode.com/gh_mirrors/km/KMS_VL_ALL_AIO 还在为系统弹出激活提示而烦恼吗?KMS智能激活工具能够帮你彻底告别W…

📅 2026/10/19 3:37:45
免费开源RPA工具OpenRPA:企业级自动化流程的终极解决方案

免费开源RPA工具OpenRPA:企业级自动化流程的终极解决方案

免费开源RPA工具OpenRPA:企业级自动化流程的终极解决方案 【免费下载链接】openrpa Free Open Source Enterprise Grade RPA 项目地址: https://gitcode.com/gh_mirrors/op/openrpa 你是否厌倦了每天重复枯燥的数据录入和报表整理工作?是否希望有…

📅 2026/10/6 20:46:05
MORE NEWS

更多资讯

📰

綦江电工证怎么考在哪考?新手避坑全攻略

綦江电工证怎么考在哪考?新手避坑全攻略 你是不是也在为 綦江电工证怎么考在哪考 而发愁?不知道去哪报名、怕被中介坑,这种感觉我懂。作为一名在应急管理领域深耕多年的从业者,我深知很多人第一次接触特种作业证书时的焦虑和不安。今天,我就从零开始,…

📰

齐河电工证在哪里报名,2026河南最新政策你怎么看?

齐河电工证在哪里报名,2026河南最新政策你怎么看? 工地太忙根本没时间复习考试,这几乎是所有一线电工的真实写照。尤其是像新乡这样劳务班组频繁流动的地区,时间紧张、任务繁重,很多电工都面临着证书快到期却没时间准备复审或继续教育的问题。202…

📰

年审电工证技巧:考前押题怎么用才不白交培训费

年审电工证技巧:考前押题怎么用才不白交培训费 怕考不过白交培训费?别慌,考前押题用得好,年审电工证不是事儿。尤其是咱们这种经常在一线干活的电工,证要是过不了,不光是钱的事儿,还可能影响后续的工作安排。这篇文章就带你理清楚年审电工证技巧,特别…

📰

工地太忙根本没时间复习考试?年审电工证技巧千万别踩坑

工地太忙根本没时间复习考试?年审电工证技巧千万别踩坑 工地太忙根本没时间复习考试,年审电工证技巧千万别踩坑,这事儿可真不能拖。特别是像我们这种常年在工地一线的电工,天天和电打交道,但证书年审这事儿,一不留神就忘了,结果到头来还得花钱重考。我…

📰

银川考电工证在哪里 保姆级教程:工地太忙根本没时间复习考试

银川考电工证在哪里 保姆级教程:工地太忙根本没时间复习考试 工地太忙根本没时间复习考试,这不是一个人的烦恼,而是很多特种作业人员的真实写照。尤其是电工证,既是门槛也是保障,但报考流程、考试内容、复习方式、复审周期,每一步都让人头大。今天这篇…

📰

包头东河区电工证过期了不知道怎么复审延期?考前押题帮你拿捏关键点

包头东河区电工证过期了不知道怎么复审延期?考前押题帮你拿捏关键点 证书过期了不知道怎么复审延期?别急,这期内容专为包头东河区电工证持有者量身打造,不仅讲清楚复审流程,还带你搞懂电工证在手到底值多少钱、发展前景如何、哪些地方薪资更高,甚至帮你…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬