Data Contracts
结构化输出与数据契约
当结果要进入下一道程序，格式必须从“看起来像”变成可验证契约。
The Question
为什么模型输出了 JSON，程序仍可能不能用？
Must Know
必须掌握
- 语法正确不等于字段语义正确。
- 模式应定义类型、必填、枚举和缺失值。
- 模型负责提议，验证器负责拒绝不合格数据。
Know Enough
应当了解
- JSON Schema
- 幂等、唯一键与版本号
- 重试和错误回传
Put It to Work
落实到工作
- 01
先写一个最小模式。
- 02
准备缺字段、错类型和多余字段测试。
- 03
保留原始输出与验证结果。
Common Mistakes
不要这样理解
- 用空字符串掩盖缺失
- 让模型自行发明枚举值
- 验证失败后静默修补
Primary Sources