Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Način JSON naspram prilagođenih strukturiranih izlaza

Lekcija 2 od 12 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Dva pristupa, dvije filozofije
  2. Način JSON: fleksibilnost
  3. Prilagođeni strukturirani izlazi: rigoroznost
  4. Detaljna usporedba
  5. Donošenje odluke u praksi
  6. Ključne točke

Dva pristupa, dvije filozofije

Mistral API nudi dva različita mehanizma za generiranje strukturiranih izlaza. Oni se ne natječu; služe različitim fazama životnog ciklusa projekta. Tvoj izbor ovisi o tvom slučaju upotrebe, tvom tehnološkom stacku i razini pouzdanosti koju moraš održavati.

Način JSON: fleksibilnost

Način JSON najjednostavniji je pristup. U svoj zahtjev uključiš parametar i Mistral jamči da će izlaz biti valjani JSON. To je sve. Model ostaje slobodan odabrati strukturu: ključeve, tipove i dubinu ugnježđivanja. Kroz svoj prompt usmjeravaš željeni format, ali nikakva tehnička ograničenja ne vežu shemu.

# JSON Mode — the model chooses the structure
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"}
)

Ovaj minimalizam njegova je glavna snaga: samo jedan parametar za dodati, nema sheme koju treba unaprijed definirati i potpuna fleksibilnost kada istražuješ problem ili brzo izrađuješ prototip. Nedostatak je simetričan. Ništa ne jamči točnu strukturu JSON-a koji primaš: model može izostaviti polje, dodati drugo ili preimenovati ključ od jednog poziva do drugog. Stoga validacija na strani klijenta postaje obavezna, a to je kod koji moraš sam napisati i održavati.

Prilagođeni strukturirani izlazi: rigoroznost

Prilagođeni strukturirani izlazi prebacuju to ograničenje na stranu API-ja. Definiraš preciznu shemu—koristeći Pydantic u Pythonu ili Zod u TypeScriptu—i Mistral prisiljava model da se točno pridržava te sheme.

from pydantic import BaseModel

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

# Custom — the schema is enforced
response = client.chat.parse(
    model="mistral-large-latest",
    messages=[{"role": "user", "content": "Analyze this text."}],
    response_format=Analyse
)

Prednost je trenutna: svako je polje prisutno s ispravnim tipom i dobivaš natrag parsirani objekt spreman za upotrebu—instancu Pydantic ili Zod modela—s potpunim IDE autocompletionom. Ovo je način za proizvodnju i kritične pipelineove. Kompromis se svodi na jednu rečenicu: moraš unaprijed definirati podatkovni model, što istraživanje čini manje fleksibilnim i nameće malo početno opterećenje razvoja.

Detaljna usporedba

KriterijNačin JSONPrilagođeni strukturirani izlazi
Aktivacijaresponse_format: {"type": "json_object"}response_format: MyModel (Pydantic/Zod)
API metodaclient.chat.complete()client.chat.parse()
Jamstvo shemeNe — samo valjani JSONDa — točna shema je nametnuta
Automatsko parsiranjeNe — ručno json.loads()Da — .parsed vraća tipizirani objekt
FleksibilnostVisoka — slobodna strukturaNiska — fiksna struktura
Idealni slučaj upotrebePrototipovi, istraživanje, promjenjive shemeProizvodnja, kritični pipelineovi, API-ji
Potrebna validacijaDa — obavezna na strani klijentaMinimalna — shema obavlja posao

Donošenje odluke u praksi

Tri signala upućuju na Način JSON. Prvi je faza projekta: kada izrađuješ prototip i shema još nije stabilna, zaključavanje podatkovnog modela usporava te bez dodane vrijednosti. Drugi je priroda zadatka: ako se struktura izlaza legitimno mijenja ovisno o ulazu, kao u istraživačkoj analizi gdje relevantne dimenzije nisu unaprijed poznate, fiksna struktura bila bi okov. Treći je tehnički: u jeziku bez podrške za Pydantic ili Zod, Način JSON ostaje tvoja jedina ulazna točka.

Prilagođeni strukturirani izlazi preuzimaju kontrolu čim se situacija obrne. U proizvodnji si i neuspješna ekstrakcija ima stvarnu cijenu; shema izlaza je poznata i stabilna; radiš u Pythonu ili TypeScriptu; i želiš manipulirati tipiziranim objektima umjesto anonimnim rječnicima. Konkretno, pipeline koji cijeli dan klasificira tikete za podršku koristeći ista četiri polja nema razloga ostati u Načinu JSON.

To je u skladu sa službenom Mistral dokumentacijom, koja preporučuje korištenje Prilagođenih strukturiranih izlaza kad god je to moguće. Način JSON ostaje dobra ulazna točka, ali Prilagođeni izlazi nude superiornu pouzdanost i značajno smanjuju količinu koda za validaciju na strani klijenta.

Ključne točke

  • Način JSON = zajamčeno valjani JSON, slobodna struktura, jednostavno za omogućiti
  • Prilagođeni strukturirani izlazi = zajamčena točna shema, automatsko parsiranje, idealno za proizvodnju
  • Započni s Načinom JSON za prototipove, prijeđi na Prilagođene za proizvodnju
  • Dva su pristupa komplementarna, a ne međusobno isključiva