工程 · 深度词条

Structured Outputs(结构化输出)

让模型按约定字段和类型交付结果,方便程序继续处理。

专题词条基础释义核对 2026-10-20专题核对 2026-10-20增补 2026-11-192 条来源
本页目录 12 节

四层解释

通俗

让模型按约定字段和类型交付结果,方便程序继续处理。

专业

支持该能力的接口可按指定 JSON Schema 约束输出结构;具体模型、模式与支持的 Schema 子集以平台文档为准。

机制

应用声明字段与约束,服务生成符合支持范围的结构,调用方再处理拒绝、截断、解析失败及业务校验。

工程

把结构校验和事实校验分开。字段存在不代表值正确,合法 JSON 也不代表可以直接写入业务数据库。

全链路位置

INPUT任务、数据与 Schema
→
PROCESS受约束生成与业务验证
→
OUTPUT可解析且通过检查的对象

常见用途

  • 信息抽取
  • 分类与路由
  • 表单草稿生成

专业边界

  • 不保证事实正确
  • 拒绝与不完整响应必须单独处理

常见误解

  • 以为 JSON Mode 等于完整 Schema 约束
  • 以为通过 Schema 就通过业务验收

格式正确的错账

虚构示例

店员交来一张报销单,日期、币种、金额都填在指定格里。财务仍把它退了回去:金额格里是一个合规的数字,却把小票上的 18 抄成了 81。

自拟教学说明

Structured Outputs(结构化输出)约束字段和类型,使程序更容易读取答案。格式校验可以拒绝金额格里的文字,却不能只凭一个数字判断它是否来自那张小票;核对原件是另一件事。

格式正确与内容正确是两关

OpenAI 文档明确指出结构化输出仍可能包含错误。比如金额字段是数字,能通过类型检查,但币种、税额或来源仍可能不对;这些需要业务规则或原始记录验证。

依据Structured model outputs

把失败也放进接口设计

应用应检查拒绝和输出未完成状态,不把部分结果当作完整对象。对不适用的输入,Schema 与任务说明需要约定空值或明确的不可处理状态,避免强迫模型编造必填字段。

依据Structured model outputs

Worked Example

抽取一张报销单

虚构教学示例,不对应真实客户或运行指标。

  1. 定义结构

    输出金额、币种、日期和原文证据,不清楚的值允许为 null。

  2. 独立核验

    程序校验日期与金额范围,并把抽取值对应回原始单据。

  3. 进入人工确认

    低质量图片或金额冲突进入待核验,不能自动打款。

机器可读只是接口起点,事实与权限仍需另一层检查。

来源与核对记录

S1
Structured model outputsOpenAI · 官方技术文档 · 查阅 2026-10-20
S2
Function Calling GuideOpenAI · 官方技术文档 · 查阅 2026-09-07

基础释义核对:2026-10-20。专题核对:2026-10-20。局部增补:2026-11-19。局部修订不代表旧正文全部复核,尚未完成外部专家审稿。