Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

JSON garantovaný schématem

Lekce 1 z 12 Aktualizováno 28. července 2026 Vývojář
Na této stránce
  1. Proč strukturované výstupy mění vše
  2. Jak to funguje
  3. Dostupnost
  4. Bez strukturovaných výstupů vs. s nimi
  5. Dva dostupné přístupy
  6. Klíčové poznatky

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.

100%
Garantovaně platné JSON
7
Podporované typy
Všechny
Modely xAI
2
Způsoby volání

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á) a response_format (manuální)
  • Toto je základ jakékoli spolehlivé produkční pipeline s API Grok