Séma-garantált JSON
Ezen az oldalon
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.
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) ésresponse_format(manuális) - Ez alapozza meg bármely megbízható, Grok API-t használó éles rendszert (production pipeline)