《AI Agent 产品开发·交互、信任与上线》3.3 撤销模型:能撤什么、撤到哪

撤销不是界面上的 Ctrl+Z,而是范围、时间窗、补偿动作三件齐全的承诺。本节用 A Relay、B Quill、C Runner 对比建议、版本与动作三种撤销对象,说明 C 的 30 分钟窗口、86% 可回滚比例与 14% 不可撤动作,并给出不可撤销时必须提前拦截的判定模型。

以下人物、公司与数字均为教学假设,不构成对任何真实产品的评价。

打断和纠偏处理的是「还没发生」和「正在发生」,撤销处理的是「已经发生」。这三个词在产品界面上经常被塞进同一个按钮,实际含义完全不同。撤销不是让时间倒流,而是一组明确的承诺:能撤什么、撤到哪、多长时间内可撤、撤不了怎么办。

只回答前两个问题,撤销会在事故里失效;四个都回答,产品才敢把动作交给机器执行。这一节把撤销拆成三要素,再用 C Runner 的改价与发通知说明:不可撤销的动作,必须在发生之前拦截。

撤销的三要素

要素回答的问题缺失后的后果
范围撤销对象是什么:建议、版本还是动作用户不知道撤销会影响到哪一层
时间窗从什么时候到什么时候可以撤用户以为能撤,实际已经过期
补偿动作撤不了时用什么弥补不可撤动作发生后没有任何后手

范围决定撤销的粒度。建议没有落库,撤销就是不采纳;版本可以回退到上一版;动作需要反向执行,或者用补偿动作抵消影响。三者不是能力高低,而是对象不同。把建议的撤销做成「删除记录」,或把动作的撤销做成「隐藏界面」,都是范围错位。

时间窗决定承诺的边界。B 的报告在发布前可以无限次回退,发布后不能撤回;C 的动作在执行后 30 分钟内可以反向执行,超过 30 分钟或已经传播到客户侧,就只能补偿。时间窗必须写在界面上,不能只写在内部文档里。

补偿动作决定最坏情况下的责任。撤销模型如果不写补偿,等于假设所有动作都能撤回。C 的事实表直接打破这个假设:错误中 86% 可回滚,14% 不可回滚,不可回滚错误率是 1.7% × 14% = 0.238%。这 0.238% 就是补偿动作存在的理由。

三种撤销对象

建议的撤销是不采纳。 A Relay 的建议不落库,用户点「不采纳」或直接改队列,建议就失效了。它没有版本,也没有外部副作用,所以撤销时间窗是「无」——不是零秒,而是不需要窗口。给 A 设计「30 分钟内可撤销」没有意义,因为 30 分钟后这条建议本来就不存在了。

版本的撤销是回退。 B Quill 的产出是报告草稿,发布前可以回退到上一版,发布时间不限。发布后不能撤回已经发到客户手里的报告,只能补发更正说明。这里的边界不是时间,而是「是否已经离开系统」:文件还在编辑器里,回退是内部操作;文件已经进入客户渠道,回退就变成了对外沟通。

动作的撤销是反向执行。 C Runner 改价、改库存、下架,都可以用相反的动作抵消:改回原价、恢复库存、重新上架。反向执行有前提:原值还在、下游还没消费这个变化、时间窗还没过。三个前提缺一个,反向执行就不再等价于撤销。

三种对象对应三种界面。建议的撤销是一个「不采纳」按钮;版本的撤销是版本历史;动作的撤销是带回滚句柄的审计日志。把它们统一成一个「撤销」按钮,用户无法判断按下之后到底发生了什么。

评审时可以用一句话检验:用户按下撤销后,能不能说出被撤销的对象、时间窗和影响范围。说不出来,说明撤销模型还没有设计完。

C Runner 的改价:什么时候还能撤

改价是 C 最典型的动作。它外部可见、直接影响成交,但在 30 分钟内通常可以改回原价。产品需要区分三种状态:

状态判定可用操作
已改价,未传播30 分钟内,下游未读取新价格反向执行,改回原价
已改价,已传播客户已看到新价格,或超过 30 分钟补偿:说明、恢复原价、必要时人工回访
准备改价,但没有回滚能力系统没有原值快照或没有反向接口执行前拦截,不允许自动改价

第三种状态最容易被忽略。很多团队在设计时假设「改错了再改回来」,却没有检查系统是否保存了原价、是否有反向接口、下游是否会缓存新价格。没有这些条件,改价在事实上就是不可撤销的,只是团队不知道。产品评审时应该直接问:这个动作的原值在哪里、反向接口是谁、30 分钟内下游会不会读到。

