BroadRouter
Magsimula

JSON Schema

Na-update

Ang JSON Schema ay isang vocabulary, nakasulat sa JSON, para ilarawan at i-validate ang istruktura ng JSON data: mga type, required na field, pinapayagang value at nesting. 2020-12 ang kasalukuyang bersyon. Ginagamit ito ng mga LLM API para tukuyin ang tool parameters at ang eksaktong hugis na dapat sundin ng structured output.

Tinatawag ding: JSON Schema sa LLM, schema ng JSON, json_schema, JSON Schema draft 2020-12

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: false at nakalista sa required ang bawat field; gawing optional ang isang field sa pagpayag sa null, gaya ng note sa 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 allOf o 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 ang null.

Mga tanong

Suportado ba ng mga LLM API ang buong JSON Schema?

Hindi. Isang subset lang ang suportado ng OpenAI: halimbawa, object dapat ang root, required dapat ang bawat field, false dapat ang additionalProperties, at hindi suportado ang mga keyword gaya ng allOf, not at if/then/else.

Ano ang pagkakaiba ng JSON Schema at JSON mode?

Valid na JSON lang ang ipinapangako ng JSON mode. Sinasabi naman ng JSON Schema sa model, at sa validator mo, kung anong mga field at type ang dapat mayroon ang JSON na iyon.

Puwede ko bang gamitin ang JSON Schema sa BroadNet Inference?

Naka-dokumento para sa GLM 5.3 at Qwen3.8 27B ang tool parameters at structured output, na parehong gumagamit ng schema. Hindi idinodokumento ng BroadNet kung aling schema keyword ang ipinapatupad nito, kaya i-validate ang bawat sagot.

Basahin bilang MarkdownTanungin ang ChatGPTTanungin ang ClaudeTanungin ang Perplexity