Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Séma-garantált JSON

1. lecke 12 közül Frissítve 2026. július 28. Fejlesztő
Ezen az oldalon
  1. Miért változtat meg mindent a strukturált kimenet
  2. Hogyan működik
  3. Elérhetőség
  4. Strukturált kimenetek nélkül és velük
  5. Két elérhető megközelítés
  6. Főbb megállapítások

Miért változtat meg mindent a strukturált kimenet

Amikor nyelvi modellt használsz éles környezetben (production), olyan válaszokra van szükséged, amelyeket a kódod fel tud dolgozni. Nem szabad szövegre, nem közelítő JSON-ra – hanem olyan JSON-ra van szükséged, amely garantáltan megfelel az általad definiált sémának. Pontosan ezt kínálja neked a Grok API strukturált kimenete.

Az elv egyszerű: átadsz egy JSON sémát a modellnek, és az API garantálja, hogy a válasz pontosan ezt a struktúrát követi. Nincs többé esetleges elemzés, nincs törékeny regex, és nincs szükség try/catch blokkokra sem azoknak az eseteknek a kezelésére, amikor a modell saját formátumot talál ki.

Hogyan működik

A strukturált kimenetek egy olyan korlátozó mechanizmusra építenek, amely a szöveg generálása során lép életbe. Minden egyes előállított tokennél a modell arra kényszerül, hogy csak a megadott sémával kompatibilis tokeneket generáljon. Az eredmény: olyan JSON, amely mindig érvényes és mindig megfelel a követelményeknek.

Nézzünk egy konkrét példát. Kontaktinformációkat szeretnél kinyerni egy e-mailből:

from pydantic import BaseModel

class Contact(BaseModel):
    nom: str
    email: str
    entreprise: str
    telephone: str | None

# A válasz MINDIG egy érvényes Contact objektum lesz

Strukturált kimenetek nélkül a modell a telefonszámot visszaadhatja "tel", "phone" vagy "numéro" kulcs alatt is. Séma használata esetén a mező neve mindig telephone lesz, az értéke pedig mindig karakterlánc vagy null.

Elérhetőség

A strukturált kimenetek minden xAI nyelvi modellen támogatottak: Grok 4.5, Grok 4.3, grok-4.20 variánsok és a későbbi verziók. Bármelyik modellt is használod, a funkció elérhető extra költség vagy további konfiguráció nélkül.

100%
Garantáltan érvényes JSON
7
Támogatott típusok
Összes
xAI modell
2
Hívási módszer

Strukturált kimenetek nélkül és velük

Íme, mit kapsz ezzel a funkcióval, és mit nélküle:

Strukturált kimenetek nélkül:

  • A modell szabad szöveget, hiányos JSON-t vagy váratlan formátumot adhat vissza
  • Neked kell manuálisan elemezned és kezelned a hibákat
  • A mezőnevek kérésről kérésre változhatnak
  • A folyamataid megszakadnak, amint a modell formátumot vált

Strukturált kimenetekkel:

  • A JSON mindig szintaktikailag érvényes
  • A struktúra pontosan megegyezik a megadott sémával
  • A típusok betartásra kerülnek (karakterlánc, szám, logikai érték stb.)
  • A kódod közvetlenül fel tudja dolgozni a választ

Két elérhető megközelítés

A Grok API két módszert kínál a strukturált kimenetek használatára:

  • parse(): Automatikus módszer, amely közvetlenül egy típusozott objektumot ad vissza. A legtöbb esetben ez az ideális.
  • response_format: Manuális módszer, amely egy JSON karakterláncot ad vissza. Több kontrollt biztosít, de az elemzés rád hárul.

Ezt a két módszert a következő leckékben részletesen is megismered majd.

Főbb megállapítások

  • A strukturált kimenetek garantálják, hogy minden hívásnál a sémádnak megfelelő JSON-t kapsz
  • A korlátozás a generálás során, nem pedig utólag lép életbe
  • Minden xAI nyelvi modell támogatja ezt a funkciót
  • Két módszer áll rendelkezésre: parse() (automatikus) és response_format (manuális)
  • Ez alapozza meg bármely megbízható, Grok API-t használó éles rendszert (production pipeline)