Concept Fable精修版

JSON 模式

JSON Mode · Model interface

先读故事。这里不急着给定义，先让问题自己长出来。

寓言故事

书记员被要求只用账册格式回话

盐号要把各铺日报送进总账。自由书信虽然能表达复杂情况，却让日期、铺名、盐数和欠账散落各处，算盘手无法稳定读取。

总账先生规定每份回报都用对象和字段表达，缺失值也明确留空。机器因此能解析外层 JSON，而不必猜测段落中哪句话代表金额。

一次回报确实是合法 JSON，却把银数填进盐数格。账房随后增加字段类型、必填项和业务范围检查，发现问题就退回修正。

结构化输出适合进入下游程序，但它不能替模型决定事实，也不能替代权限、业务规则和人工审批。每次拒收都记录具体字段和原因。

JSON Mode 主要帮助模型稳定产出可解析的 JSON；生产流程还必须验证 schema、类型和业务语义，不能把“能解析”当成“可执行”。

概念落点

这个故事讲的是：JSON 模式

JSON Mode 是一种生成模式，用来促使或约束模型输出有效 JSON，而不是自由文本。它适合需要机器解析的场景，如信息抽取、配置生成、轻量结构化返回。但 JSON Mode 通常只保证或强化 JSON 格式，不等同于严格 schema adherence；企业流程仍需要字段校验、类型校验、业务规则、错误处理和必要的人审。

它重要的地方在于：它不只是一个术语，而是在真实 AI / Agent 系统里会反复出现的结构性问题。理解它，才能判断什么时候该加模型，什么时候该改流程，什么时候该补治理。

故事对应

自然语言段落：自由文本输出
抠字段：脆弱的后处理解析
尽量写成 JSON：只靠提示词要求格式
必须保持 JSON 形状：JSON Mode
先解析再检查：parse + validate
格式正确不等于业务正确：JSON Mode 的边界
schema 校验和复核：企业级结构化接口治理
最后洞察：JSON Mode 主要解决机器可解析的 JSON 格式问题

Soloharness 判断

这个概念的实战价值，是帮你把“看起来聪明的 AI 功能”拆成可交付、可验收、可治理的工作单元。

structured outputschemaparser