Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Režim JSON vs. vlastné štruktúrované výstupy

Lekcia 2 z 12 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Dva prístupy, dve filozofie
  2. Režim JSON: flexibilita
  3. Vlastné štruktúrované výstupy: rigoróznosť
  4. Podrobné porovnanie
  5. Ako sa rozhodnúť v praxi
  6. Kľúčové poznatky

Dva prístupy, dve filozofie

API Mistral ponúka dva odlišné mechanizmy na generovanie štruktúrovaných výstupov. Nekonkurujú si; slúžia rôznym fázam životného cyklu projektu. Tvoja voľba závisí od tvojho prípadu použitia, technologického stacku a úrovne spoľahlivosti, ktorú potrebuješ udržať.

Režim JSON: flexibilita

Režim JSON je najjednoduchší prístup. V požiadavke povolíš parameter a Mistral zaručí, že výstup bude platný JSON. To je všetko. Model zostáva voľný pri výbere štruktúry: kľúčov, typov a hĺbky vnorenia. Požadovaný formát usmerňuješ prostredníctvom svojho promptu, ale schému viažu žiadne technické obmedzenia.

# Režim JSON — štruktúru vyberá model
response = client.chat.complete(
    model="mistral-large-latest",
    messages=[{"role": "user", "content": "Analyze this text and return the result in JSON."}],
    response_format={"type": "json_object"}
)

Tento minimalizmus je jeho hlavnou silou: stačí pridať jeden parameter, nemusíš vopred definovať schému a získavaš úplnú flexibilitu, keď skúmaš problém alebo rýchlo prototypuješ. Nevýhoda je symetrická. Nič nezaručuje presnú štruktúru prijatého JSON: model môže vynechať pole, pridať iné alebo premenovať kľúč z jedného volania na druhé. Overovanie na strane klienta sa preto stáva povinnosťou a to je kód, ktorý musíš napísať a udržiavať sám.

Vlastné štruktúrované výstupy: rigoróznosť

Vlastné štruktúrované výstupy presúvajú toto obmedzenie na stranu API. Definuješ presnú schému – pomocou Pydantic v Pythone alebo Zod v TypeScripte – a Mistral prinúti model, aby sa jej presne držal.

from pydantic import BaseModel

class Analyse(BaseModel):
    sentiment: str
    score: float
    keywords: list[str]

# Vlastné — schéma je vynútená
response = client.chat.parse(
    model="mistral-large-latest",
    messages=[{"role": "user", "content": "Analyze this text."}],
    response_format=Analyse
)

Prínos je okamžitý: každé pole je prítomné so správnym typom a dostaneš späť analyzovaný objekt pripravený na použitie – inštanciu modelu Pydantic alebo Zod – s plným automatickým dopĺňaním v IDE. Toto je režim pre produkciu a kritické pipeline. Kompromis sa dá zhrnúť do jednej vety: musíš vopred definovať dátový model, čo robí skúmanie menej flexibilným a ukladá miernu počiatočnú réžiu vývoja.

Podrobné porovnanie

KritériumRežim JSONVlastné štruktúrované výstupy
Aktiváciaresponse_format: {"type": "json_object"}response_format: MyModel (Pydantic/Zod)
Metóda APIclient.chat.complete()client.chat.parse()
Záruka schémyNie – len platný JSONÁno – vynútená presná schéma
Automatické parsovanieNie – manuálne json.loads()Áno – .parsed vráti typovaný objekt
FlexibilitaVysoká – voľná štruktúraNízka – pevná štruktúra
Ideálny prípad použitiaPrototypovanie, skúmanie, premenné schémyProdukcia, kritické pipeline, API
Potrebné overovanieÁno – povinné na strane klientaMinimálne – prácu odvedie schéma

Ako sa rozhodnúť v praxi

Tri signály smerujú k režimu JSON. Prvým je fáza projektu: keď prototypuješ a schéma ešte nie je stabilná, uzamknutie dátového modelu ťa spomalí bez pridania hodnoty. Druhým je povaha úlohy: ak sa štruktúra výstupu legitímne mení na základe vstupu, ako pri exploratívnej analýze, kde relevantné dimenzie nie sú vopred známe, pevná štruktúra by bola sväzujúca. Tretím je technický aspekt: v jazyku bez podpory Pydantic alebo Zod zostáva režim JSON tvojou jedinou vstupnou bránou.

Vlastné štruktúrované výstupy preberajú vedenie hneď, ako sa situácia obráti. Si v produkcii a neúspešná extrakcia má reálne náklady; schéma výstupu je známa a stabilná; pracuješ v Pythone alebo TypeScripte; a chceš manipulovať s typovanými objektmi namiesto anonymných slovníkov. Konkrétne, pipeline, ktorá celý deň klasifikuje support tickety pomocou rovnakých štyroch polí, nemá dôvod zostať v režime JSON.

To je v súlade s oficiálnou dokumentáciou Mistral, ktorá odporúča používať vlastné štruktúrované výstupy vždy, keď je to možné. Režim JSON zostáva dobrým vstupným bodom, ale vlastné výstupy ponúkajú vyššiu spoľahlivosť a výrazne znižujú množstvo kódu na overovanie na strane klienta.

Kľúčové poznatky

  • Režim JSON = zaručený platný JSON, voľná štruktúra, jednoduchá aktivácia
  • Vlastné štruktúrované výstupy = zaručená presná schéma, automatické parsovanie, ideálne pre produkciu
  • Začni s režimom JSON pri prototypovaní, pre produkciu prejdite na vlastné výstupy
  • Oba prístupy sa dopĺňajú, nie sa vzájomne vylučujú