工程 · 深度词条
Structured Outputs(结构化输出)
让模型按约定字段和类型交付结果,方便程序继续处理。
四层解释
通俗
让模型按约定字段和类型交付结果,方便程序继续处理。
专业
支持该能力的接口可按指定 JSON Schema 约束输出结构;具体模型、模式与支持的 Schema 子集以平台文档为准。
机制
应用声明字段与约束,服务生成符合支持范围的结构,调用方再处理拒绝、截断、解析失败及业务校验。
工程
把结构校验和事实校验分开。字段存在不代表值正确,合法 JSON 也不代表可以直接写入业务数据库。
全链路位置
INPUT任务、数据与 Schema
→PROCESS受约束生成与业务验证
→OUTPUT可解析且通过检查的对象
常见用途
- 信息抽取
- 分类与路由
- 表单草稿生成
专业边界
- 不保证事实正确
- 拒绝与不完整响应必须单独处理
常见误解
- 以为 JSON Mode 等于完整 Schema 约束
- 以为通过 Schema 就通过业务验收
格式正确的错账
虚构示例
店员交来一张报销单,日期、币种、金额都填在指定格里。财务仍把它退了回去:金额格里是一个合规的数字,却把小票上的 18 抄成了 81。
自拟教学说明
Structured Outputs(结构化输出)约束字段和类型,使程序更容易读取答案。格式校验可以拒绝金额格里的文字,却不能只凭一个数字判断它是否来自那张小票;核对原件是另一件事。
格式正确与内容正确是两关
OpenAI 文档明确指出结构化输出仍可能包含错误。比如金额字段是数字,能通过类型检查,但币种、税额或来源仍可能不对;这些需要业务规则或原始记录验证。
把失败也放进接口设计
应用应检查拒绝和输出未完成状态,不把部分结果当作完整对象。对不适用的输入,Schema 与任务说明需要约定空值或明确的不可处理状态,避免强迫模型编造必填字段。
Worked Example
抽取一张报销单
虚构教学示例,不对应真实客户或运行指标。
- 定义结构
输出金额、币种、日期和原文证据,不清楚的值允许为 null。
- 独立核验
程序校验日期与金额范围,并把抽取值对应回原始单据。
- 进入人工确认
低质量图片或金额冲突进入待核验,不能自动打款。
机器可读只是接口起点,事实与权限仍需另一层检查。
来源与核对记录
S1Structured model outputsOpenAI · 官方技术文档 · 查阅 2026-10-20
↗S2Function Calling GuideOpenAI · 官方技术文档 · 查阅 2026-09-07
↗基础释义核对:2026-10-20。专题核对:2026-10-20。局部增补:2026-11-19。局部修订不代表旧正文全部复核,尚未完成外部专家审稿。