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

Miért van szükség strukturált kimenetekre?

1. lecke 12 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. A szabad szöveges kimenetek problémája
  2. JSON: az univerzális formátum folyamatokhoz
  3. Hol merül fel az igény
  4. A hibás kimenetek ára
  5. Főbb megállapítások

Modellfrissítés, 2026. november 2. A Mistral Large 3 (mistral-large-2512) és a Mistral Medium 3.5 modelleket 2026. október 31-én elavulttá nyilvánították, és 2027. április 30-án végleg leállítják. A kijelölt utódjuk, a Mistral Large 4 (mistral-large-4) már október 6. óta nyilvános előzetes verzióban elérhető. A tanfolyam példái a mistral-large-latest álnevet használják, amely a hivatalos specifikáció szerint (2026. november 3-án ellenőrizve) még mindig a Mistral Large 3-ra mutat. Hasonlóképpen, a mistral-medium-latest a Mistral Medium 3.5-re mutat. Ezek az álnevek 2027. április 30-ig érvényesek maradnak. Új projektek esetén teszteld a kijelölt utódot, a mistral-large-4 modellt.

A szabad szöveges kimenetek problémája

Amikor egy nyelvi modellt egy automatizált folyamat közepébe helyezel, gyorsan szembesülsz egy olyan problémával, amely az első napokban ritkán mutatkozik meg: a szabad szöveges válaszai kiszámíthatatlanok. Ugyanazt az információt tucatnyi különböző módon fogalmazhatja meg, és minden egyes variáció más-más parsingelést kényszerít ki a következő lépésben lévő kódodból. Ami egy demón működik, az éles környezetben gyakran csendben meghibásodik.

Vegyünk egy hétköznapi feladatot. Megkéred a Mistralt, hogy vonjon ki egy terméknevet és árat egy kereskedelmi leírásból. Korlátozások nélkül a modell így válaszolhat:

A termék neve "Widget Pro", ára pedig 49,99 €.

Vagy ugyanarra a bemenetre, csak néhány órával később:

Név: Widget Pro
Ár: 49.99 EUR

Mindkét válasz helyes egy emberi olvasó számára. A kódod számára azonban szinte semmi közös nincs bennük: a tizedesvessző pontra változott, a valuta szimbóluma ISO kód lett, és a mondatfelépítés eltűnt. Minden egyes variáció más parsing logikát igényel. Éles környezetben ez csendes hibákhoz, megszakadt folyamatokhoz és óráknyi hibakereséshez vezet.

JSON: az univerzális formátum folyamatokhoz

A JSON ezzel a problémával úgy számol le, hogy géppel olvasható struktúrát kényszerít ki. Ugyanez a kinyerés egyértelművé válik:

{
  "name": "Widget Pro",
  "price": 49.99,
  "currency": "EUR"
}

A választ feldolgozó kód ismét egyszerű és megbízható lesz. A törékeny reguláris kifejezések írása helyett mindössze két stabil sorra van szükséged:

import json

data = json.loads(response)
product_name = data["name"]
price = data["price"]

Nincs több kockázatos regex, nincs több heurisztikus elemzés. A JSON a rendszer-közötti kommunikáció de facto szabványa, így professzionális kontextusban ez a természetes választás az LLM-kimenetekhez.

Hol merül fel az igény

A strukturált kimenetek akkor válnak nélkülözhetetlenné, ha a modell válasza nem csupán egy képernyőre kerül. Az információkinyerés a legkézenfekvőbb példa: entitások (nevek, dátumok, összegek) kinyerése strukturálatlan dokumentumokból csak akkor hasznos, ha az eredmény közvetlenül egy rendszerbe kerül. Az osztályozás ugyanerre a logikára épül: a támogatási jegyek, e-mailek vagy vásárlói vélemények kategorizálása megköveteli, hogy a címke és annak megbízhatósági score-ja előre meghatározott mezőkben érkezzen meg, ne pedig egy mondatba ágyazva.

Az adattranszformáció ezt tovább viszi, amikor a szabad szöveget adatbázisba szánt strukturált rekordokká alakítja. Az ügynökök (agents) és hívási láncok ugyanennyire függnek ettől: egy ügynök csak akkor tudja orchestrálni a munkafolyamatot, ha strukturált műveletet ad vissza, ahol az eszköz neve és paraméterei stabil kulcsokban találhatók. Végül, az LLM néha közvetítő rétegként funkcionál egy olyan REST API előtt, amely specifikus payloadot vár – ebben az esetben a formátum nem kényelmi szolgáltatás, hanem szerződés.

A hibás kimenetek ára

Éles környezetben a megbízhatóság nem opcionális, és egy hibás kimenet háromféleképpen kerül neked pénzbe. Szintaktikailag érvénytelen JSON esetén az alkalmazásod összeomlik a parsing során; ez a legláthatóbb forgatókönyv, de paradox módon a legkevésbé veszélyes. A hiányzó mezők csendesen korruptálják az adataidat: a rekord átmegy, de hiányos, és a probléma csak hetekkel később kerül felszínre. A nem egyező típusok – például a "42" sztring ott, ahol a 42 számot vártad – váratlan viselkedést okoznak a downstream számításokban anélkül, hogy valaha kivételt dobnának.

A Mistral strukturált kimenetei két kiegészítő mechanizmussal kezelik ezt a három kihívást. A JSON Mode garantálja az érvényes JSON kimenetet anélkül, hogy sémát kényszerítene ki: egy paraméterrel engedélyezed, és a prompton keresztül irányítod a formátumot. A Egyéni Strukturált Kimenetek (Custom Structured Outputs) tovább mennek, és egy pontos sémát kényszerítenek ki, amelyet Pythonban Pydantic, TypeScript-ben pedig Zod segítségével írhatsz le.

Ez a tanfolyam végigvezet mindkét megközelítésen. Megtanulod, hogyan válaszd ki a használatesetedhez illőt, hogyan írd meg a hozzá tartozó kódot mindkét nyelven, és hogyan kezeld a hibaeseteket olyan mintákkal, amelyek megállják a helyüket éles környezetben is.

Főbb megállapítások

  • A szabad szöveges kimenetek kiszámíthatatlanok és alkalmatlanok automatizált folyamatokhoz
  • A JSON a gép-közötti kommunikáció szabványos formátuma
  • A Mistral két mechanizmust kínál strukturált kimenetekhez: JSON Mode és Egyéni Strukturált Kimenetek
  • A kimenet megbízhatósága kritikus fontosságú éles környezetben – a strukturált kimenetek befektetést jelentenek, nem luxust