系列目录 · 第 05 篇
有一类错误很容易误判成“模型不会调用工具”:
1 | save_threat_model {} |
这个回执能确认的是:工具校验层收到的参数没有必填版本号。仅凭它,还不能确定参数在哪一层丢失,也不能确定所有类似错误具有同一个根因。
0x01 一次保存经过了哪些环节
保存威胁模型并不是把一段模型文字直接写入数据库。实际链路至少包含:
1 | 工具定义与 required 字段 |
报错发生在哪一层,决定了该查哪里。缺少 expected_revision 属于输入契约错误;证据引用不存在,属于业务校验错误;connect: connection refused 则是在连接模型服务时就失败。这三类故障不应该都显示成一个笼统的“模型错误”。
0x02 为什么不能删掉 expected_revision
这个字段负责并发版本比较。假设 Planner 读到模型版本 7,操作员随后补了一条信任边界,数据库已到版本 8。Planner 再提交基于版本 7 的整份模型,直接覆盖会把人工修改抹掉。
正确行为是拒绝旧版本提交,重新读取上下文后再合并。把必填字段去掉,或者由宿主一律补成当前版本,会掩盖冲突,让一次看似成功的保存变成数据丢失。
调用前应先读取 get_audit_context,使用其实际版本。支持文件提交的版本,可以在任务目录写好完整模型,再提交以下结构的参数:
1 | { |
这里是参数结构说明,尖括号需要替换。具体字段仍以当前部署实例暴露的工具 schema 为准,不能把旧版本样例直接当成接口规范。
0x03 修了什么
当时排查发现,大参数保存还会受到流式参数组装和回执体积的影响。围绕这条链路做了几件事:
| 位置 | 改造 |
|---|---|
| 参数接收 | 累积参数分片,处理文本、用量事件与参数事件交错 |
| 解码失败 | 保留参数长度、摘要和截断诊断,拒绝执行保存 |
| 工具定义 | 保留 required、数组结构和版本比较约束 |
| 大模型提交 | 支持任务目录内的 model_path,限制路径边界与 4 MiB 大小 |
| 业务校验 | 把缺失引用、非法状态定位到具体字段 |
| 工具返回 | 返回版本、摘要及有限缺口,避免整份模型再次灌回上下文 |
小回执解决的是下一轮上下文膨胀,文件提交解决的是超长参数传输。两者都不能替代模型结构和证据校验。
当次历史快照统计过 43 次保存调用,其中 27 次是空对象。这是排查时点的统计,不是永久累计值,也不能据此把每一次空对象都归因于截断。
0x04 后续复查没有支持“已经彻底解决”
复查时,仍观察到字面两字节 {} 到达工具层,并在执行保存前被 schema 拦下。说明早期补丁覆盖了可复现的组装问题,但没有消灭所有空参数来源。
要继续定位,需要关联同一请求的工具定义、原始请求、原始响应、分片事件和最终解码参数。当时缺少能够一一对应的完整原始报文,因此不能断言是模型直接生成了空对象、协议转换丢了内容,还是后续累积过程出错。
并发运行两个任务也只提供了排查线索,不能单凭时间相关性认定“并发把参数串了”。
0x05 这一轮留下的工程规则
保存失败必须保留失败,不伪造成功回执;版本冲突必须重读,不静默覆盖;日志可以帮助定位参数状态,但不应默认复制整份源码、模型正文或凭据。
本轮验收覆盖了针对性的 Go 测试、工具 schema、流式分片和大模型保存路径。它证明这些受控输入按预期处理,没有证明所有供应商、模型模板和代理转换路径都正常。
工具注册与参数解码实现,以及后续空参数排查记录。遇到同类错误,先保存请求关联标识和发生层次,再决定重试或修复哪一段链路。
