JSON garantovaný schématem
Na této stránce
Proč strukturované výstupy mění vše
Když nasazuješ jazykový model do produkce, potřebuješ odpovědi, které dokáže tvůj kód přímo zpracovat. Ne volný text, ne přibližné JSON – potřebuješ JSON garantovaně splňující schéma, které sám definuješ. Přesně to ti nabízí strukturované výstupy API Grok.
Princip je jednoduchý: modelu předáš JSON schéma a API ti zaručí, že odpověď bude tuto strukturu dodržovat přesně. Žádné chaotické parsování, žádné křehké regulární výrazy, žádné bloky try/catch pro ošetření případů, kdy si model vymyslí vlastní formát.
Jak to funguje
Strukturované výstupy využívají mechanismus omezení aplikovaný přímo během generování textu. Při tvorbě každého tokenu je model nucen vygenerovat pouze tokeny kompatibilní s poskytnutým schématem. Výsledkem je JSON, který je vždy platný a vždy v souladu se zadáním.
Podívejme se na konkrétní příklad. Chceš z e-mailu extrahovat kontaktní údaje:
from pydantic import BaseModel
class Contact(BaseModel):
nom: str
email: str
entreprise: str
telephone: str | None
# Odpověď bude VŽDY platným objektem Contact
Bez strukturovaných výstupů by model mohl vrátit telefonní číslo pod klíčem "tel", "phone" nebo "numéro". Díky schématu se bude pole vždy jmenovat telephone a jeho hodnota bude vždy řetězec nebo null.
Dostupnost
Strukturované výstupy jsou podporovány na všech jazykových modelech xAI: Grok 4.5, Grok 4.3, varianty grok-4.20 a novějších verzích. Ať už použiješ jakýkoli model, tato funkce je dostupná bez příplatku či další konfigurace.
Bez strukturovaných výstupů vs. s nimi
Zde je srovnání toho, co získáš bez této funkce a s ní:
Bez strukturovaných výstupů:
- Model může vrátit volný text, neúplné JSON nebo neočekávaný formát
- Musíš manuálně parsovat a ošetřovat chyby
- Názvy polí se mohou lišit od požadavku k požadavku
- Tvé pipeline se rozbije, jakmile model změní formát
Se strukturovanými výstupy:
- JSON je vždy syntakticky platné
- Struktura přesně odpovídá poskytnutému schématu
- Datové typy jsou dodrženy (řetězec, číslo, boolean atd.)
- Tvůj kód může odpověď přímo spotřebovat
Dva dostupné přístupy
API Grok nabízí dvě metody pro využití strukturovaných výstupů:
parse(): Automatická metoda, která vrací přímo typovaný objekt. Ideální pro většinu případů.response_format: Manuální metoda, která vrací JSON jako řetězec. Poskytuje větší kontrolu, ale parsování je na tobě.
Obě tyto metody si podrobně představíme v následujících lekcích.
Klíčové poznatky
- Strukturované výstupy garantují JSON v souladu s tvým schématem při každém volání
- Omezení se aplikuje během generování, nikoliv až po něm
- Tuto funkci podporují všechny jazykové modely xAI
- K dispozici jsou dvě metody:
parse()(automatická) aresponse_format(manuální) - Toto je základ jakékoli spolehlivé produkční pipeline s API Grok