以下人物、公司与数字均为教学假设,不构成对任何真实产品的评价。
上一节把责任画成了地图,但地图只说明「应该谁管」,不能证明「实际发生了什么」。出事后要复盘,靠的是审计记录:当时是谁执行的、对哪个对象、从什么值改成什么值、依据哪条规则、能不能撤回。
很多团队把审计当成工程附带产物:日志系统本来就有,多打几行就行。但 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」 。
常见错误与边界
- 把审计当成普通日志。 普通日志记录系统发生了什么,Agent 审计要记录谁授权它做了什么、依据是什么。
- 只记录「已执行」。 没有前后值、规则编号和证据引用,复盘时无法判断对错,也无法回滚。
- 所有动作统一留存期。 只读、可逆写入、不可逆写入的风险不同,统一 7 天或统一 3 年都会出问题。
- 删除请求直接删整条记录。 删除可识别字段、保留行为链,否则删除权会变成销毁证据的通道。
- 匿名 ID 每次不同。 不稳定就无法关联同一主体的多次动作,审计会失去连续性。
- 审计日志留在供应商后台。 没有结构化导出和移交条款,换系统时对不上账,退出能力也被卡住。
这一节把审计从「多打几行日志」拆成了字段、留存、删除和导出。下一节回答另一个合规问题:什么时候必须主动告诉用户,他面对的是 AI。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。