结构化输出

它是什么

结构化输出是让模型按照预先定义的字段、类型和层级返回结果，使应用能够稳定解析。常见形式包括 JSON 对象、枚举标签和固定字段集合。JSON Schema 是描述 JSON 数据结构与约束的声明式语言；部分模型 API 能在生成阶段接收其支持的 Schema 子集。[S1][S2]

为什么需要它

自然语言回答适合阅读，却不一定适合直接进入数据库、界面或下一步自动化。字段名称变化、漏项或类型错误都会让集成失败。结构化输出把“结果长什么样”变成机器可检查的协议，让团队能在使用数据前先判断结构是否合格。

它如何工作

应用定义字段、数据类型、必填项和允许值，再通过模型 API 的结构化输出配置提交 Schema。支持该能力的服务会约束生成结果匹配所支持的数据形状；应用收到结果后仍要解析并执行 Schema 校验、业务规则检查与错误处理。[S1][S2] 供应商通常只支持 JSON Schema 的一部分，字段和限制必须查阅具体版本。

必须澄清的误会

结构化输出 ≠ 函数调用。 函数调用是让模型提出「要调用什么、参数是什么」；结构化输出是让模型的回答本身就是一段结构化数据，前者是请求后者是结果。

结构化输出 ≠ 提示约束。 提示约束在文字层面说清要求；结构化输出常配合模式校验或约束解码在工程上强制，强度不同。

真实例子

工单助手可以返回 category、urgency、evidence 和 needsHumanReview 四个字段，并限制类别与紧急程度只能取规定枚举。即使结果通过 Schema，模型仍可能把普通咨询误判为紧急事件，或引用不存在的证据；应用需要根据原工单复核字段值，再决定是否触发流程。

什么时候适合与不适合

结构化输出适合数据提取、分类、界面渲染和自动化交接。开放式写作若被过度约束，可能失去必要表达空间；过深或过大的 Schema 也可能不被服务支持。[S1] 最重要的边界是：语法与字段合规不等于事实正确、业务有效或操作安全，关键动作仍需确定性校验和授权。

亲自试一下

为“从会议记录提取行动项”定义负责人、任务、截止日期和证据原句四个字段。分别设计字段类型、必填项和枚举，再准备一个日期缺失和一个负责人含糊的输入。验收时分开记录三层结果：JSON 能否解析、Schema 是否通过、字段值能否由原文支持。

接下来学什么

先用提示词模板稳定组织输入，再比较函数调用理解“返回最终结构”和“请求外部动作”的区别；最后结合AI 评估检查字段值的真实业务质量。

来源与修订

Schema 约束生成、受支持子集和语义校验边界参考 Google Structured Outputs 文档 [S1]；JSON Schema 的定义与验证角色参考规范站点 [S2]。本文不固化任何供应商的配置字段或模型名单。