Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Siirtyminen Magistralista

Oppitunti 8 / 12 Päivitetty 2. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Missä koodisi tilanne on?
  2. Vastaavuustaulukko
  3. Mitä koodissa muuttuu
  4. Migraation validointi
  5. Migraation hyödyntäminen parhaalla mahdollisella tavalla
  6. Keskeiset asiat

Oppitunti kirjoitettu uudelleen 2. marraskuuta 2026. Tämä oppitunti käsitteli alun perin Magistralin “jatkuvaa” päättelyä. Koska kaikki Magistral-mallit poistettiin käytöstä 31. heinäkuuta 2026, se käsittelee nyt siirtymistä arvoon reasoning_effort. Lähteet: Models — deprecated and removed models · Reasoning · Native reasoning (deprecated).

Missä koodisi tilanne on?

Viimeisimmät Magistral-versiot, Small 1.2 ja Medium 1.2 (-2509"), merkittiin vanhentuneiksi keväällä 2026 ja **poistettiin käytöstä 31. heinäkuuta 2026**; versiot 1.0 ja 1.1 oli jo poistettu käytöstä 30. marraskuuta 2025. Mikä tahansa koodi, joka edelleen kutsuu mallia magistral-small-latest, magistral-medium-latest` tai jotakin tämän perheen päivättyä tunnusta, kohdistuu malliin, jota ei enää ole olemassa. Migraatio ei ole enää suunniteltava asia – se on tehtävä nyt.

Vastaavuustaulukko

Käytit aiemminMistralin nimeämä korvaajaSuosituksemme tänään
Magistral Small (1.0, 1.1, 1.2)Mistral Small 4mistral-small-2603 asetuksella reasoning_effort="high"
Magistral Medium (1.0, 1.1, 1.2)Mistral Medium 3.5Small 4, jos laatu riittää, muuten mistral-large-4-0 asetuksella reasoning_effort="high"

Miksi emme seuraa Magistral Mediumille nimettyä korvaajaa kirjaimellisesti? Koska Mistral Medium 3.5 on itse vanhentunut 31. lokakuuta 2026 alkaen, ja sen poistaminen on suunniteltu 30. huhtikuuta 2027, jolloin Large 4 ottaa sen paikan. Siihen siirtyminen tarkoittaa sitoutumista toiseen migraatioon kuuden kuukauden kuluttua. Large 4 on julkisessa esiversiossa (Public Preview): jos tämä kypsyystaso ei sovi tuotantoympäristöösi, Medium 3.5 voi olla mahdollinen välivaihe, edellyttäen että suunnittelet seuraavan vaihdon jo nyt.

Mitä koodissa muuttuu

Magistral päätteli aina; nykyiset mallit päättelevät vain, kun niitä niin pyydetään. Luonnollinen vastine “jatkuvasti päällä” -tilalle on siis reasoning_effort="high".

# Ennen: Magistral (poistettu käytöstä)
response = client.chat.complete(
    model="magistral-medium-latest",
    messages=[
        {"role": "system", "content": "You are a rigorous analyst."},
        {"role": "user", "content": question},
    ],
    prompt_mode=None,   # poisti Magistralin oletusjärjestelmäkehotteen
)

# Jälkeen: Mistral Large 4 eksplisiittisellä päättelyllä
response = client.chat.complete(
    model="mistral-large-4-0",
    messages=[
        {"role": "system", "content": "You are a rigorous analyst."},
        {"role": "user", "content": question},
    ],
    reasoning_effort="high",
)

Neljä asiaa, jotka on hoidettava matkan varrella:

  1. Mallitunnisteet: etsi koodistasi, konfiguraatiotiedostoistasi ja ympäristömuuttujistasi merkkijono magistral.
  2. prompt_mode: päättelyä koskevassa dokumentaatiossa ei enää mainita tätä; poista se kutsuistasi.
  3. Järjestelmäkehotteet: poista Magistral-spesifi päättelymalli (järjestelmäviestiin sijoitettu thinking-katkelma) ja säilytä vain menetelmä- ja muotoiluohjeet (oppitunti 6).
  4. Vastausten lukeminen: Magistral 25.07:n ja 25.09:n rakenne (ThinkChunk ja sen jälkeen TextChunk) vastaa nykyisiä malleja, joten lukukoodisi pysyy kelvollisena. Lisää kuitenkin käsittely pelkälle merkkijonotapaukselle, jonka Small 4 ja Medium 3.5 palauttavat, kun reasoning_effort="none". Jos koodisi periytyi Magistral 25.06:sta ja etsi tekstistä <think>-tageja, korvaa se oppitunnin 3 separer-funktiolla.

Migraation validointi

Älä vaihda sokeasti. Toista otos todellisista käyttötapauksistasi yhdessä vertailuvastausten kanssa ja vertaile kolmea mittaria: laatua (tarkkuus, muodon noudattaminen), kulutettuja tokeneita (usage.completion_tokens) ja viivettä. Yksinkertainen skripti hoitaa työn:

import time

def comparer(client, cas, configs):
    """cas: lista pareja (kysymys, verifier); configs: lista pareja (malli, taso)."""
    for model, niveau in configs:
        justes = tokens = 0
        debut = time.perf_counter()
        for question, verifier in cas:
            r = client.chat.complete(
                model=model,
                messages=[{"role": "user", "content": question}],
                reasoning_effort=niveau,
            )
            _, reponse = separer(r.choices[0].message.content)
            justes += bool(verifier(reponse))
            tokens += r.usage.completion_tokens
        duree = time.perf_counter() - debut
        print(f"{model} ({niveau}) : {justes}/{len(cas)} oikein, {tokens} tokenia, {duree:.0f} s")

comparer(client, mes_cas, [
    ("mistral-small-2603", "high"),
    ("mistral-large-4-0", "medium"),
    ("mistral-large-4-0", "high"),
])

Funktio verifier riippuu toimialastasi: vertailu odotettuun arvoon, vaadittujen elementtien olemassaolo tai JSON-validointi. Tämä on se, mikä muuttaa vaikutelman päätökseksi.

Migraation hyödyntäminen parhaalla mahdollisella tavalla

Koska kosket joka tapauksessa jokaista mallikutsua, käytä tätä tilaisuutta kiinnittääksesi päivättyjä tunnisteita tuotannossa (mistral-small-2603 eikä mistral-small-latest) ja keskittääksesi mallin ja päättelytason valinnan yhteen konfiguraatioon. Seuraava vanhentuminen – ja sellainen tulee – on silloin yhden rivin korjaus.

Keskeiset asiat

  • Magistral poistettiin käytöstä 31. heinäkuuta 2026: kaikki jäljellä olevat kutsut kohdistuvat saatavilla olevaan malliin
  • Magistral Small → Small 4; Magistral Medium → Small 4 tai Large 4 eikä Medium 3.5, joka on itse vanhentunut
  • “Jatkuvasti päällä” tarkoittaa asetusta reasoning_effort="high"
  • Poista prompt_mode ja päättelymalli järjestelmäkehotteista
  • Validoi todellisilla tapauksillasi (laatu, tokenit, viive) ja kiinnitä sen jälkeen päivättyjä tunnisteita