《AI Agent 产品开发·组织、平台与规模化》6.2 审计要求的产品化

审计不是日志越多越好,而是每条动作都能回答谁、对什么、从什么改成什么、凭什么。本节给出可查可导可复核可留存的四条标准、一条动作记录的字段清单、按风险分档的留存期,并处理审计与删除权的冲突,用 C Runner 的改价记录做示例,并给出可运行的脱敏与导出模型。

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

上一节把责任画成了地图,但地图只说明「应该谁管」,不能证明「实际发生了什么」。出事后要复盘,靠的是审计记录:当时是谁执行的、对哪个对象、从什么值改成什么值、依据哪条规则、能不能撤回。

很多团队把审计当成工程附带产物:日志系统本来就有,多打几行就行。但 Agent 的审计和普通应用日志不是一回事。普通日志记录「系统发生了什么」,Agent 审计要记录「谁授权它做了什么,以及为什么」。前者用于排障,后者用于定责。

审计的产品标准:可查、可导、可复核、可留存

一条审计能力是否合格,可以用四个标准检查。

标准含义不合格的表现
可查按任务号、时间、对象能定位到那条记录只能按日期翻全量日志
可导能导出成结构化格式,字段含义明确只能截图或看后台页面
可复核能还原动作前后的值、规则与证据只有一句「已执行」
可留存按风险等级保留足够长时间,到期可证明删除所有日志统一保留 7 天

四条标准里,最容易被低估的是「可导」。审计记录留在供应商后台时,看起来什么都有,但导出时只剩一个 PDF 或一张截图,字段含义丢失,换系统后无法对账。可导不是附加功能,而是审计能否被第三方核对的前提。

「可复核」则决定审计能不能用于定责。一条记录如果只有「价格已更新」,没有更新前的值、更新后的值、触发规则和证据引用,复盘时只能相信执行者的一面之词。Agent 不会辩解,但它的日志必须能替它说清楚。

一条动作记录至少要有哪些字段

字段不在多,而在于能独立回答四个问题:谁做的、对什么做的、改成了什么、凭什么。

字段回答的问题备注
任务号这条动作属于哪次任务跨系统对账的主键
发生时间什么时候做的带时区,精确到秒
执行者人还是 Agent,具体是谁不能用「系统」代替
动作类型改价、改库存、下架、发通知与权限面一致
动作对象对哪个 SKU、客户或工单可回指到业务实体
动作前值改之前是什么没有前值就无法复核
动作后值改之后是什么与回滚句柄配对
规则编号依据哪条规则规则变更后可追溯
模型版本哪个版本的 Agent 做的模型升级后能分层分析
证据引用当时看到的快照或数据防止「事后数据变了」
回滚句柄怎么撤回可逆动作必填,不可逆动作留空

十一个字段里,任务号、前值、后值、规则编号是最低要求。少了任务号,记录无法与业务对上;少了前后值,无法判断改了什么;少了规则编号,无法解释为什么这么改。

回滚句柄要按动作类型区分。可逆动作必须填,因为它是撤回的入口;不可逆动作允许留空,但要在记录里标出「不可逆」,并关联补偿方案。把不可逆动作也强行要求回滚句柄,只会逼团队填一个假值。

留存期按风险分档

留存期不是一个数字,而是按动作风险分档的建议口径。下面的天数是产品政策示例,不是案例设定值;它要表达的是分档逻辑,而不是某个行业标准。

风险档典型动作建议留存理由
只读检查、比对、生成建议30 天用于排障与质量分析,不涉及权益变更
可逆写入改价、改库存、下架180 天覆盖回滚窗口、季度复盘与客户申诉
不可逆写入已发出的客户通知365 天无法撤回,需要更长窗口处理补偿与争议

分档的依据是「错误被发现的时间」。只读动作的错误通常在当天或当周被发现,30 天足够覆盖排障;可逆写入的错误可能在季度复盘时才暴露,180 天能覆盖一个完整的业务周期;不可逆写入的错误可能引发客户投诉或监管问询,365 天是最低的安全垫。

统一保留 7 天或统一保留 3 年都不对。前者会让可逆动作在回滚窗口之外就失去证据,后者会让只读数据无限堆积,增加删除权和存储成本。留存期要跟风险走,而不是跟日志系统走。