发通知比改价更严格。通知一旦发出,无法从客户那里收回。C 的 14% 不可回滚动作主要就是这类已发出的通知,所以它必须在发送前停,而不是发送后想办法。发通知前的拦截不是审批的同义词:它可以是自动检查收件人、检查内容、检查是否重复发送,只有检查不通过才转人工。

时间窗不能拍脑袋定,用三个问题校准:

  1. 下游多久会读到这个变化? 下游是分钟级缓存还是小时级同步,决定窗口的上限。
  2. 反向接口是否存在且幂等? 没有反向接口,时间窗再长也只是界面承诺。
  3. 超过窗口后谁来做补偿? 补偿责任人、补偿渠道和补偿话术要在上线前确定,而不是出事时再找。

三个问题答不上来,说明这个动作在当前系统里事实上不可撤销,应该按不可撤动作处理:执行前拦截,而不是执行后承诺。

补偿不是撤销

补偿动作经常被写成「一键回滚」的兜底,但它和撤销有本质区别:撤销让动作像没发生过,补偿是承认动作已经发生,再用另一个动作降低影响。

B 的补偿是补发更正说明。报告已经发给客户,错误已经进入客户的决策材料,补发说明不能删除客户已经读到的内容,只能修正记录。C 的补偿是补发说明加人工回访,因为价格或库存变化可能已经影响客户下单。补偿比撤销贵,而且补偿本身也需要被记录、被审阅。

这也是 C 的人工账里最容易被低估的一块。事实表给出的 4.04 分钟,是 0.96 分钟审计加 3.08 分钟转人工;它计算的是常规审计与接管,不包含不可回滚错误发生后的补偿动作。补偿是低频高成本事件,不能用平均值摊掉。产品做预算时应该把补偿单列,而不是假设它会被日常人工吸收。

把撤销模型写成判定

下面的模型把范围、时间窗、补偿写进同一张表,并给出两个判定:当前请求能不能撤,以及某类动作是否必须在执行前拦截。

// file: src/trust/03-3-undo-model.ts
// tier: L2
// verify: node --test test/trust/03-3-undo-model.test.ts

// 撤销模型:范围、时间窗、补偿动作三件齐全才算可撤销。
// C 的 30 分钟窗口与 86% 可回滚比例来自事实表;14% 是已发出通知类动作。

import { FULL } from "../core/rate.ts";

export type UndoScope = "none" | "suggestion" | "version" | "action";

export type Compensation =
  | "none"
  | "corrective-notice"
  | "corrective-notice-and-callback";

export type WindowKind = "none" | "before-publish" | "after-action";

export type UndoModel = {
  readonly key: "A" | "B" | "C";
  readonly scope: UndoScope;
  readonly windowKind: WindowKind;
  readonly windowMinutes: number | null;
  readonly compensation: Compensation;
};

export const UNDO_MODELS: Record<"A" | "B" | "C", UndoModel> = {
  A: {
    key: "A",
    scope: "suggestion",
    windowKind: "none",
    windowMinutes: null,
    compensation: "none",
  },
  B: {
    key: "B",
    scope: "version",
    windowKind: "before-publish",
    windowMinutes: null,
    compensation: "corrective-notice",
  },
  C: {
    key: "C",
    scope: "action",
    windowKind: "after-action",
    windowMinutes: 30,
    compensation: "corrective-notice-and-callback",
  },
};

export type Action =
  | "suggestion"
  | "publish"
  | "price-change"
  | "delist"
  | "send-notice";

export type UndoRequest = {
  readonly action: Action;
  readonly executed: boolean;
  readonly elapsedMinutes: number;
  readonly published?: boolean;
  readonly propagated?: boolean;
};

export type UndoDecision = {
  readonly mode: "noop" | "undo" | "compensate" | "block";
  readonly reason: string;
};

export function decideUndo(
  model: UndoModel,
  request: UndoRequest,
): UndoDecision {
  if (model.scope === "suggestion" || request.action === "suggestion") {
    return { mode: "noop", reason: "建议未落库,撤销就是不采纳" };
  }
  if (request.action === "publish") {
    if (request.published !== true) {
      return { mode: "undo", reason: "未发布,回退上一版即可" };
    }
    return { mode: "compensate", reason: "已发布,只能补发更正说明" };
  }
  if (request.action === "send-notice") {
    if (!request.executed) {
      return { mode: "block", reason: "通知不可撤,必须在发出前拦截" };
    }
    return { mode: "compensate", reason: "已发出,补发说明并人工回访" };
  }
  if (!request.executed) {
    return { mode: "block", reason: "动作尚未执行,先判断是否需要拦截" };
  }
  if (
    model.windowMinutes !== null &&
    request.elapsedMinutes <= model.windowMinutes &&
    request.propagated !== true
  ) {
    return { mode: "undo", reason: "在时间窗内,反向执行动作" };
  }
  return { mode: "compensate", reason: "超出时间窗或已传播,转补偿" };
}

