Zašto strukturirani izlazi?
Na ovoj stranici
Ažuriranje modela, 2. studenoga 2026. Mistral Large 3 (
mistral-large-2512) i Mistral Medium 3.5 povučeni su iz upotrebe 31. listopada 2026., a bit će trajno uklonjeni 30. travnja 2027. Njihov nasljednik, Mistral Large 4 (mistral-large-4), dostupan je u javnoj pretpreglednoj verziji od 6. listopada. Primjeri u ovom tečaju koriste aliasmistral-large-latest, koji prema službenoj specifikaciji (provjereno 3. studenoga 2026.) još uvijek upućuje na Mistral Large 3. Slično tome,mistral-medium-latestupućuje na Mistral Medium 3.5. Ovi aliasi ostat će valjani do 30. travnja 2027. Za nove projekte testirajmistral-large-4, njihovog namijenjenog nasljednika.
Problem s izlazima slobodnog formata
Kada jezični model postaviš u sredinu automatiziranog tijeka rada, brzo naiđeš na problem koji se rijetko pojavi prvog dana: njegov tekstualni odgovor je nepredvidiv. Isti podatak može biti formuliran na desetke različitih načina, a svaka varijacija prisiljava tvoj daljnji kod na drugačije parsiranje. Ono što funkcionira tijekom demonstracije, u proizvodnji puca, često tiho.
Uzmimo banalan zadatak. Tražiš od Mistrala da izvuče naziv proizvoda i cijenu iz komercijalnog opisa. Bez ograničenja, model može odgovoriti:
The product is called "Widget Pro" and costs €49.99.
Ili, za isti ulaz samo nekoliko sati kasnije:
Name: Widget Pro
Price: 49.99 EUR
Oba su odgovora točna za ljudskog čitatelja. Za tvoj kod, nemaju gotovo ništa zajedničko: decimalni separator promijenio se iz zareza u točku, simbol valute postao je ISO kod, a struktura rečenice nestala je. Svaka varijacija zahtijeva drugačiju logiku parsiranja. U proizvodnji to dovodi do tihih pogrešaka, slomljenih tijekova rada i sati debugiranja.
JSON: univerzalni format za tijekove rada
JSON rješava ovaj problem nametanjem strojno čitljive strukture. Istva ekstrakcija postaje nedvosmislena:
{
"name": "Widget Pro",
"price": 49.99,
"currency": "EUR"
}
Kod koji troši ovaj odgovor ponovno postaje jednostavan i pouzdan. Umjesto pisanja krhkog regularnog izraza, pišeš dvije stabilne linije:
import json
data = json.loads(response)
product_name = data["name"]
price = data["price"]
Nema više rizičnih regexa, nema više heurističkog parsiranja. JSON je de facto standard za komunikaciju između sustava, što ga čini prirodnim izborom za izlaze LLM-a u profesionalnim kontekstima.
Gdje se javlja potreba
Strukturirani izlazi postaju ključni čim odgovor modela napaja nešto drugo osim ekrana. Ekstrakcija informacija najizravniji je primjer: izvlačenje entiteta—imena, datuma, iznosa—iz nestrukturiranih dokumenata korisno je samo ako rezultat izravno ulazi u sustav. Klasifikacija slijedi istu logiku: kategorizacija tiketa za podršku, e-pošte ili recenzija kupaca zahtijeva da oznaka i njezina ocjena pouzdanosti stignu u predvidiva polja, a ne zakopane u rečenici.
Transformacija podataka ide korak dalje pretvaranjem slobodnog teksta u strukturirane zapise namijenjene bazi podataka. Agenti i lanci poziva jednako ovise o ovome: agent može orkestrirati tijek rada samo ako vrati strukturiranu radnju, s nazivom alata i njegovim parametrima u stabilnim ključevima. Konačno, LLM ponekad djeluje kao posrednički sloj ispred REST API-ja koji očekuje specifičan teret—u tom slučaju format nije pogodnost; to je ugovor.
Cijena neispravnih izlaza
U proizvodnji pouzdanost nije opcija, a neispravan izlaz košta te na tri načina. Sintaksno neispravan JSON ruši tvoju aplikaciju tijekom parsiranja, što je najvidljiviji scenarij, ali paradoksalno najmanje opasan. Nedostajuća polja tiho kvare tvoje podatke: zapis prolazi, ali je nepotpun, a problem ne izlazi na vidjelo tjednima kasnije. Neusklađeni tipovi—niz "42" gdje si očekivao broj 42—uzrokuju neočekivano ponašanje u daljnjim izračunima, a da pritom nikada ne pokrenu iznimku.
Mistralovi strukturirani izlazi rješavaju ova tri izazova s dva komplementarna mehanizma. JSON Mode jamči valjani JSON izlaz bez nametanja sheme: omogućuješ ga parametrom i usmjeravaš format putem prompta. Prilagođeni strukturirani izlazi idu dalje namećući preciznu shemu, opisanu koristeći Pydantic u Pythonu ili Zod u TypeScriptu.
Ovaj tečaj provest će te kroz oba pristupa. Naučit ćeš kako odabrati pravi za svoj slučaj upotrebe, napisati odgovarajući kod u oba jezika i rukovati slučajevima pogrešaka uz obrasce koji se održavaju u proizvodnji.
Ključne točke
- Izlazi slobodnog teksta nepredvidivi su i neprikladni za automatizirane tijekove rada
- JSON je standardni format za komunikaciju između strojeva
- Mistral nudi dva mehanizma za strukturirane izlaze: JSON Mode i Prilagođene strukturirane izlaze
- Pouzdanost izlaza ključna je u proizvodnji—strukturirani izlazi su ulaganje, a ne luksuz