Structured Output 校验

LLM 与 API 返回的 JSON 语法正确不代表字段类型与必填项符合合同。本工具根据 JSON Schema 在本地校验结构化输出,列出缺失字段、类型错误与 enum 违规。校验前可先用 json-formatter 格式化样本,OpenAPI 组件 schema 可配合 openapi-formatter 整理后粘贴。

阅读完整指南: JSON Schema API 设计指南:从样例生成到 LLM 校验实战 →

隐私提示:本地解析,不上传服务器。

↓ 在下方输入区粘贴内容,结果会立即显示

JSON 数据

JSON Schema

注释说明

校验范围

支持 object 类型、required 与 properties 嵌套; 类型检查为 string/number/boolean 等基础类型。非完整 JSON Schema 实现。

LLM 与 API 返回的 JSON 语法正确不代表字段类型与必填项符合合同。本工具根据 JSON Schema 在本地校验结构化输出,列出缺失字段、类型错误与 enum 违规。校验前可先用 json-formatter 格式化样本,OpenAPI 组件 schema 可配合 openapi-formatter 整理后粘贴。

快速开始

  1. 粘贴 JSON

    左侧为模型输出或样例数据。

  2. 粘贴 Schema

    右侧为 object/required/properties 结构。

适用场景

配合 JSON Schema 推断工具生成 schema,再对本工具校验真实输出。

典型工作流

使用本工具时,首先将LLM返回的JSON粘贴到左侧输入框。然后,在右侧输入框粘贴您的JSON Schema。点击验证按钮后,工具会高亮显示缺失字段、类型错误和格式问题。修正错误后重新验证,直到输出完全符合Schema要求。

对于复杂Schema,建议分阶段验证:先检查必填字段,再验证类型,最后测试嵌套结构。调试时可简化Schema逐步排除问题。每次API响应变更都应重新验证,特别当模型版本更新时。

JSON Schema 门禁

定义 required、type、enum、pattern 约束。LLM structured output 与 REST API contract test 均可用同一 schema。语法合法 JSON 仍可能 fail schema——先 json-formatter 再 validate。

OpenAPI 3 component schemas 可提取粘贴;openapi-formatter 整理大 spec 后复制片段。

LLM 工作流

System prompt 声明 JSON schema;响应经 validator 失败则 retry 或 fallback。配合 llm-json-extractor 去 Markdown 包装。

token-counter 确保 schema + example 不撑爆 context。

CI 集成思路

Browser 工具适合 ad-hoc;CI 应用 ajv 或 same schema file。validator 错误路径(如 $.items[2].price)直接指向 bug。

json-diff 对比 fix 前后 payload 是否满足新 schema。

示例

示例

Input

{"name":"Ada","score":98}

Output

Valid or issue list

FAQ

支持 array 校验吗?

当前以 object 嵌套为主; 复杂 array 请人工复核。

验证通过后是否保证生产环境可用?

不完全保证。本工具检查基础结构合规性,但实际业务还需测试:字段语义合理性、空值处理、超长文本截断等。建议配合单元测试和沙箱环境验证。

支持 JSON Schema 哪个 draft?

以工具实现为准;复杂 $ref 可能需简化。

YAML schema 呢?

先 yaml-converter 转 JSON schema 或 instance。

数据上传吗?

否。

format 关键字呢?

email/date-time 等 format 视支持程度;critical 约束用 pattern。