把 Checker 从「拦截」改造为「助力」:判不通过给建议、报错不卡人、原因说人话。左右对照 = 改造前 / 改造后。
现状 checker 只说"哪不对",不说"怎么改"。改造后,三段式模板系统固定输出新增 suggested_edit 字段,专家在判不通过卡片里直接看到可执行的修改指引。
报错(error)≠ 判不通过(fail)。fail 是业务判断,该拦;error 是系统没跑出结果,不能让系统故障变成专家的死路。改造后所有模板复用同一个「报错卡」组件:分级文案 + 备注 + 继续提交,该题带「报错放行」标记进人工质检。
每条透传文案必须回答:①发生了什么(说人话) ②是谁的问题 ③专家现在能做什么。永远给下一步,绝不出现没有渠道的「请联系管理员」。下面是四个典型场景,改造前全部显示同一句「请稍后重试或联系管理员」。
现状:模型回复(答题环节)报错一律显示「模型请求失败视为答题错误,无需重试」——把平台故障也记成了模型答错。统一定义四类处置,现状文案只保留给 B 类。
基于全平台报错编目(7/13 全量 + 8/19 周度)。匹配只认主错误头(去重试 history / traceback);映射表配置化,admin 可维护;未命中吃兜底,每周编目回收。
| # | 原始报错特征(pattern) | 类别 | 专家看到的文案 | 专家动作 | 平台动作 |
|---|---|---|---|---|---|
| 1 | exceeds the supported page limit | 文件超页数 | 您上传的文件共 N 页,超过系统可处理上限(1000 页),请拆分或压缩后重新上传。 | 改文件 | 提交前置校验直接拦 |
| 2 | ContextWindowExceededError / input token 超限 | 输入过长 | 题目与文件内容合计超过模型可处理长度,请精简题面或压缩文件后重试。 | 改题面 | 前置 token 估算提示 |
| 3 | usage policy / inappropriate content | 内容被拒 | 内容被模型安全策略拒绝,请检查题面/文件是否含敏感内容并修改;确认无误可备注说明后继续。 | 改题或备注 | 误伤率监控 |
| 4 | 429 / rate limit / 529 | 限流 | 系统繁忙,请约 1 分钟后点击重试。 | 稍后重试 | 自动退避重试 |
| 5 | timed out / heartbeat(checker 场景) | 检测超时 | 检测超时,可能因文件较大。请重试一次;仍失败可备注说明后继续提交。 | 重试→备注 | 长文项目放宽阈值 |
| 6 | Cannot fetch content from the provided url | 附件读取失败 | 附件读取失败(平台侧问题),已自动上报。请稍后重试一次;仍失败可备注继续。 | 重试→备注 | 报研发(OSS 链路) |
| 7 | The document has no pages. | 文件转换失败 | 文件解析结果为空(平台侧问题),已自动上报;您可备注说明后继续。 | 备注继续 | 报研发(转换链路) |
| 8 | mimetype parameter / invalid_file | 格式处理异常 | 文件格式处理异常(平台侧问题),已自动上报;您可备注说明后继续。 | 备注继续 | 报研发(传参 bug) |
| 9 | 上游 5xx / 代理 500 / 空响应 | AI 服务故障 | AI 服务临时故障,已自动上报。请稍后重试;连续失败可备注继续。 | 重试→备注 | 报研发 |
| 10 | may not exist or you may not have access / 401 / Insufficient credits | 配置/账号异常 | 平台服务配置异常,已自动上报,无需您处理;可备注说明后继续提交。 | 备注继续 | 报研发 · P0 告警(不自愈) |
| 11 | runtime_bootstrap_failed / agent_crashed | 评测环境异常 | 评测环境异常(平台侧问题),已自动上报;您可备注继续。 | 备注继续 | 报研发 |
| 12 | 其余未识别 | 兜底 | 检测服务出现异常,已自动上报。您可重试一次,或备注说明后继续提交。 | 重试或备注 | 每周编目回收进映射表 |
三段式模板的输出契约现为系统固定 status + reason。改造 = 在「Output 配置」块新增「输出修改建议」开关(下图红点标注),开启后系统在 Output 约束中追加 suggested_edit 要求。legacy 模板"有则显示",不强制改造。