Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

JSON garantovaný schémou

Lekcia 1 z 12 Aktualizované 28. júla 2026 Vývojár
Na tejto strane
  1. Prečo štruktúrované výstupy menia všetko
  2. Ako to funguje
  3. Dostupnosť
  4. Bez štruktúrovaných výstupov vs. so štruktúrovanými výstupmi
  5. Dva dostupné prístupy
  6. Kľúčové poznatky

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.

100%
Garantovaný platný JSON
7
Podporované typy
Všetky
Modely xAI
2
Spôsoby volania

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á) a response_format (manuálna)
  • Toto je základom akéhokoľvek spoľahlivého produkčného pipeline s API Grok