营运与维护 · 实作指南
别让 AI 根据报错语气决定下一步
以稳定问题类别和已审核规则处理错误,让 AI 解释结果,保留未知情况的人工作业入口。
AAHouse 原创解说视频,采用 AI 辅助概念画面、合成旁白及原创音乐。
英文逐字稿 · 简体中文普通话逐字稿 · 台湾华语逐字稿 · 澳门粤语逐字稿
一条报错,为什么有两条处理路线?
假设一家美国展会服务公司的 AI 助手提交工作单后收到错误。工作人员看到一句自然语言说明,自动化程序却需要判断该补资料、找负责人,还是等待恢复。这是虚构分诊练习,不是实际事故。若系统只看“失败”两个字,或让模型凭语气猜下一步,流畅解释就可能掩盖错误动作。

- 人员:理解发生什么
- 程序:选择已审核路线
- 模型:解释,不自行授权
未经修改的原始来源说明图。
给机器稳定标识,给人清楚解释
RFC 9457 为 HTTP 接口提供问题详情格式,其中 type 标识问题类别,detail 解释本次发生的情况;规范不建议程序解析 detail 来取决策信息。[1] 我们建议将稳定类别送入已审核的处理规则,让 AI 用易懂语言解释结果,而不是把可变文案当作控制开关。

- type → 问题类别
- detail → 本次解释
- 可变文案 ≠ 控制开关
未经修改的原始来源说明图。
供应商格式不同,不要硬套一个字段
Microsoft Graph 使用自己的 error 对象:code 可供程序判断,message 是开发者说明,内容可能变化,不应作为代码依赖或直接展示给用户。[2] 这不等于所有服务都遵循同一结构。先按各接口文档建立适配,再把已识别类别交给业务流程;未知类别进入人工核对。

- 先读供应商文档
- 识别稳定代码
- 未知类别 → 人工核对
未经修改的原始来源说明图。
同一句“无法完成”,不等于同一个动作
练习中可以把“缺少工作单日期”送回资料补充,把“权限不足”交给授权负责人。它们是我们建议的业务映射,不是状态码自动授予的权利。AI 不能因为读到权限错误就提升权限,也不能把所有错误都变成重试。保留原始响应的必要证据,再说明已确认和仍未知的部分。

- 缺日期 → 补资料
- 缺权限 → 找负责人
- 失败 ≠ 自动重试
未经修改的原始来源说明图。
解释要有帮助,但不搬出内部细节
我们建议面向客户的提示写清下一步,例如“请补充活动日期,再重新提交”。内部异常堆栈、令牌和私人内容不应被顺手贴进提示。RFC 9457 提醒设计者注意错误信息暴露实现细节的风险。[1] 有用的解释应帮助恢复工作,而不是把调试输出全部交给用户。

- 说明恢复步骤
- 移除秘密与私人内容
- 内部调试信息另行保护
未经修改的原始来源说明图。
验收时故意换一句话
准备虚构错误样本:保持稳定代码不变,只改英文措辞或换成中文,处理路线应保持一致;再加入未知代码,确认不会自动执行危险动作。记录匹配规则、解释文字和人工入口。这是建议的验收实验,未在客户系统运行。真正的目标是可解释的分诊,而不是让每次报错听起来更自信。

- 代码相同,换措辞
- 处理路线应相同
- 未知代码,不执行危险动作
未经修改的原始来源说明图。