Siirtyminen Magistralista
Tällä sivulla
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 aiemmin | Mistralin nimeämä korvaaja | Suosituksemme tänään |
|---|---|---|
| Magistral Small (1.0, 1.1, 1.2) | Mistral Small 4 | mistral-small-2603 asetuksella reasoning_effort="high" |
| Magistral Medium (1.0, 1.1, 1.2) | Mistral Medium 3.5 | Small 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:
- Mallitunnisteet: etsi koodistasi, konfiguraatiotiedostoistasi ja ympäristömuuttujistasi merkkijono
magistral. prompt_mode: päättelyä koskevassa dokumentaatiossa ei enää mainita tätä; poista se kutsuistasi.- Järjestelmäkehotteet: poista Magistral-spesifi päättelymalli (järjestelmäviestiin sijoitettu
thinking-katkelma) ja säilytä vain menetelmä- ja muotoiluohjeet (oppitunti 6). - Vastausten lukeminen: Magistral 25.07:n ja 25.09:n rakenne (
ThinkChunkja sen jälkeenTextChunk) vastaa nykyisiä malleja, joten lukukoodisi pysyy kelvollisena. Lisää kuitenkin käsittely pelkälle merkkijonotapaukselle, jonka Small 4 ja Medium 3.5 palauttavat, kunreasoning_effort="none". Jos koodisi periytyi Magistral 25.06:sta ja etsi tekstistä<think>-tageja, korvaa se oppitunnin 3separer-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_modeja päättelymalli järjestelmäkehotteista - Validoi todellisilla tapauksillasi (laatu, tokenit, viive) ja kiinnitä sen jälkeen päivättyjä tunnisteita