Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Áttérés a Magistralról

8. lecke 12 közül Frissítve 2026. november 2. Fejlesztő
Ezen az oldalon
  1. Hol tart a kódod?
  2. A megfeleltetési táblázat
  3. Mi változik a kódban?
  4. A migráció ellenőrzése
  5. A migráció teljes kihasználása
  6. Főbb megállapítások

Lecke átírva: 2026. november 2. Ez a lecke eredetileg a Magistral „folyamatos“ gondolkodási módját írta le. Mivel minden Magistral modellt 2026. július 31-én kivontak a forgalomból, most a reasoning_effort paraméterre való átállást tárgyaljuk. Források: Models — deprecated and removed models · Reasoning · Native reasoning (deprecated).

Hol tart a kódod?

A legfrissebb Magistral verziók, a Small 1.2 és a Medium 1.2 (-2509) már 2026 tavaszán elavulttá váltak, és 2026. július 31-én teljesen kivonták őket; az 1.0 és 1.1 verziókat még korábban, 2025. november 30-án szüntették meg. Minden olyan kód, amely még mindig a magistral-small-latest, magistral-medium-latest vagy e család valamely dátumozott azonosítóját hívja meg, egy már nem létező modellt céloz meg. A migráció nem valami, amit majd tervezni kell – ezt most kell végrehajtanod.

A megfeleltetési táblázat

Ezt használtadA Mistral által javasolt utódAmit ma ajánlunk
Magistral Small (1.0, 1.1, 1.2)Mistral Small 4mistral-small-2603 a reasoning_effort="high" paraméterrel
Magistral Medium (1.0, 1.1, 1.2)Mistral Medium 3.5Small 4, ha a minőség megfelel, különben mistral-large-4-0 a reasoning_effort="high" paraméterrel

Miért nem követjük betűről betűre a Mistral által a Magistral Mediumhoz javasolt utódot? Mert a Mistral Medium 3.5 maga is elavult 2026. október 31-től, a kivonása 2027. április 30-ra van ütemezve, utódja pedig a Large 4. Erre való átállás azt jelentené, hogy hat hónapon belül egy újabb migrációt kell végrehajtanod. A Large 4 jelenleg nyilvános előzetes verzióban (Public Preview) érhető el: ha ez az érettségi szint nem felel meg a production környezetednek, a Medium 3.5 továbbra is lehetséges köztes megoldás, feltéve, hogy most ütemezed a következő váltást.

Mi változik a kódban?

A Magistral mindig gondolkodott; a jelenlegi modellek csak akkor, ha kéred tőlük. A „folyamatos“ mód természetes megfelelője ezért a reasoning_effort="high" beállítás.

# Előtte: Magistral (kivont)
response = client.chat.complete(
    model="magistral-medium-latest",
    messages=[
        {"role": "system", "content": "You are a rigorous analyst."},
        {"role": "user", "content": question},
    ],
    prompt_mode=None,   # letiltotta a Magistral alapértelmezett rendszer-promptját
)

# Utána: Mistral Large 4 explicit gondolkodással
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",
)

Négy dolgot kell kezelned az átállás során:

  1. Modellazonosítók: keress rá a magistral kifejezésre a kódodban, konfigurációs fájljaiban és környezeti változóiban.
  2. prompt_mode: a gondolkodással kapcsolatos dokumentáció már nem említi; távolítsd el a hívásokból.
  3. Rendszer-promptok: töröld a Magistral-specifikus gondolkodási sablont (a rendszerüzenetbe helyezett thinking fragmentumot), és tartsd meg csak a módszerre és formátumra vonatkozó utasításokat (6. lecke).
  4. Válaszok olvasása: a Magistral 25.07 és 25.09 verzióiból származó struktúra (ThinkChunk, majd TextChunk) megegyezik a jelenlegi modellekével, így az olvasó kódod érvényes marad. Csak a sima sztring esetének kezelését kell hozzáadnod, amelyet a Small 4 és a Medium 3.5 ad vissza, ha reasoning_effort="none". Ha a kódod a Magistral 25.06 verziójából származott, és a szövegben <think> címkéket keresett, cseréld le a 3. leckében található separer függvényre.

A migráció ellenőrzése

Ne válts vakon. Játssz le egy mintát a valós eseteidből a hozzájuk tartozó referenciaválaszokkal együtt, és hasonlítsd össze a három metrikát: minőség (pontosság, formátum-megfelelés), felhasznált tokenek (usage.completion_tokens) és késleltetés. Egy egyszerű script elvégzi a munkát:

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"),
])

A verifier függvény a te doménedtől függ: összehasonlítás egy várt értékkel, szükséges elemek jelenlétének ellenőrzése vagy JSON validálás. Ez az, ami az benyomást döntéssé alakítja.

A migráció teljes kihasználása

Mivel úgyis módosítanod kell minden modellhívást, használd ki ezt az alkalmat arra, hogy a production környezetben rögzítsd a dátumozott azonosítókat (mistral-small-latest helyett mistral-small-2603), és centralizáld a modell és a gondolkodási szint választását egyetlen konfigurációban. Így a következő elavulás – és lesz ilyen – csupán egy soros javítás lesz.

Főbb megállapítások

  • A Magistralt 2026. július 31-én kivonták: minden megmaradt hívás egy nem elérhető modellt céloz meg
  • Magistral Small → Small 4; Magistral Medium → Small 4 vagy Large 4, nem pedig Medium 3.5, amely maga is elavult
  • A „folyamatos“ mód megfelelője: reasoning_effort="high"
  • Távolítsd el a prompt_mode paramétert és a gondolkodási sablont a rendszer-promptokból
  • Ellenőrizd a migrációt valós eseteken (minőség, tokenek, késleltetés), majd rögzítsd a dátumozott azonosítókat