Tool overview
什么是结构化輸出產生器?
结构化輸出產生器是一款帮助您从示例负载推断 JSON Schema的開發者工具。
為什么使用结构化輸出產生器?
在需要从示例负载推断 JSON Schema時提升可讀性与效率,且不會将数據上传到服務器。
核心功能
客戶端私隱保护、即時結果与一鍵複製。从示例负载推断 JSON Schema
使用方法
按照以下步骤使用上方工具并获得准确結果。
- 将具有代表性的 LLM 工具响应或函数参数 JSON 示例粘贴到左侧面板。
- 省略应為可選的鍵 — 仅示例中出现的鍵會进入 required。
- 启用 Strict objects,使每个物件輸出 additionalProperties: false — 推荐用于 OpenAI 结构化輸出。
- 可選設定 Schema 標題,便于 OpenAPI 或工具注册文件。
- 在右侧面板查看產生的 JSON Schema draft 2020-12。
- 若陣列顯示 items: {},至少添加一个代表性元素并重新產生。
- 将 Schema 複製到 response_format、工具参数或智能體設定。
- 类型不对時迭代示例;需要時在產生后手改 enum 或 oneOf。
结构化輸出產生器 — 完整指南与用例
权威指南:draft 2020-12 推断、严格 additionalProperties、OpenAI 与工具参数用例、空陣列修複、以及通过省略实现可選性。
结构化輸出產生器指南
本指南说明如何在瀏覽器中根據 JSON 示例推断 JSON Schema draft 2020-12。
结构化輸出產生器的作用
產生器将 JSON 示例轉換為 JSON Schema,并可使用 additionalProperties: false 封闭物件。
您将获得
- JSON Schema draft 2020-12
- 您将获得: additionalProperties: false
- 您将获得: required
- 您将获得: integer / number / null
- 您将获得: items
- 将 schema 複製到: response_format
需要推断 schema 時使用
- 需要推断 schema 時使用
- 需要推断 schema 時使用: OpenAI
- 需要推断 schema 時使用: JSON Schema
- 需要推断 schema 時使用: strict
请使用相關工具
- 请使用相關工具: AI Agent Builder
- 请使用相關工具: MCP Validator
- 请使用相關工具: LLM Token Counter
示例 JSON 如何映射為 Schema 类型
推断會遍历 JSON 树;輸入必须是严格 JSON。
推断會遍历 JSON 树;輸入必须是严格 JSON。
| 示例值 | 推断类型 | 说明 |
|---|---|---|
| "ok" | string | 您将获得 |
| 42 | integer | 您将获得 |
| 42.5 | number | 您将获得 |
| true | boolean | 您将获得 |
| null | null | 省略可選鍵: |
| [] | array + items: {} | 空陣列无法顯示 items 类型。 |
| { "a": 1 } | object | required + additionalProperties: false |
陣列使用第一个元素的类型;混合类型请手动编辑 oneOf。
分步:示例 → draft 2020-12 Schema
面向 OpenAI schema 的入門流程。
- 粘贴具有代表性的示例: JSON.
- 省略可選鍵: required.
- 启用: strict additionalProperties: false.
- 检查: JSON Schema draft 2020-12.
- 空陣列无法顯示 items 类型。 items: {}.
- 将 schema 複製到: response_format.
- oneOf, enum.
- 检查: OpenAI.
用例:OpenAI 结构化輸出
OpenAI: 產生器将 JSON 示例轉換為 JSON Schema,并可使用 additionalProperties: false 封闭物件。
此工具如何帮助
- 粘贴具有代表性的示例: OpenAI JSON.
- 启用: strict.
- 将 schema 複製到: response_format.
- 检查: OpenAI.
結果: JSON Schema, OpenAI.
用例:函数调用工具参数
產生器将 JSON 示例轉換為 JSON Schema,并可使用 additionalProperties: false 封闭物件。
此工具如何帮助
- 粘贴具有代表性的示例: tools[].function.parameters.
- 启用: strict.
- 将 schema 複製到: tools[].function.parameters.
- 检查: JSON Schema.
結果: tools[].function.parameters.
用例:通过省略实现可選字段
產生器将 JSON 示例轉換為 JSON Schema,并可使用 additionalProperties: false 封闭物件。
此工具如何帮助
- 省略可選鍵: required.
- 检查: required.
- null.
- 将 schema 複製到: required.
結果: required.
用例:结构化 JSON 分类器
產生器将 JSON 示例轉換為 JSON Schema,并可使用 additionalProperties: false 封闭物件。
此工具如何帮助
- 粘贴具有代表性的示例: JSON.
- 启用: strict.
- 将 schema 複製到: JSON Schema.
- enum.
結果: JSON Schema, strict.
strict 模式与 additionalProperties: false
strict 模式會在每个物件上設定 additionalProperties: false。
- 启用: strict.
- 检查: JSON Schema.
- strict 模式會在每个物件上設定 additionalProperties: false。
- 检查: additionalProperties: false.
空陣列陷阱 — items: {}
空陣列无法顯示 items 类型。
- 粘贴具有代表性的示例: items.
- 空陣列无法顯示 items 类型。
- oneOf.
- 检查: items.
修複:无效 JSON 輸入
JSON.
發生原因
發生原因
诊断
诊断
修複
- 检查: JSON.
- 粘贴具有代表性的示例: JSON.
- 检查: JSON Schema.
修複:陣列 items 被推断為 {}
items: {}.
發生原因
空陣列无法顯示 items 类型。
诊断
诊断
修複
- 粘贴具有代表性的示例: items.
- 检查: JSON Schema.
- 检查: items.
oneOf.
修複:可選字段被標為 required
required.
發生原因
發生原因
诊断
诊断
修複
- 省略可選鍵: required.
- 检查: JSON Schema.
- null.
Schema 推断最佳实践
- 面向 OpenAI schema 的入門流程。
- 启用: strict, OpenAI.
- 省略可選鍵: required.
- 粘贴具有代表性的示例: items.
- enum, oneOf.
- 检查: JSON Schema.
- 请使用相關工具: AI Agent Builder.
常见問題
關于常见调试問題和数據私隱的可展開解答。
相關工具
探索可与此工具配合使用的其他相關实用工具。
官方文件与参考
本工具的权威规范与平台文件。