Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Miks struktureeritud väljundid?

Õppetund 1 / 12 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Vabavormiliste väljundite probleem
  2. JSON: universaalne formaat töövoogude jaoks
  3. Kus tekib vajadus
  4. Vigaste väljundite hind
  5. Peamised punktid

Mudeli värskendus, 2. november 2026. Mistral Large 3 (mistral-large-2512) ja Mistral Medium 3.5 tunnistati aegunuks 31. oktoobril 2026 ning need eemaldatakse kasutusest 30. aprillil 2027. Nende määratud järeltulija, Mistral Large 4 (mistral-large-4), on olnud avalikus eelvaates alates 6. oktoobrist. Selles kursuses kasutatavad näited põhinevad aliassel mistral-large-latest, mis viitab ametliku spetsifikatsiooni kohaselt endiselt Mistral Large 3-le (kontrollitud 3. novembril 2026). Samuti viitab alias mistral-medium-latest mudelile Mistral Medium 3.5. Need aliasse kehtivad kuni 30. aprillini 2027. Uute projektide puhul testi mistral-large-4, nende määratud järeltulijat.

Vabavormiliste väljundite probleem

Kui paigutad keelemudeli automatiseeritud töövoogu, kohtad kiiresti probleemi, mis esimesel päeval harva ilmneb: selle vaba tekstina genereeritud vastus on ettearvamatu. Sama teavet võib väljendada kümnetel erinevatel viisidel ja iga variatsioon sunnib sinu järgnevat koodi seda erinevalt parsima. See, mis toimib demo ajal, laguneb tootmiskeskkonnas, sageli vaikselt.

Võtame ühe banaalse ülesande. Palud Mistralil eraldada tootenime ja hinna ärikirjeldusest. Ilma piiranguteta võib mudel vastata nii:

Toote nimi on "Widget Pro" ja hind on 49,99 €.

Või sama sisendi puhul vaid mõni tund hiljem:

Nimi: Widget Pro
Hind: 49.99 EUR

Mõlemad vastused on inimlugeja jaoks õiged. Sinu koodi jaoks pole neil aga peaaegu midagi ühist: kümnendmärk muutus komast punktiks, valuutasümbol asendus ISO-koodiga ja lausestruktuur kadus. Iga variatsioon nõuab erinevat parsimisloogikat. Tootmiskeskkonnas viib see vaiksete vigadeni, katkenud töövoogudeni ja tundidepikkuse veaotsinguni.

JSON: universaalne formaat töövoogude jaoks

JSON lahendab selle probleemi, sundides peale masinloetava struktuuri. Sama eraldamine muutub üheselt mõistetavaks:

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

Seda vastust tarbiv kood muutub taas lihtsaks ja usaldusväärseks. Habraste regulaaravaldiste kirjutamise asemel kirjutad kaks stabiilset rida:

import json

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

Enam pole riskantseid regex’e ega heuristilist parsimist. JSON on de facto standard süsteemidevaheliseks suhtluseks, muutes selle loomulikuks valikuks LLM-i väljunditele professionaalses kontekstis.

Kus tekib vajadus

Struktureeritud väljundid muutuvad hädavajalikuks niipea, kui mudeli vastus toidab midagi muud kui ekraani. Teabe eraldamine on kõige otsesem näide: üksuste (nimed, kuupäevad, summad) väljatõmbamine struktureerimata dokumentidest on kasulik ainult siis, kui tulemus jõuab otse süsteemi. Klassifitseerimine järgib sama loogikat: tugipiletite, meilide või kliendiarvamuste kategoriseerimine nõuab, et silt ja selle usaldusväärsuse skoor saabuksid ennustatavatesse väljadesse, mitte ei oleks peidetud lausesse.

Andmete teisendamine viib selle veelgi kaugemale, muutes vaba teksti struktureeritud kirjeteks, mis on mõeldud andmebaasi. Agendid ja kõneahelad sõltuvad sellest sama palju: agent saab töövoogu orkestreerida ainult siis, kui ta tagastab struktureeritud tegevuse, kus tööriista nimi ja selle parameetrid asuvad stabiilsetes võtmetes. Lõpuks toimib LLM mõnikord vahendajana REST API ees, mis ootab kindlat kasulikku koormust – sel juhul pole formaat mitte mugavus, vaid leping.

Vigaste väljundite hind

Tootmiskeskkonnas pole usaldusväärsus valikuline ja vigane väljund maksab sulle kolmel viisil. Süntaktiliselt vigane JSON krahhitab sinu rakenduse parsimise ajal; see on kõige nähtavam stsenaarium, kuid paradoksaalselt kõige vähem ohtlik. Puuduvad väljad rikuvad sinu andmeid vaikselt: kirje läbib kontrolli, kuid on puudulik, ja probleem ei tule ilmsiks alles nädalaid hiljem. Sobimatud tüübid – string "42" seal, kus ootasid arvu 42 – põhjustavad järgnevates arvutustes ootamatut käitumist, tõstmata kunagi erandit.

Mistrali struktureeritud väljundid lahendavad need kolm väljakutset kahe täiendava mehhanismiga. JSON-režiim garanteerib kehtiva JSON-väljundi ilma skeemi sundimata: lubad selle parameetriga ja juhendad formaati vihje (prompt) kaudu. Kohandatud struktureeritud väljundid lähevad kaugemale, sundides peale täpse skeemi, mida kirjeldatakse Pythonis Pydanticu või TypeScriptis Zodiga.

See kursus viib sind läbi mõlema lähenemisviisi. Õpid valima oma kasutusjuhu jaoks õiget, kirjutama vastava koodi mõlemas keeles ja käsitlema veajuhtumeid mustritega, mis peavad vastu tootmiskeskkonnas.

Peamised punktid

  • Vaba tekstina väljundid on ettearvamatud ja ei sobi automatiseeritud töövoogude jaoks
  • JSON on standardformaadiks masinatevaheliseks suhtluseks
  • Mistral pakub struktureeritud väljundite jaoks kahte mehhanismi: JSON-režiim ja kohandatud struktureeritud väljundid
  • Väljundi usaldusväärsus on tootmiskeskkonnas kriitiline – struktureeritud väljundid on investeering, mitte luks