
Nikolai Smirnov
Software Development Lead
已发表 Nov 03, 2026
已更新 Nov 03, 2026 · 最小阅读量

当操作员停止一个 AI agent 时,可能仍有一个 CAPTCHA 请求在运行。几秒钟后 solver 返回了结果。如果程序把每一个返回的 token 都当作继续运行的许可,那么一个已被取消的工作流仍然可能继续操作页面。实际问题不只是中断等待:应用必须阻止新的提交,并确保旧结果不能重新启动工作。
CapSolver 可以作为该工作流中的 solver 步骤。它的任务创建 API 和 MCP 接口使用的标识符与外围的 agent 运行不同。一个可靠的停止动作要保持这些层次相互独立,并记录究竟停止了什么,而不是对已经不再受控的系统一概打上“已取消”的标签。
对于 agent 运行、MCP 请求和 solver 任务,“取消”的含义并不相同。要把每一层都当作独立的状态转换来处理。
| 层级 | 你的应用可以请求或强制的内容 | 它不能因此成立的事实 |
|---|---|---|
| Agent 运行 | 停止规划、派发和浏览器操作 | 外部请求已被撤回 |
| MCP 请求 | 为进行中的请求发送相应的取消信号 | 每个服务器都能中断其所有底层工作 |
| Solver 任务 | 跟踪 provider 文档化的任务状态 | 关闭客户端会删除任务或退还费用 |
CAPTCHA token 只是某个特定验证流程中的结果。它不应该成为恢复已被用户取消的 agent 运行的理由。结果到达时,调用方当前的授权状态和页面状态仍然很重要。
使用一个应用运行 ID 表示用户的作业,一个 MCP 请求 ID 表示工具调用,以及一个 provider 任务 ID(当该接口有暴露时)。solver 的 taskId 不应被当作 MCP 取消通知中的 requestId,除非它恰好真的是实际的协议请求 ID——而你的设计不应做这种假定。
如果上层工具隐藏了 provider 任务 ID,要记录这一限制。不要通过从响应中提取任意数字来伪造一个 ID,也不要暗示你可以检查某个接口没有暴露的远程任务。
第一个取消动作应当是在等待网络清理之前,将该应用运行标记为“非活动”。每一个派发边界都应检查这一状态。
考虑一个 agent 已检测到 reCAPTCHA 组件并排队了一个 solver 调用。如果用户在派发前取消,应用就应当丢弃该排队调用。不能因为动作已经被规划过,就仍然创建一个付费任务。如果派发已经在进行中,要记录请求可能已跨越边界,并在支持的范围内继续执行请求级别的取消。
这一顺序同样适用于重试。重试调度器在重试到期时必须检查当前运行状态。仅仅把作业从可见的聊天 UI 中移除,却不使其计划中的工作失效,就会在取消之后仍然保留一条新的 CAPTCHA 提交路径。
为界面提供精确的文案:“运行已停止;不会再启动新的 solver 调用”与“provider 任务已取消”是不同的说法。第二种表述需要 provider 文档化行为的证据。
MCP 取消针对的是当前协议连接上的某个请求。MCP 取消规范描述了 notifications/cancelled,包括 requestId 和可选的原因字段。
应使用 MCP 客户端所支持的取消路径,而不是构造带有猜测 ID 的消息。该通知适用于先前在同一方向上发出的、被认为仍在进行中的请求。根据所引用的规范,初始化并不是可取消的请求。
接收端预期会在可能的情况下停止相关处理,但取消通知可能与已完成的响应发生竞态,或在工作已无法被中断后才到达。一个取消通知并不是远程处理已经停止的确认。
Python 开发者还需要区分任务取消与停止工作线程。Python asyncio 取消文档描述的是异步任务的协作式取消。取消那个在等待阻塞式 SDK 调用的协程,并不保证底层网络调用或外部 solver 工作已经停止。
兑换你的 CapSolver 奖励码
立刻提升你的自动化预算!
在为 CapSolver 账户充值时使用奖励码 CAP26,每次充值都能额外获得 5% 奖励金额——没有上限。
现在就到你的 CapSolver 控制台 进行兑换。
迟到的结果必须在触发浏览器动作之前,立刻通过当前运行的检查。只在请求开始时检查还不够。
一个小的代际标记可以让这一规则更直观。下面的本地示例在取消时使该标记失效,并拒绝旧结果。这只是一个应用状态示例,不是 MCP 传输实现,也不是远程 solver 取消方法。
from dataclasses import dataclass
@dataclass
class Run:
generation: int = 1
cancelled: bool = False
def cancel(self):
self.cancelled = True
self.generation += 1
def may_apply(self, result_generation):
return not self.cancelled and result_generation == self.generation
run = Run()
request_generation = run.generation
assert run.may_apply(request_generation)
run.cancel()
assert not run.may_apply(request_generation)
print('Late result discarded; no claim of remote task cancellation')
使用 Python 3.12 并以 python cancel_gate.py 运行示例。它会检查激活状态和已取消状态,然后打印迟到结果已被丢弃。它不进行任何网络调用,也不会提交 CAPTCHA 任务。
在并发应用中,要保证状态更新与最终动作决策保持协调。一次检查后接一个无关的 await 会重新打开竞态:程序在等待期间运行可能被取消,然后再基于过期决策继续执行。使用你的应用的串行化或加锁策略,以确保无法在校验与动作派发之间忽略取消。
运行仍处于活动状态是必要条件,但不足以保证安全。浏览器在解题过程中可能已经跳转到其他页面,或替换了组件。应当将结果与相应的浏览器检查点关联,如果该上下文不再是当前的,就应拒绝该结果。
这并不意味着要把旧 token 尝试用于每一个新页面。它的含义是:把过期结果视为过期,并决定用户当前的任务是否需要一次新的、被许可的尝试。
一个已创建的任务,即便在你的 agent 停止等待之后也可能继续运行。任务结果文档描述了如何为已知任务 ID 获取结果;它并没有文档化一个通用的 cancelTask 操作。
不要虚构这样的端点,不要承诺取消退款,也不要把关闭 HTTP 连接当作服务撤销提交的证据。如果你的应用需要取消后的记账处理,应当使用已文档化接口设计一个独立的、有界的对账流程。要使其独立于浏览器后续行为,并避免将返回的 token 作为记账证据进行日志记录。
一份有用的记录应包含应用运行 ID、取消时间、派发是否已开始、已知的 provider 任务 ID(如果可用),以及是否抑制了浏览器操作。只存储你的支持或财务流程真正需要的内容。“迟到结果已忽略”这一事件本身就可以足够,而不必保留结果本身。
MCP 工具契约同样把工具执行和消费该结果的应用行为区分开来。一个完成的工具结果并不能决定一个已取消的 agent 是否应执行另一项操作。
要在派发前、等待中以及应用结果前测试取消行为。这是三个不同的场景,失败模式也不同。
在派发前,要验证没有发送任何 solver 调用。在请求过程中,要验证已运行受支持的客户端取消路径,并且不会出现自动重试。对于迟到结果,要验证应用拒绝了过期运行的标记,并未执行任何浏览器操作。最后,启动一个新的运行,并确认旧结果不会被附加到它上面。
如果你的问题发生得更早——在任何工具调用之前——那么可以参考已连接工具未被调用指南来处理那一类独立的问题。取消处理从工作被排队或已在进行中这一刻才开始。
在与 CapSolver 协作时,要保持承诺范围狭窄但有用:从 agent 侧停止新的 solver 工作,在支持的范围内停止等待,抑制过期结果,并如实报告外部任务状态。
问:取消 MCP 调用是否会自动取消 CAPTCHA 任务?
不会。MCP 取消信号并不提供这样的保证。服务器可能已经向 provider 提交了工作,而 provider 文档化的任务行为必须单独处理。
问:我可以把 solver 任务 ID 用作 MCP 取消请求 ID 吗?
不可以。应使用由你的客户端管理的实际 MCP 请求 ID。solver 任务 ID 属于另一层 API。
问:迟到的 token 是否应该自动恢复 agent?
不应该。已取消的运行必须在任何浏览器后续动作之前先拒绝迟到结果。新的运行需要其自身当前的任务和页面上下文。
问:停止本地等待是否意味着该请求是免费的?
不是。本地取消并不能说明计费或退款行为。应依据 provider 文档化的策略和实际任务记录,而不是从客户端状态推断费用。

Nikolai Smirnov
Software Development Lead
Building dependable software for complex automation.
关于作者