Kapag “sumagot ka sa JSON” lang ang sinabi ng prompt, bahala na ang tsamba sa hugis. Isinusulat ng JSON Schema ang hugis para kayang i-check ito ng makina.
Paano ito gumagana
Dalawa ang pangunahing bahagi ng specification: ang Core, na “defines the basic foundation of JSON Schema” (Salin ng BroadRouter: “nagtatakda ng pangunahing pundasyon ng JSON Schema”), at ang Validation, na “defines the validation keywords” (Salin ng BroadRouter: “nagtatakda ng mga validation keyword”). 2020-12 ang kasalukuyang bersyon; 2019-09 ang nauna.
{
"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
}
Sa dalawang lugar gumagamit ng schema ang mga LLM API. Naglalagay ang mga tool definition ng isa sa parameters para ilarawan ang mga argument. Nagpapadala naman ang structured output ng isa sa response_format bilang {"type": "json_schema", "json_schema": {...}}, na ayon sa OpenAI ay “ensures the model will match your supplied JSON schema” (Salin ng BroadRouter: “tumitiyak na tutugma ang model sa ibinigay mong JSON schema”).
Subset lang ang tinatanggap ng strict mode ng OpenAI. Mula sa seksyon nito tungkol sa mga suportadong schema:
- Mga type: string, number, boolean, integer, object, array, enum at anyOf.
- Object dapat ang root at hindi puwedeng gumamit ng
anyOf. additionalProperties: falseat nakalista sarequiredang bawat field; gawing optional ang isang field sa pagpayag sanull, gaya ngnotesa itaas.- Hanggang 5000 object property at 10 antas ng nesting, at hanggang 1000 enum value sa kabuuan.
- Hindi suportado:
allOf,not,dependentRequired,dependentSchemas,if,then,else.
Bakit ito mahalaga
- Validation. Ang parehong schema na gumagabay sa model ang nagche-check sa sagot nito sa code mo. Ang pumalyang check ay nagbibigay ng eksaktong error na puwedeng ibalik sa model.
- Portability. Mas maraming provider ang tumatanggap ng schema na nakasulat sa strict na subset kaysa sa schema na gumagamit ng lahat ng keyword.
- Mga token. Ipinapadala bilang input sa bawat request ang mga schema sa tool definition. May gastos sa token bawat turn ang mahahabang description.
Sa BroadNet Inference
Idinodokumento ng API reference ng BroadNet ang tool calling at structured output para sa GLM 5.3 at Qwen3.8 27B, pero hindi kung aling schema keyword ang ipinapatupad. Panatilihin ang mga schema sa simpleng subset sa itaas at i-validate ang bawat sagot. Gumawa ng schema gamit ang JSON Schema generator, i-check ang mga sagot gamit ang LLM JSON output validator, at tingnan ang post tungkol sa structured output para sa buong example. Sa ibang model, humingi ng JSON sa prompt at i-validate ang sagot; hindi idinodokumento ng BroadNet ang JSON mode, kaya subukan muna bago umasa rito.
Mga karaniwang pagkakamali
- Paggamit ng
allOfo mga conditional keyword at pag-aakalang ipinapatupad ito ng server. - Paggawang optional ng field sa strict mode sa pag-alis nito sa
required, sa halip na payagan angnull.