Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

JSON Iggarantit mill-Iskema

Lezzjoni 1 / 12 Aġġornat 28 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Għaliex l-outputs strutturati jbiddlu kollox
  2. Kif taħdem
  3. Disponibbiltà
  4. Mingħajr vs. Ma’ Outputs Strutturati
  5. Żewġ approċċi disponibbli
  6. Punti Ewlenin

Għaliex l-outputs strutturati jbiddlu kollox

Meta tuża mudell tal-lingwa fil-produzzjoni, għandek bżonn risposti li l-kodiċi jista’ juża. Mhux test liberu, mhux JSON approssimattiv—iżda JSON iggarantit li jikkonforma ma’ skema li tiddefinixxi int. Dan huwa eżattament dak li joffrulek l-outputs strutturati tal-API ta’ Grok.

Il-prinċipju huwa sempliċi: inti tipprovdi skema JSON lill-mudell, u l-API tiggarantixxi li r-risposta ssegwi din l-istruttura eżattament. L-ebda parsing kaotiku, l-ebda regex fraġli, l-ebda try/catch biex tittratta każijiet fejn il-mudell jinventa format.

Kif taħdem

L-outputs strutturati jiddependu fuq mekkaniżmu ta’ restrizzjoni applikat matul il-ġenerazzjoni tat-test. F’kull token prodott, il-mudell huwa mġiegħel jiġġenera biss tokens kompatibbli mal-iskema pprovduta. Ir-riżultat: JSON li dejjem ikun validu, dejjem konformi.

Ejja nħarsu lejn eżempju konkret. Trid testraġġi informazzjoni ta’ kuntatt minn email:

from pydantic import BaseModel

class Contact(BaseModel):
    nom: str
    email: str
    entreprise: str
    telephone: str | None

# Ir-risposta tkun DEJJEM oġġett Contact validu

Mingħajr outputs strutturati, il-mudell jista’ jirritorna t-telefon bħala "tel", "phone", jew "numéro". B’skema, il-qasam dejjem jissejjaħ telephone, u l-valur tiegħu dejjem ikun stringa jew null.

Disponibbiltà

L-outputs strutturati huma appoġġjati fuq il-mudelli kollha tal-lingwa ta’ xAI: Grok 4.5, Grok 4.3, il-varjanti grok-4.20, u verżjonijiet sussegwenti. Liema mudell tuża, il-karatteristika hija disponibbli mingħajr kost addizzjonali jew konfigurazzjoni extra.

100%
JSON validu ggarantit
7
Tipi appoġġjati
Kollha
Mudelli xAI
2
Metodi ta' sejħa

Mingħajr vs. Ma’ Outputs Strutturati

Hawnhekk tara x’tikseb mingħajr u ma’ din il-karatteristika:

Mingħajr outputs strutturati:

  • Il-mudell jista’ jirritorna test liberu, JSON parzjali, jew format mhux mistenni
  • Trid tipparsja manwalment u tittratta l-iżbalji
  • L-ismijiet tal-oqsma jistgħu jvarjaw minn talba għal oħra
  • Il-pipeline tiegħek titkisser hekk kif il-mudell ibiddel il-format

Ma’ outputs strutturati:

  • Il-JSON huwa dejjem sintattikament validu
  • L-istruttura taqbel mal-iskema pprovduta eżattament
  • It-tipi jiġu rrispettati (stringa, numru, boolean, eċċ.)
  • Il-kodiċi tiegħek jista’ jikkonsma r-risposta direttament

Żewġ approċċi disponibbli

L-API ta’ Grok toffri żewġ metodi biex tuża outputs strutturati:

  • parse(): Metodu awtomatiku li jirritorna oġġett ittajpjat direttament. Ideali għall-biċċa l-kbira tal-każijiet.
  • response_format: Metodu manwali li jirritorna stringa JSON. Aktar kontroll, iżda l-parsing jaqa’ fuqek.

Se tiskopri dawn iż-żewġ metodi fid-dettal fil-lezzjonijiet li ġejjin.

Punti Ewlenin

  • L-outputs strutturati jiggarantixxu JSON konformi mal-iskema tiegħek f’kull sejħa
  • Ir-restrizzjoni tiġi applikata matul il-ġenerazzjoni, mhux wara
  • Il-mudelli kollha tal-lingwa ta’ xAI jappoġġjaw din il-karatteristika
  • Żewġ metodi huma disponibbli: parse() (awtomatiku) u response_format (manwali)
  • Din hija l-bażi ta’ kwalunkwe pipeline affidabbli tal-produzzjoni mal-API ta’ Grok