营运与维护 · 实作指南
记录决策过程,不要复制客户整份资料
用较少敏感内容,建立足以解释 AI 工作流故障的诊断事件。

文字更多,未必更容易诊断
假设支援团队为了解发票错误,把所有提示和回应写进日志。结果里面充满银行资料、姓名与重复文件,却仍看不出哪条规则拒绝请求。建议先列出诊断问题:哪个步骤失败、涉及哪笔纪录、负责人下一步可以做什麽。再收集能回答问题的栏位,而不是默认保存整段对话。日志本身也是需要管理的资料产品,不是免费而无风险的暂存区。
建立共同事件词汇
可定义撷取被拒、批准到期、连接器不可用、外部写入已确认等事件,附请求编号、公司参考、阶段、耗时、模型设定版本与安全原因码。事件结构保持稳定,换提供方时就不必重写整份维运报告。OWASP 日志指引提供背景,这套词汇则是本文建议。错误原因要能引导处理,例如缺必要栏位,而不是只写模型失败,令一线人员无从判断。
流程一览
把例外内容检查分开管理
有时诊断确实需要样本,但应是另行授权的程序,具遮蔽处理、有限存取、到期日与使用理由。一般事件不放权杖、签署下载连结或密码。也要测试错误处理器是否意外印出请求标头或原文件。多人可看的维运仪表板,不能悄悄变成另一个客户文件库。资料保留期限应与目的相符,当例外调查结束後,也要有人负责处理留下的副本。
同时衡量可用性与暴露量
试点时让未参与开发的人,仅凭事件轨迹处理几宗虚构故障,记录判断耗时和需要原始内容的次数。资料不足时,先改善原因码,再考虑扩大撷取。保留与存取仍须按客户情况决定。少记录不是把责任证据全删掉;应减少不必要内容,同时保留操作、批准和结果之间的关系。能解释又不过量收集,才是较可靠的诊断安排。
演练谁可查看日志
请一般支援使用者诊断一宗虚构撷取失败,确认不能阅读密钥或其他公司的事件;再让获授权调查者取得有限期样本。这能测试维运便利是否意外造出大范围资料视窗。也要检查汇出日志後的保存方式,因为平台内权限正确,不代表下载到桌面的副本仍受控。交付训练需要说明哪些情况可汇出、谁批准以及何时清理。
来源与延伸阅读
- Logging Cheat SheetLogging Cheat SheetOWASP · 官方文件 ·
编辑原则
本系列以 AI 辅助原创撰写,并对照连结的公开来源。实作建议与假设情境属编辑分析,并非客户实绩。来源发布日期及产品细节可能与本系列整理日期不同。