审计与删除权的冲突

审计要求「留下来」,删除权要求「删掉」,两者会在同一个记录上相遇。正确的处理不是二选一,而是分层:删除可识别个人的字段,保留行为链。

具体做法是:执行者标识替换成稳定的匿名 ID,证据引用里的个人信息做脱敏,动作、对象、前后值、规则编号和时间戳保持不变。这样既能满足个人删除请求,又能让审计继续回答「发生了什么」。

关键在于「稳定」二字。匿名 ID 必须是确定性的:同一个主体每次替换成同一个 ID,否则审计无法把同一人的多次动作关联起来;同时 ID 不能反推出原始身份,否则删除只是换了个名字。行为链保留的是「有人做了这个动作」,不是「谁做了这个动作」。

这条分层规则要在产品里写死,不能靠人工判断。删除请求进来时,系统自动脱敏可识别字段,保留责任链字段,并记录「本次删除脱敏了哪些字段、保留了哪些字段」。删除本身也要可审计,否则删除权会变成销毁证据的通道。

C Runner 的改价记录

C Runner 是执行档,改价是它最典型的可逆动作。一条合格的改价记录长这样:

字段值
任务号c-task-0001
发生时间2026-11-06T09:00:00+08:00
执行者runner-agent
动作类型price-update
动作对象sku-0001
动作前值1990
动作后值1790
规则编号price-floor-rule
模型版本runner-2026-10
证据引用snapshot-0001
回滚句柄rb-0001

这条记录能回答四个问题:谁做的、对什么做的、从 1990 改成 1790、依据价格底线规则。回滚句柄让它在 30 分钟窗口内可以反向执行;证据引用让复盘时能看到当时的快照,而不是被后续数据覆盖。

C 的动作里 86% 可回滚,14% 是已发出的客户通知。前一类有回滚句柄,后一类没有,只能补偿。审计记录必须能区分这两类,否则会把「不可逆」误当成「可撤回」。C 的不可回滚错误率是 0.238%,这个数字来自 1.7% 的审计错误率乘以 14% 的不可逆比例。

C 的审计不是全量人工复核,而是 8% 抽检、单次 12 分钟,摊销 0.96 分钟/任务。加上 22% 转人工、每次 14 分钟的 3.08 分钟,C 的实际人工是 4.04 分钟/任务。审计的成本必须算进这套账,否则「自动执行」会显得比实际便宜。

把审计要求写成可运行模型

审计字段和留存规则如果只写在制度里,落地时会出现两种偏差:字段缺了没人发现,留存期到了还在。下面这个模型把字段完整性、风险分档、到期时间和删除脱敏写成可检查的函数。

// file: src/scale/06-2-audit-requirements.ts
// tier: L2
// verify: node --test test/scale/06-2-audit-requirements.test.ts

// 审计要求的产品化:可查、可导、可复核、可留存。
// 审计不是日志越多越好,而是每条动作都能回答「谁、对什么、从什么改成什么、凭什么」。

export type AuditField =
  | "taskId"
  | "occurredAt"
  | "actor"
  | "action"
  | "target"
  | "beforeValue"
  | "afterValue"
  | "ruleId"
  | "modelVersion"
  | "evidenceRef"
  | "rollbackHandle";

export const FIELD_ORDER: readonly AuditField[] = [
  "taskId",
  "occurredAt",
  "actor",
  "action",
  "target",
  "beforeValue",
  "afterValue",
  "ruleId",
  "modelVersion",
  "evidenceRef",
  "rollbackHandle",
];

export const FIELD_LABEL: Record<AuditField, string> = {
  taskId: "任务号",
  occurredAt: "发生时间",
  actor: "执行者(人或 Agent)",
  action: "动作类型",
  target: "动作对象",
  beforeValue: "动作前值",
  afterValue: "动作后值",
  ruleId: "规则编号",
  modelVersion: "模型版本",
  evidenceRef: "证据引用",
  rollbackHandle: "回滚句柄",
};

export type AuditRecord = Record<AuditField, string>;

