Prompt yang berbunyi “balas dalam JSON” menyerahkan bentuknya pada kebetulan. JSON Schema menuliskan bentuk itu agar bisa diperiksa mesin.
Cara kerjanya
Spesifikasinya punya dua bagian utama: Core, yang “defines the basic foundation of JSON Schema” (terjemahan: mendefinisikan fondasi dasar JSON Schema), dan Validation, yang “defines the validation keywords” (terjemahan: mendefinisikan keyword validasi). Versi terbarunya 2020-12; versi sebelumnya 2019-09.
{
"type": "object",
"properties": {
"name": {"type": "string"},
"amount": {"type": "number", "minimum": 0},
"currency": {"type": "string", "enum": ["SAR", "AED", "USD"]},
"note": {"type": ["string", "null"]}
},
"required": ["name", "amount", "currency", "note"],
"additionalProperties": false
}
API LLM memakai skema di dua tempat. Definisi tool menaruh satu skema di parameters untuk mendeskripsikan argumen. Output terstruktur mengirim satu skema di response_format sebagai {"type": "json_schema", "json_schema": {...}}, yang menurut OpenAI “ensures the model will match your supplied JSON schema” (terjemahan: memastikan model akan cocok dengan JSON schema yang Anda berikan).
Mode strict OpenAI hanya menerima sebagian. Dari bagian skema yang didukung:
- Tipe: string, number, boolean, integer, object, array, enum, dan anyOf.
- Root harus berupa objek dan tidak boleh memakai
anyOf. additionalProperties: falsedan setiap field tercantum direquired; buat field menjadi opsional dengan mengizinkannull, sepertinotedi atas.- Hingga 5000 properti objek dan 10 tingkat nesting, serta total hingga 1000 nilai enum.
- Tidak didukung:
allOf,not,dependentRequired,dependentSchemas,if,then,else.
Kenapa ini penting
- Validasi. Skema yang sama yang memandu model juga memeriksa balasannya di kode Anda. Pemeriksaan yang gagal memberi error yang persis untuk dikirim balik.
- Portabilitas. Skema yang ditulis dengan subset strict bekerja di lebih banyak penyedia daripada skema yang memakai semua keyword.
- Token. Skema dalam definisi tool dikirim sebagai input di setiap permintaan. Deskripsi panjang memakan token di setiap giliran.
Di BroadNet Inference
Referensi API BroadNet mendokumentasikan tool calling dan output terstruktur untuk GLM 5.3 dan Qwen3.8 27B, tetapi tidak menyebut keyword skema mana yang ditegakkan. Batasi skema pada subset sederhana di atas dan validasi setiap balasan. Buat skema dengan generator JSON Schema, periksa balasan dengan validator output JSON LLM, dan lihat artikel output terstruktur untuk contoh lengkap. Di model lain, minta JSON di prompt dan validasi balasannya; JSON mode tidak didokumentasikan oleh BroadNet, jadi uji sebelum mengandalkannya.
Kesalahan umum
- Memakai
allOfatau keyword kondisional dan mengira server menegakkannya. - Membuat field opsional dengan mengeluarkannya dari
requireddi mode strict, alih-alih mengizinkannull.