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.
常见问题
关于常见调试问题和数据隐私的可展开解答。
相关工具
探索可与此工具配合使用的其他相关实用工具。
官方文档与参考
本工具的权威规范与平台文档。