Tool overview
構造化出力ジェネレーターとは?
構造化出力ジェネレーターは、サンプルペイロードからJSON Schemaを推論ための開発者向けツールです。
なぜ構造化出力ジェネレーターを使うのか?
サンプルペイロードからJSON Schemaを推論際の可読性と作業速度を向上させ、データをサーバーに送信しません。
主な機能
クライアントサイドのプライバシー、即座の結果、ワンクリックコピー。サンプルペイロードからJSON Schemaを推論
使い方
上のツールで正確な結果を得るための手順です。
- LLM の応答またはツール引数の代表的な JSON 例を左パネルに貼り付けます。
- 任意のキーは省略 — 例に存在するキーだけが required になります。
- Strict objects を有効にし、各オブジェクトに additionalProperties: false を出力 — OpenAI 向けに推奨。
- 必要なら OpenAPI やツール登録用に Schema タイトルを設定します。
- 右パネルの JSON Schema draft 2020-12 を確認します。
- 配列が items: {} なら代表要素を1つ以上追加して再生成します。
- schema を response_format、ツールパラメーター、またはエージェント設定にコピーします。
- 型がおかしければ例を修正し、必要なら生成後に enum や oneOf を手編集します。
構造化出力ジェネレーター — 完全ガイドとユースケース
権威ある解説:draft 2020-12 推論、strict 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 をスキーマ型へ対応付ける方法
推論は 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 スキーマ
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.
スキーマ推論のベストプラクティス
- OpenAI 対応 schema の初回手順です。
- 有効にします: strict, OpenAI.
- 任意キーを省略します: required.
- 代表的な例を貼り付けます: items.
- enum, oneOf.
- 確認します: JSON Schema.
- 関連ツールを使用: AI Agent Builder.
よくある質問
一般的なトラブルとデータプライバシーに関する回答です。
関連ツール
このツールを補完する関連ユーティリティをご覧ください。
公式ドキュメントと参照
このユーティリティの公式仕様とプラットフォーム文書です。