JSON Iggarantit mill-Iskema
F'din il-paġna
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.
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) uresponse_format(manwali) - Din hija l-bażi ta’ kwalunkwe pipeline affidabbli tal-produzzjoni mal-API ta’ Grok