Migrarea de la Magistral
Pe această pagină
Lecție rescrisă la 2 noiembrie 2026. Această lecție descria inițial raționamentul „permanent activ“ al lui Magistral. Deoarece toate modelele Magistral au fost retrase la 31 iulie 2026, aceasta acoperă acum migrarea către
reasoning_effort. Surse: Models — deprecated and removed models · Reasoning · Native reasoning (deprecated).
Unde se află codul dumneavoastră?
Ultimele versiuni Magistral, Small 1.2 și Medium 1.2 (-2509), au fost depreciate în primăvara anului 2026 și retrase la 31 iulie 2026; versiunile 1.0 și 1.1 fuseseră deja retrase la 30 noiembrie 2025. Orice cod care apelează încă magistral-small-latest, magistral-medium-latest sau un identificator datat din această familie țintește un model care nu mai există. Migrarea nu mai este ceva de planificat, ci ceva de făcut acum.
Tabelul de corespondență
| Utilizați anterior | Înlocuitorul desemnat de Mistral | Ce recomandăm astăzi |
|---|---|---|
| Magistral Small (1.0, 1.1, 1.2) | Mistral Small 4 | mistral-small-2603 cu reasoning_effort="high" |
| Magistral Medium (1.0, 1.1, 1.2) | Mistral Medium 3.5 | Small 4 dacă calitatea este suficientă, altfel mistral-large-4-0 cu reasoning_effort="high" |
De ce să nu urmați întocmai înlocuitorul desemnat de Mistral pentru Magistral Medium? Deoarece Mistral Medium 3.5 este el însuși depreciat începând cu 31 octombrie 2026, cu retragerea programată pentru 30 aprilie 2027, iar Large 4 fiind succesorul său. Migrarea către acesta înseamnă angajarea într-o a doua migrare peste șase luni. Large 4 se află în Public Preview: dacă acest nivel de maturitate nu se potrivește mediului dumneavoastră de producție, Medium 3.5 rămâne o posibilă etapă intermediară, cu condiția să programați acum următoarea comutare.
Ce se schimbă în cod
Magistral raționa întotdeauna; modelele actuale raționează doar atunci când le cereți. Echivalentul natural al „permanent activ“ este, prin urmare, reasoning_effort="high".
# Înainte: Magistral (retras)
response = client.chat.complete(
model="magistral-medium-latest",
messages=[
{"role": "system", "content": "You are a rigorous analyst."},
{"role": "user", "content": question},
],
prompt_mode=None, # dezactiva promptul implicit de sistem al Magistral
)
# După: Mistral Large 4 cu raționament explicit
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",
)
Patru aspecte de abordat pe parcurs:
- Identificatorii modelului: căutați
magistralîn codul, fișierele de configurare și variabilele de mediu. prompt_mode: documentația despre raționament nu îl mai menționează; eliminați-l din apeluri.- Prompturi de sistem: ștergeți șablonul de raționament specific Magistral (fragmentul
thinkingplasat în mesajul de sistem) și păstrați doar instrucțiunile de metodă și format (Lecția 6). - Citirea răspunsurilor: structura din Magistral 25.07 și 25.09 (
ThinkChunkapoiTextChunk) corespunde modelelor actuale, deci codul de citire rămâne valabil. Adăugați doar gestionarea cazului șir simplu, pe care Small 4 și Medium 3.5 îl returnează cândreasoning_effort="none". Dacă codul dumneavoastră provenea de la Magistral 25.06 și căuta tag-uri<think>în text, înlocuiți-l cu funcțiaseparerdin Lecția 3.
Validarea migrării
Nu comutați orbește. Reexecutați un eșantion de cazuri reale, împreună cu răspunsurile lor de referință, și comparați trei metrici: calitatea (acuratețe, conformitate cu formatul), tokenii consumați (usage.completion_tokens) și latența. Un script simplu face treaba:
import time
def comparer(client, cas, configs):
"""cas: listă de (întrebare, verifier); configs: listă de (model, nivel)."""
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)} corect, {tokens} tokeni, {duree:.0f} s")
comparer(client, mes_cas, [
("mistral-small-2603", "high"),
("mistral-large-4-0", "medium"),
("mistral-large-4-0", "high"),
])
Funcția verifier depinde de domeniul dumneavoastră: compararea cu o valoare așteptată, prezența elementelor requise sau validarea JSON. Aceasta este ceea ce transformă o impresie într-o decizie.
Valorificarea la maximum a migrării
Deoarece modificați oricum fiecare apel de model, profitați de această oportunitate pentru a fixa identificatorii datați în producție (mistral-small-2603 în loc de mistral-small-latest) și pentru a centraliza alegerea modelului și a nivelului de raționament într-o singură configurare. Următoarea depreciere—și va exista una—va fi atunci o remediere dintr-o singură linie.
Puncte cheie
- Magistral a fost retras la 31 iulie 2026: orice apel rămas țintește un model indisponibil
- Magistral Small → Small 4; Magistral Medium → Small 4 sau Large 4, mai degrabă decât Medium 3.5, care este el însuși depreciat
- „Permanent activ“ se traduce prin
reasoning_effort="high" - Eliminați
prompt_modeși șablonul de raționament din prompturile de sistem - Validați pe cazurile dumneavoastră reale (calitate, tokeni, latență), apoi fixați identificatorii datați