JSON garantovaný schémou
Na tejto strane
Prečo štruktúrované výstupy menia všetko
Keď používaš jazykový model v produkčnom prostredí, potrebuješ odpovede, ktoré dokáže tvoj kód priamo spracovať. Nie voľný text, nie približný JSON – ale JSON garantovane súladný so schémou, ktorú definuješ. Presne to ti ponúkajú štruktúrované výstupy API Grok.
Princíp je jednoduchý: modelu poskytneš schému JSON a API ti zaručí, že odpoveď bude túto štruktúru dodržiavať presne. Žiadne náhodné parsovanie, žiadne krehké regulárne výrazy, žiadne bloky try/catch na ošetrenie prípadov, keď si model vymyslí vlastný formát.
Ako to funguje
Štruktúrované výstupy využívajú mechanizmus obmedzení aplikovaný počas generovania textu. Pri každom vygenerovanom tokene je model nútený produkovať iba tokeny kompatibilné s poskytnutou schémou. Výsledkom je JSON, ktorý je vždy platný a vždy v súlade so schémou.
Pozrime sa na konkrétny príklad. Chceš extrahovať kontaktné údaje z e-mailu:
from pydantic import BaseModel
class Contact(BaseModel):
nom: str
email: str
entreprise: str
telephone: str | None
# Odpoveď bude VŽDY platným objektom Contact
Bez štruktúrovaných výstupov by model mohol vrátiť telefónne číslo pod kľúčom "tel", "phone" alebo "numéro". So schémou sa bude pole vždy volať telephone a jeho hodnota bude vždy reťazec alebo null.
Dostupnosť
Štruktúrované výstupy sú podporované na všetkých jazykových modeloch xAI: Grok 4.5, Grok 4.3, varianty grok-4.20 a novšie verzie. Nezáleží na tom, ktorý model použiješ, táto funkcia je dostupná bez ďalších nákladov alebo dodatočnej konfigurácie.
Bez štruktúrovaných výstupov vs. so štruktúrovanými výstupmi
Tu je porovnanie toho, čo dostaneš bez tejto funkcie a s ňou:
Bez štruktúrovaných výstupov:
- Model môže vrátiť voľný text, neúplný JSON alebo neočakávaný formát
- Musíš manuálne parsovať a ošetrovať chyby
- Názvy polí sa môžu líšiť od požiadavky k požiadavke
- Tvoje pipeline sa zrúti hneď, ako model zmení formát
So štruktúrovanými výstupmi:
- JSON je vždy syntakticky platný
- Štruktúra presne zodpovedá poskytnutej schéme
- Typy sú dodržané (reťazec, číslo, boolean atď.)
- Tvoj kód môže odpoveď priamo spotrebovať
Dva dostupné prístupy
API Grok ponúka dva spôsoby využitia štruktúrovaných výstupov:
parse(): Automatická metóda, ktorá vráti priamo typizovaný objekt. Ideálne pre väčšinu prípadov.response_format: Manuálna metóda, ktorá vráti JSON ako reťazec. Poskytuje väčšiu kontrolu, ale parsovanie je na tebe.
Tieto dve metódy si podrobne predstavíme v nasledujúcich lekciách.
Kľúčové poznatky
- Štruktúrované výstupy garantujú JSON v súlade s tvojou schémou pri každom volaní
- Obmedzenie sa aplikuje počas generovania, nie až po ňom
- Túto funkciu podporujú všetky jazykové modely xAI
- K dispozícii sú dve metódy:
parse()(automatická) aresponse_format(manuálna) - Toto je základom akéhokoľvek spoľahlivého produkčného pipeline s API Grok