结构化输出(Structured Output)
结构化输出(Structured Output) 是让模型返回符合约定结构的数据,便于程序读取和验证。它解决格式契约问题;字段内容仍可能错误,业务权限仍需单独检查。
格式约束有不同层次
| 方式 | 约束目标 | 不能据此推断 |
|---|---|---|
| 提示词要求 JSON | 通过指令要求格式 | 每次都会生成可解析 JSON |
| JSON Mode | 合法 JSON,具体取决于提供商实现 | 字段必然符合指定 schema |
| Schema 约束输出 | 受支持 schema 下的字段和类型 | 数值真实、来源可信、操作有权限 |
| 严格工具参数 | 工具调用参数符合约束 | 工具调用一定成功 |
JSON Schema描述数据结构;复杂的语义关系可能还需要业务代码验证。
不要忽略结束状态
模型支持范围、schema 子集与失败方式应查对应版本文档。例如,Claude 结构化输出文档说明,拒绝或达到 token 上限时,结果可能不符合 schema。因此应先检查完成状态,再解析和校验,不能只判断 HTTP 请求成功。
工程建议:允许“不知道”
抽取发票时,可将结果约定为 invoice_number、currency、total 和 source_page。缺失字段允许 null,缺少证据时返回未完成状态,避免为了填满必填字段编造内容。
解析后继续验证金额范围、币种、字段间关系与证据位置;写入数据库前检查用户权限。保留输入与 schema 版本,记录校验失败原因,对可恢复错误做有次数上限的重试。