Salt la conținutul principal
Română— Alege o limbă
Meniu

Migrarea de la Magistral

Lecția 8 din 12 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Unde se află codul dumneavoastră?
  2. Tabelul de corespondență
  3. Ce se schimbă în cod
  4. Validarea migrării
  5. Valorificarea la maximum a migrării
  6. Puncte cheie

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 MistralCe recomandăm astăzi
Magistral Small (1.0, 1.1, 1.2)Mistral Small 4mistral-small-2603 cu reasoning_effort="high"
Magistral Medium (1.0, 1.1, 1.2)Mistral Medium 3.5Small 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:

  1. Identificatorii modelului: căutați magistral în codul, fișierele de configurare și variabilele de mediu.
  2. prompt_mode: documentația despre raționament nu îl mai menționează; eliminați-l din apeluri.
  3. Prompturi de sistem: ștergeți șablonul de raționament specific Magistral (fragmentul thinking plasat în mesajul de sistem) și păstrați doar instrucțiunile de metodă și format (Lecția 6).
  4. Citirea răspunsurilor: structura din Magistral 25.07 și 25.09 (ThinkChunk apoi TextChunk) 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ând reasoning_effort="none". Dacă codul dumneavoastră provenea de la Magistral 25.06 și căuta tag-uri <think> în text, înlocuiți-l cu funcția separer din 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