export function missingFields(record: Partial<AuditRecord>): readonly AuditField[] {
  const missing = FIELD_ORDER.filter((field) => {
    // 回滚句柄按动作类型判定:可逆动作必填,不可逆动作允许留空。
    if (field === "rollbackHandle") return false;
    const value = record[field];
    return value === undefined || value.trim().length === 0;
  });
  if (record.action && tierForAction(record.action) === "reversible-write") {
    const handle = record.rollbackHandle;
    if (handle === undefined || handle.trim().length === 0) {
      missing.push("rollbackHandle");
    }
  }
  return missing;
}

export function isAuditable(record: Partial<AuditRecord>): boolean {
  return missingFields(record).length === 0;
}

export type RiskTier = "read-only" | "reversible-write" | "irreversible-write";

// 留存期是建议口径(示例),不是案例设定值;按风险分档,而不是一刀切。
export const RETENTION_DAYS: Record<RiskTier, number> = {
  "read-only": 30,
  "reversible-write": 180,
  "irreversible-write": 365,
};

export function retentionDays(tier: RiskTier): number {
  return RETENTION_DAYS[tier];
}

export function expiresAt(occurredAt: string, tier: RiskTier): string {
  const start = new Date(occurredAt).getTime();
  const end = start + RETENTION_DAYS[tier] * 24 * 60 * 60 * 1000;
  return new Date(end).toISOString();
}

export function tierForAction(action: string): RiskTier {
  if (action === "read-check") return "read-only";
  if (action === "notice-send") return "irreversible-write";
  return "reversible-write";
}

// 删除权与审计的冲突:删除可识别个人的字段,保留行为链。
// 动作、对象、前后值、规则与时间戳是责任链,不随个人删除请求消失。
export const REDACTABLE_FIELDS: readonly AuditField[] = ["actor", "evidenceRef"];

export type DeletionRequest = {
  readonly subjectId: string;
  readonly reason: "user-request" | "regulation";
};

export type Redaction = {
  readonly record: AuditRecord;
  readonly redacted: readonly AuditField[];
  readonly retained: readonly AuditField[];
  readonly note: string;
};

export function pseudonymize(subjectId: string): string {
  let hash = 0;
  for (const ch of subjectId) {
    const code = ch.codePointAt(0) ?? 0;
    hash = (hash * 31 + code) >>> 0;
  }
  return `anon-${hash.toString(16).padStart(8, "0")}`;
}

export function applyDeletion(
  record: AuditRecord,
  request: DeletionRequest,
): Redaction {
  const next: AuditRecord = { ...record };
  const redacted: AuditField[] = [];
  for (const field of REDACTABLE_FIELDS) {
    if (next[field].trim().length === 0) continue;
    next[field] = field === "actor" ? pseudonymize(request.subjectId) : "[redacted]";
    redacted.push(field);
  }
  const retained = FIELD_ORDER.filter((field) => !redacted.includes(field));
  return {
    record: next,
    redacted,
    retained,
    note: "保留行为链,删除可识别个人的字段;审计可复核,个人不可回指。",
  };
}

export function accountabilityIntact(
  original: AuditRecord,
  redaction: Redaction,
): boolean {
  const chain: readonly AuditField[] = [
    "taskId",
    "occurredAt",
    "action",
    "target",
    "beforeValue",
    "afterValue",
    "ruleId",
  ];
  return chain.every((field) => original[field] === redaction.record[field]);
}

export function exportHeader(fields: readonly AuditField[] = FIELD_ORDER): string {
  return fields.map((field) => FIELD_LABEL[field]).join("\t");
}

export function exportRow(
  record: AuditRecord,
  fields: readonly AuditField[] = FIELD_ORDER,
): string {
  return fields.map((field) => record[field]).join("\t");
}

// C Runner 的改价记录:示例记录,字段口径来自审计要求,不是案例设定值。
export const C_PRICE_CHANGE: AuditRecord = {
  taskId: "c-task-0001",
  occurredAt: "2026-11-06T09:00:00+08:00",
  actor: "runner-agent",
  action: "price-update",
  target: "sku-0001",
  beforeValue: "1990",
  afterValue: "1790",
  ruleId: "price-floor-rule",
  modelVersion: "runner-2026-10",
  evidenceRef: "snapshot-0001",
  rollbackHandle: "rb-0001",
};

