Prompt yang berkata “jawab dalam JSON” membiarkan bentuknya kepada nasib. JSON Schema menuliskan bentuk itu supaya mesin boleh menyemaknya.
Cara ia berfungsi
Spesifikasinya ada dua bahagian utama: Core, yang “defines the basic foundation of JSON Schema” (Terjemahan BroadRouter: “mentakrifkan asas JSON Schema”), dan Validation, yang “defines the validation keywords” (Terjemahan BroadRouter: “mentakrifkan kata kunci pengesahan”). Versi semasa ialah 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 menggunakan skema di dua tempat. Definisi alat meletakkan satu skema dalam parameters untuk menerangkan argumen. Output berstruktur menghantar satu skema dalam response_format sebagai {"type": "json_schema", "json_schema": {...}}, yang menurut OpenAI “ensures the model will match your supplied JSON schema” (Terjemahan BroadRouter: “memastikan model akan sepadan dengan JSON schema yang anda bekalkan”).
Mod ketat OpenAI hanya menerima subset. Daripada bahagian skema yang disokong:
- Jenis: string, number, boolean, integer, object, array, enum dan anyOf.
- Akar mesti objek dan tidak boleh menggunakan
anyOf. additionalProperties: falsedan setiap medan disenaraikan dalamrequired; jadikan medan pilihan dengan membenarkannull, sepertinotedi atas.- Sehingga 5000 sifat objek dan 10 aras penyarangan, dan sehingga 1000 nilai enum secara keseluruhan.
- Tidak disokong:
allOf,not,dependentRequired,dependentSchemas,if,then,else.
Mengapa ia penting
- Pengesahan. Skema yang sama yang membimbing model menyemak jawapannya dalam kod anda. Semakan yang gagal memberi ralat tepat untuk dihantar semula.
- Kebolehalihan. Skema yang ditulis mengikut subset ketat berfungsi merentas lebih banyak penyedia berbanding skema yang menggunakan setiap kata kunci.
- Token. Skema dalam definisi alat dihantar sebagai input pada setiap permintaan. Penerangan yang panjang memakan token setiap giliran.
Di BroadNet Inference
Rujukan API BroadNet mendokumenkan tool calling dan output berstruktur untuk GLM 5.3 dan Qwen3.8 27B, tetapi tidak menyatakan kata kunci skema yang dikuatkuasakan. Hadkan skema kepada subset ringkas di atas dan sahkan setiap jawapan. Bina skema dengan penjana JSON Schema, semak jawapan dengan pengesah output JSON LLM, dan lihat artikel output berstruktur untuk contoh penuh. Pada model lain, minta JSON dalam prompt dan sahkan jawapannya; mod JSON tidak didokumenkan oleh BroadNet, jadi uji sebelum bergantung padanya.
Kesilapan biasa
- Menggunakan
allOfatau kata kunci bersyarat dan menganggap pelayan menguatkuasakannya. - Menjadikan medan pilihan dalam mod ketat dengan mengeluarkannya daripada
required, bukannya membenarkannull.