Structured Output（结构化输出）
先用一句话说清楚
Structured Output（结构化输出）是让模型按照稳定字段和可校验格式返回结果，使业务系统能够继续处理。
实战知识卡
| 维度 | 要点 |
|---|---|
| 项目里看什么 | 看模型输出是否能被前端、后端、表格或工作流稳定读取。 |
| 新手最该记住 | 结构化输出（Structured Output（结构化输出））把自然语言结果变成系统契约。 |
| 作品集证据 | 展示字段含义、枚举范围、失败状态和前端如何展示这些字段。 |
| 面试回答公式 | 先说为什么要结构化，再说 schema（结构定义）校验失败如何处理。 |
| 常见扣分点 | 只让模型“按格式回答”，但系统不校验。 |
新手通俗解释
自然语言回答适合人看，但程序需要稳定字段。比如用户说“我要退货”，AI Agent（人工智能体）不能只生成一段温柔回复，还要输出意图、风险等级、是否需要工具、缺少哪些信息、下一步动作和依据来源。
Structured Output（结构化输出）就是把模型回答变成“系统能读懂的结果”。它不等于把答案写成 JSON（结构化数据格式）那么简单，真正重要的是字段含义清楚、取值范围明确、能校验、失败后能兜底。
为什么智能体工程师岗位会问它
AI（人工智能）应用要进入业务流程，必须把不稳定的自然语言结果变成稳定契约。面试官问 Structured Output（结构化输出），是在看你是否理解模型和后端系统之间的接口边界。
常见考察点：
| 考察点 | 面试官想听什么 |
|---|---|
| 字段设计 | 输出字段服务于业务流程，不是随便列几个字段 |
| schema（结构定义）校验 | 模型输出必须被校验，不合法不能继续执行 |
| 失败处理 | 解析失败、字段缺失、枚举错误时怎么兜底 |
| 工具联动 | 结构化结果如何决定是否 Tool Calling（工具调用） |
| 风险控制 | 高风险动作不能只靠模型字段直接执行 |
它在项目里到底怎么用
以客服 Agent（智能体）为例，Structured Output（结构化输出）可以承担“任务路由”的作用：
| 字段含义 | 作用 | 工程边界 |
|---|---|---|
| 用户意图 | 判断是咨询、投诉、订单、退款还是未知 | 意图不清时先追问 |
| 风险等级 | 判断是否涉及投诉、法律、财务或隐私 | 高风险要转人工 |
| 依据来源 | 判断回答是否来自知识库、工具结果或用户输入 | 无依据不能确定回答 |
| 下一步动作 | 决定直接回答、RAG（检索增强生成）、工具调用或转人工 | 动作需要系统二次校验 |
| 缺失信息 | 告诉用户还需要补充什么 | 不要在缺字段时强行调用工具 |
和普通文本回答的区别
普通文本回答只对用户友好，Structured Output（结构化输出）同时对系统友好。它让前端可以展示风险等级，让后端可以选择工具，让日志可以记录状态，让测试可以判断是否符合预期。
但它不是万能保险。即使模型返回了看似正确的结构，系统也要校验字段范围、权限和业务规则。
常见误解
| 误解 | 为什么不对 | 正确理解 |
|---|---|---|
| 让模型返回 JSON（结构化数据格式）就够了 | 模型可能返回不合法字段或混入解释文字 | 需要 schema（结构定义）、校验和失败处理 |
| 结构化输出可以代替后端判断 | 模型判断不等于业务授权 | 后端仍要做权限和风险控制 |
| 字段越多越专业 | 字段太多会增加错误和维护成本 | 字段要围绕业务动作设计 |
| 解析失败可以忽略 | 忽略失败会污染业务流程 | 解析失败要重试、降级或转人工 |
面试官可能怎么追问
1. Structured Output（结构化输出）和 Prompt（提示词）是什么关系？
考察点： 是否理解输出契约。
参考回答： Prompt（提示词）负责告诉模型任务、边界和输出要求，Structured Output（结构化输出）负责把模型结果约束成系统可解析的字段。好的 Prompt（提示词）会说明字段含义和边界，但系统还必须做 schema（结构定义）校验，不能只相信模型自觉。
容易扣分： 说“在 Prompt（提示词）里要求返回固定格式就行”。
2. 结构化输出失败怎么办？
考察点： 是否有失败兜底。
参考回答： 我会先判断失败类型：格式不合法、字段缺失、枚举值不在范围、内容和字段矛盾、风险等级不可信。可以做一次有边界的重试，仍失败就降级为人工草稿、转人工或终止任务，并记录 Trace ID（追踪编号）和错误原因。
容易扣分： 直接把原始文本硬塞进业务表。
3. Structured Output（结构化输出）怎么和 Tool Calling（工具调用）配合？
考察点： 是否能连接模型判断和系统执行。
参考回答： Structured Output（结构化输出）可以先给出下一步动作和缺失字段，比如是否需要查订单、是否缺订单号、风险等级是否允许自动执行。但 Tool Calling（工具调用）执行前还要经过系统校验。模型输出是候选决策，不是最终授权。
容易扣分： 模型输出“需要退款”就直接调用退款工具。
作品集里怎么展示它
建议在项目页面展示“结构化结果面板”：
- 用户原始问题。
- 模型识别出的意图、风险等级、依据来源和下一步动作。
- 系统校验结果：通过、缺字段、无权限或高风险。
- 最终处理：回答、调用工具、转人工或拒答。
- 错误样例：结构化输出不合法时如何兜底。
面试官看到这个面板，会更容易相信你的项目不是只做了一个聊天框。