Selitev z modelov Magistral
Na tej strani
Lekcija je bila prepisana 2. novembra 2026. Ta lekcija je prvotno opisovala stalno sklepanje modelov Magistral. Ker so bili vsi modeli Magistral umaknjeni 31. julija 2026, zdaj pokriva selitev na
reasoning_effort. Viri: Models — deprecated and removed models · Reasoning · Native reasoning (deprecated).
Kje stoji tvoja koda?
Najnovejše različice modelov Magistral, Small 1.2 in Medium 1.2 (-2509), so bile opuščene spomladi 2026 in uradno umaknjene 31. julija 2026; različici 1.0 in 1.1 sta bili umaknjeni že 30. novembra 2025. Vsaka koda, ki še vedno kliče magistral-small-latest, magistral-medium-latest ali datiran identifikator iz te družine, cilja na model, ki ne obstaja več. Selitev ni več nekaj, kar bi načrtovali – nekaj je, kar morate storiti zdaj.
Presledna tabela
| Ste uporabljali | Določena zamenjava pri Mistralu | Kar danes priporočamo |
|---|---|---|
| Magistral Small (1.0, 1.1, 1.2) | Mistral Small 4 | mistral-small-2603 z reasoning_effort="high" |
| Magistral Medium (1.0, 1.1, 1.2) | Mistral Medium 3.5 | Small 4, če je kakovost zadostna, sicer mistral-large-4-0 z reasoning_effort="high" |
Zakaj ne bi do črke sledili določeni zamenjavi Mistrala za Magistral Medium? Ker je Mistral Medium 3.5 sam opuščen od 31. oktobra 2026, z načrtovanim umikom 30. aprila 2027, njegov naslednik pa je Large 4. Selitev nanj pomeni zavezo k drugi selitvi šest mesecev pozneje. Large 4 je v javnem predogledu: če ta stopnja zrelosti ne ustreza vašemu produkcijskemu okolju, ostaja Medium 3.5 možen vmesni korak, pod pogojem, da zdaj načrtujete naslednji preklop.
Kaj se spremeni v kodi
Magistral je vedno sklepal; trenutni modeli sklepajo le, ko jih to prosite. Naravni ekvivalent „stalno vklopljeno” je zato reasoning_effort="high".
# Pred: Magistral (umaknjen)
response = client.chat.complete(
model="magistral-medium-latest",
messages=[
{"role": "system", "content": "You are a rigorous analyst."},
{"role": "user", "content": question},
],
prompt_mode=None, # onemogočen privzeti sistemski poziv Magistrala
)
# Po: Mistral Large 4 z eksplicitnim sklepanjem
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",
)
Štiri postavke, ki jih je treba obravnavati na poti:
- Identifikatorji modelov: v svoji kodi, konfiguracijskih datotekah in okoljskih spremenljivkah poiščite niz
magistral. prompt_mode: dokumentacija o sklepanju ga ne omenja več; odstranite ga iz svojih klicev.- Sistemski pozivi: izbrišite predlogo za sklepanje, specifično za Magistral (delček
thinking, postavljen v sistemsko sporočilo), in ohranite le navodila za metodo in obliko (lekcija 6). - Branje odgovorov: struktura iz Magistral 25.07 in 25.09 (
ThinkChunknatoTextChunk) ustreza trenutnim modelom, zato vaša koda za branje ostane veljavna. Dodajte le obravnavo primera z navadnim nizom, ki ga Small 4 in Medium 3.5 vrneta, ko jereasoning_effort="none". Če je vaša koda izhajala iz Magistral 25.06 in iskala značke<think>v besedilu, jo nadomestite s funkcijosepareriz lekcije 3.
Preverjanje selitve
Ne preklopite slepo. Ponovno zaženite vzorec svojih primerov iz resničnega sveta skupaj z njihovimi referenčnimi odgovori in primerjajte tri metrike: kakovost (točnost, skladnost z obliko), porabljene žetone (usage.completion_tokens) in zakasnitev. Preprosta skripta opravi delo:
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"),
])
Funkcija verifier je odvisna od vaše domene: primerjava s pričakovano vrednostjo, prisotnost zahtevanih elementov ali validacija JSON. To je tisto, kar vtis spremeni v odločitev.
Izkoristite selitev do konca
Ker se tako ali tako dotikate vsakega klica modela, izkoristite to priložnost za priklep datiranih identifikatorjev v produkciji (mistral-small-2603 namesto mistral-small-latest) in za centralizacijo izbire modela in ravni sklepanja v eno samo konfiguracijo. Naslednja opustitev – in takšna bo še prišla – bo potem popravilo v eni vrstici.
Ključne ugotovitve
- Magistral je bil umaknjen 31. julija 2026: vsak preostali klic cilja na nedostopen model
- Magistral Small → Small 4; Magistral Medium → Small 4 ali Large 4 namesto Medium 3.5, ki je sam opuščen
- „Stalno vklopljeno” se prevede v
reasoning_effort="high" - Odstranite
prompt_modein predlogo za sklepanje iz sistemskih pozivov - Preverite na svojih resničnih primerih (kakovost, žetoni, zakasnitev), nato priklenite datirane identifikatorje