Áttérés a Magistralról
Ezen az oldalon
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_effortparamé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áltad | A Mistral által javasolt utód | Amit ma ajánlunk |
|---|---|---|
| Magistral Small (1.0, 1.1, 1.2) | Mistral Small 4 | mistral-small-2603 a reasoning_effort="high" paraméterrel |
| Magistral Medium (1.0, 1.1, 1.2) | Mistral Medium 3.5 | Small 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:
- Modellazonosítók: keress rá a
magistralkifejezésre a kódodban, konfigurációs fájljaiban és környezeti változóiban. prompt_mode: a gondolkodással kapcsolatos dokumentáció már nem említi; távolítsd el a hívásokból.- Rendszer-promptok: töröld a Magistral-specifikus gondolkodási sablont (a rendszerüzenetbe helyezett
thinkingfragmentumot), és tartsd meg csak a módszerre és formátumra vonatkozó utasításokat (6. lecke). - Válaszok olvasása: a Magistral 25.07 és 25.09 verzióiból származó struktúra (
ThinkChunk, majdTextChunk) 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, hareasoning_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óseparerfü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_modeparamé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