Üleminek Magistralilt
Sellel lehel
Õppetund kirjutati 2. novembril 2026 ümber. Algselt kirjeldas see tund Magistrali „pidevat“ põhjendamist. Kuna kõik Magistrali mudelid suleti 31. juulil 2026, käsitleb see nüüd üleminekut parameetrile
reasoning_effort. Allikad: Models — deprecated and removed models · Reasoning · Native reasoning (deprecated).
Kus su kood praegu seisab?
Viimased Magistrali versioonid, Small 1.2 ja Medium 1.2 (-2509), tunnistati 2026. aasta kevadel iganenuks ja suleti 31. juulil 2026; versioonid 1.0 ja 1.1 olid juba suletud 30. novembril 2025. Igasugune kood, mis kutsub endiselt magistral-small-latest, magistral-medium-latest või selle pere kuupäevaga identifikaatorit, suunab mudelile, mida enam ei eksisteeri. Üleminek ei ole enam midagi, mida planeerida – see on midagi, mida tuleb teha kohe.
Vastavustabel
| Sa kasutasid | Mistrali määratud asendaja | Mida me täna soovitame |
|---|---|---|
| Magistral Small (1.0, 1.1, 1.2) | Mistral Small 4 | mistral-small-2603 koos reasoning_effort="high" |
| Magistral Medium (1.0, 1.1, 1.2) | Mistral Medium 3.5 | Small 4, kui kvaliteet sobib, vastasel juhul mistral-large-4-0 koos reasoning_effort="high" |
Miks mitte järgida Mistrali määratud asendajat Magistral Mediumile täpselt? Sest Mistral Medium 3.5 on ise iganenud alates 31. oktoobrist 2026 ja selle sulgemine on planeeritud 30. aprilliks 2027, kus selle järeltulijaks on Large 4. Sellele üleminek tähendab kohustust teha kuue kuu pärast teine üleminek. Large 4 on avalikus eelvaates: kui see küpsustase ei sobi sinu tootmiskeskkonda, jääb Medium 3.5 võimalikuks vaheastmeks, eeldusel, et planeerid järgmise vahetuse juba praegu.
Mis muutub koodis
Magistral põhjendas alati; praegused mudelid põhjendavad ainult siis, kui sa neid selleks palud. Loomulik vaste „pidevale“ režiimile on seetõttu reasoning_effort="high".
# Enne: Magistral (suletud)
response = client.chat.complete(
model="magistral-medium-latest",
messages=[
{"role": "system", "content": "You are a rigorous analyst."},
{"role": "user", "content": question},
],
prompt_mode=None, # keelas Magistrali vaikimisi süsteemse vihje
)
# Pärast: Mistral Large 4 koos selge põhjendamisega
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",
)
Neli punkti, millele tähelepanu pöörata:
- Mudeli identifikaatorid: otsi oma koodist, konfiguratsioonifailidest ja keskkonnamuutujatest sõna
magistral. prompt_mode: põhjendamise dokumentatsioonis seda enam ei mainita; eemalda see oma väljakutsetest.- Süsteemsed vihjed: kustuta Magistrali-spetsiifiline põhjendamise mall (süsteemsõnumisse paigutatud
thinkingfragment) ja säilita ainult meetodi ning vormingu juhised (6. õppetund). - Vastuste lugemine: Magistrali 25.07 ja 25.09 struktuur (
ThinkChunk, seejärelTextChunk) kattub praeguste mudelitega, seega jääb sinu lugemiskood kehtivaks. Lisa vaid tavalise stringi juhtumi käsitlemine, mida Small 4 ja Medium 3.5 tagastavad, kuireasoning_effort="none". Kui su kood pärines Magistrali 25.06 versioonist ja otsis tekstist<think>sildid, asenda see 3. õppetunnist pärit funktsioonigaseparer.
Ülemineku valideerimine
Ära vaheta pimesi. Käivita uuesti valik oma reaalsetest juhtumitest koos nende võrdlusvastustega ja võrdle kolme näitajat: kvaliteet (täpsus, vormingu järgimine), tarbitud tokenid (usage.completion_tokens) ja latentsus. Lihtne skript teeb selle töö ära:
import time
def comparer(client, cas, configs):
"""cas: list of (question, verifier); configs: list of (model, level)."""
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)} correct, {tokens} tokens, {duree:.0f} s")
comparer(client, mes_cas, [
("mistral-small-2603", "high"),
("mistral-large-4-0", "medium"),
("mistral-large-4-0", "high"),
])
Funktsioon verifier sõltub sinu valdkonnast: võrdlus oodatava väärtusega, nõutavate elementide olemasolu või JSON-i valideerimine. See on see, mis muudab mulje otsuseks.
Ülemineku maksimaalne ärakasutamine
Kui niikuinii puudutad iga mudelikutset, kasuta seda võimalust, et lukustada tootmises kuupäevaga identifikaatorid (mistral-small-2603 asemel mistral-small-latest) ja tsentraliseerida mudeli ning põhjendamise taseme valik ühte konfiguratsiooni. Järgmine iganemine – ja neid tuleb veel – on siis üherealine parandus.
Peamised punktid
- Magistral suleti 31. juulil 2026: iga allesjäänud kutse suunab kättesaamatule mudelile
- Magistral Small → Small 4; Magistral Medium → Small 4 või Large 4, mitte Medium 3.5, mis on ise iganenud
- „Pidev“ režiim tõlgitakse kui
reasoning_effort="high" - Eemalda
prompt_modeja põhjendamise mall süsteemsetest vihjetest - Valideeri oma reaalsetel juhtumitel (kvaliteet, tokenid, latentsus) ja seejärel lukusta kuupäevaga identifikaatorid