// 已发出的客户通知没有回滚句柄,留存期按不可逆动作处理。
export const C_SENT_NOTICE: AuditRecord = {
  taskId: "c-task-0002",
  occurredAt: "2026-11-06T09:05:00+08:00",
  actor: "runner-agent",
  action: "notice-send",
  target: "customer-0001",
  beforeValue: "no-notice",
  afterValue: "notice-sent",
  ruleId: "price-drop-notice",
  modelVersion: "runner-2026-10",
  evidenceRef: "snapshot-0002",
  rollbackHandle: "",
};

missingFields 检查十一个字段是否齐全,但对回滚句柄做了例外:可逆写入必须填,不可逆写入允许留空。这个例外不是放松要求,而是让「不可逆」成为一个显式状态,而不是一个被忽略的缺失值。

RETENTION_DAYS 与 tierForAction 把动作映射到风险档:只读 30 天、可逆写入 180 天、不可逆写入 365 天。expiresAt 用发生时间加留存天数,给出到期时间,便于批量清理和到期提醒。

applyDeletion 处理删除权与审计的冲突:执行者和证据引用被脱敏,任务号、动作、对象、前后值、规则编号保留。accountabilityIntact 则验证脱敏之后责任链没有被改动。exportHeader 与 exportRow 把记录导出成制表符分隔的行,字段含义由表头给出,换系统后仍能对上账。

审计设计的三个边界

第一,审计不是全量记录所有东西。记录字段要围绕「能不能定责」设计,而不是围绕「以后可能有用」。字段越多,脱敏和留存成本越高,真正关键的字段反而容易被淹没。

第二,审计不能只服务事后。抽检比例、错误率、回滚成功率都从审计记录里来,它同时是运营指标的数据源。C 的 8% 抽检和 1.7% 错误率,如果没有结构化记录,根本算不出来。

第三,审计要能离开供应商。记录留在对方后台时,你只有查看权,没有控制权。导出格式、字段含义、移交期限都要在合同里写清楚,这也是 5.3 把审计日志移交列为退出五件事之一的原因。

小结

  • 审计的产品标准是四条:可查、可导、可复核、可留存。
  • 一条动作记录至少包含任务号、时间、执行者、动作、对象、前后值、规则、模型版本、证据与回滚句柄。
  • 回滚句柄按动作类型区分:可逆写入必填,不可逆写入允许留空并标记补偿方案。
  • 留存期按风险分档:只读 30 天、可逆写入 180 天、不可逆写入 365 天,这是政策示例而非案例值。
  • 审计与删除权的冲突用分层处理:删除可识别字段,保留行为链,匿名 ID 必须稳定且不可反推。
  • C Runner 的改价记录能还原谁、对什么、从 1990 改成 1790、依据哪条规则、怎么撤回。
  • C 的 86% 动作可回滚、14% 不可逆,不可回滚错误率 0.238%,审计摊销 0.96 分钟/任务。

阅读导航:上一节:6.1 责任地图:出事了谁来担 · 下一节:6.3 什么时候必须告诉用户「这是 AI」 。

常见错误与边界

  1. 把审计当成普通日志。 普通日志记录系统发生了什么,Agent 审计要记录谁授权它做了什么、依据是什么。
  2. 只记录「已执行」。 没有前后值、规则编号和证据引用,复盘时无法判断对错,也无法回滚。
  3. 所有动作统一留存期。 只读、可逆写入、不可逆写入的风险不同,统一 7 天或统一 3 年都会出问题。
  4. 删除请求直接删整条记录。 删除可识别字段、保留行为链,否则删除权会变成销毁证据的通道。
  5. 匿名 ID 每次不同。 不稳定就无法关联同一主体的多次动作,审计会失去连续性。
  6. 审计日志留在供应商后台。 没有结构化导出和移交条款,换系统时对不上账,退出能力也被卡住。

这一节把审计从「多打几行日志」拆成了字段、留存、删除和导出。下一节回答另一个合规问题:什么时候必须主动告诉用户,他面对的是 AI。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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