// C 的改价、下架只有在 30 分钟窗口内才可反向执行;
// 发通知不可撤,必须在执行前拦截。
export function preflightRequired(model: UndoModel, action: Action): boolean {
  if (action === "suggestion" || action === "publish") return false;
  if (action === "send-notice") return true;
  if (action === "price-change" || action === "delist") {
    return model.windowMinutes === null;
  }
  return true;
}

export const AUDIT_ERROR_BPS = 170;
export const NON_ROLLBACK_BPS = 1400;

// 1.7% × 14% = 0.238%(不可回滚错误率)
export function irreversibleErrorPercent(): number {
  return (AUDIT_ERROR_BPS * NON_ROLLBACK_BPS) / FULL / 100;
}

// 1 − 14% = 86%(错误中可回滚比例)
export function rollbackShare(): number {
  return (FULL - NON_ROLLBACK_BPS) / FULL;
}

UNDO_MODELS 对应三种撤销对象:A 是建议,B 是版本,C 是动作。decideUndo 先看对象,再看状态:B 未发布可回退,已发布只能补偿;C 的改价在 30 分钟内且未传播可反向执行,超出窗口或已传播则转补偿;发通知无论何时都不可撤,未执行时直接拦截。

preflightRequired 回答的是另一个问题:这个动作在当前产品能力下是否可撤。C 有 30 分钟窗口,改价与下架不需要额外拦截;B 没有动作级窗口,如果它试图改价,就必须在执行前拦截。irreversibleErrorPercent 把 1.7% 与 14% 乘出 0.238%,rollbackShare 把 86% 还原出来,两个数一起看,才知道补偿路径覆盖的是哪一段。

撤销设计的检查清单

  • 先写撤销对象:建议、版本还是动作,三者不能混用。
  • 每个对象写清时间窗:发布前、30 分钟内,还是无窗口。
  • 写清不可撤动作清单,并为每个动作配补偿动作。
  • 检查反向执行的前提:原值、反向接口、下游是否已消费。
  • 不可撤销且没有补偿的动作,必须在执行前拦截。
  • 补偿动作要单列成本,不能摊进日常人工。

小结

  • 撤销不是 Ctrl+Z,而是范围、时间窗、补偿动作三件齐全的承诺。
  • A 的撤销是不采纳,因为建议没有落库,不需要时间窗。
  • B 的撤销是版本回退,发布前不限次数,发布后只能补发更正。
  • C 的撤销是反向执行,窗口是动作后 30 分钟。
  • C 的错误中 86% 可回滚,14% 不可回滚,不可回滚错误率是 0.238%。
  • 改价只有在原值、反向接口、下游未消费三个条件都满足时才真的可撤。
  • 发通知不可撤,必须在发送前拦截;发送后只能补发说明并人工回访。
  • 补偿不是撤销,它承认动作已经发生,成本更高,必须单独预算。

阅读导航:上一节:3.2 运行中纠偏 · 下一节:4.1 什么时候停下来问 。

常见错误与边界

  1. 把撤销当成删除记录。 删除界面记录不会反向执行外部动作,用户以为撤了,价格和库存仍然停在新值。
  2. 不写时间窗。 用户超出窗口后要求撤销,团队只能临时承诺;时间窗必须提前写进界面与协议。
  3. 假设所有动作都能反向执行。 没有原值快照、没有反向接口、下游已缓存新值时,反向执行并不等价于撤销。
  4. 用补偿代替拦截。 发通知不可撤,补偿只能降低影响;正确顺序是先拦截,再补偿。
  5. 把补偿成本摊进平均值。 补偿是低频高成本事件,摊进日常人工会让预算看起来正常,出事时没有资源。
  6. 三种撤销对象共用一个按钮。 建议、版本、动作的撤销语义不同,统一按钮会让用户无法判断后果。

下一节进入审批:撤销处理已经发生的动作,审批处理还没发生的动作;什么时候应该停下来问人,什么情况下停下来问反而有害。

继续阅读

探索更多技术文章

浏览归档,发现更多关于系统设计、工具链和工程实践的内容。

全部文章 返回首页

「books」更多文章

  1. 《大规模分布式计算深入解析》15.3 落地:从 Neo4j 到自研图引擎
  2. 《大规模分布式计算深入解析·图计算与图数据库内核》 · 目录与学习路径(45 篇)
  3. 《大规模分布式计算深入解析》15.2 十一卷主线:从切分到图