Structured Output校驗

粘貼模型返回的JSON與目標Schema,檢查必填欄位與基礎類型。 上線structured output前快速自檢。

阅读完整指南: json schema api 設計指南:從樣例生成到 llm 校驗實戰 →

隱私提示:本地解析,不上傳伺服器。

↓ 在下方輸入區貼上內容,結果會立即顯示

JSON 数据

JSON Schema

註釋說明

校验范围

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

粘貼模型返回的JSON與目標Schema,檢查必填欄位與基礎類型。 上線structured output前快速自檢。

快速開始

  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。