Migracija s Magistrala
Na ovoj stranici
Lekcija je ponovno napisana 2. studenoga 2026. Ova je lekcija izvorno opisivala Magistralovo razmišljanje koje je uvijek bilo uključeno („always-on“). Budući da su svi modeli Magistral povučeni 31. srpnja 2026., sada pokriva migraciju na
reasoning_effort. Izvori: Models — deprecated and removed models · Reasoning · Native reasoning (deprecated).
Gdje se nalazi tvoj kod?
Najnovije verzije Magistrala, Small 1.2 i Medium 1.2 (-2509), zastarjele su u proljeće 2026. i povučene 31. srpnja 2026.; verzije 1.0 i 1.1 već su povučene 30. studenoga 2025. Svaki kod koji još uvijek poziva magistral-small-latest, magistral-medium-latest ili datirani identifikator iz te obitelji cilja na model koji više ne postoji. Migracija više nije nešto što trebaš planirati – to je nešto što moraš učiniti odmah.
Tablica mapiranja
| Koristio/la si | Mistralova označena zamjena | Ono što danas preporučujemo |
|---|---|---|
| Magistral Small (1.0, 1.1, 1.2) | Mistral Small 4 | mistral-small-2603 s reasoning_effort="high" |
| Magistral Medium (1.0, 1.1, 1.2) | Mistral Medium 3.5 | Small 4 ako je kvaliteta dovoljna, inače mistral-large-4-0 s reasoning_effort="high" |
Zašto ne slijediti Mistralovu označenu zamjenu za Magistral Medium do slova? Zato što je Mistral Medium 3.5 sam zastario od 31. listopada 2026., s planiranim povlačenjem 30. travnja 2027., a Large 4 je njegov nasljednik. Migracija na njega znači obvezivanje na drugu migraciju za šest mjeseci. Large 4 je u javnoj preglednoj verziji (Public Preview): ako ta razina zrelosti ne odgovara tvom produkcijskom okruženju, Medium 3.5 ostaje moguća prijelazna točka, pod uvjetom da sada zakažeš sljedeću promjenu.
Što se mijenja u kodu
Magistral je uvijek razmišljao; trenutni modeli razmišljaju samo kada ih to zatražiš. Prirodni ekvivalent „uvijek uključeno“ stoga je reasoning_effort="high".
# Prije: Magistral (povučen)
response = client.chat.complete(
model="magistral-medium-latest",
messages=[
{"role": "system", "content": "You are a rigorous analyst."},
{"role": "user", "content": question},
],
prompt_mode=None, # onemogućen Magistralov zadani sistemski prompt
)
# Poslije: Mistral Large 4 s eksplicitnim razmišljanjem
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",
)
Četiri stavke koje trebaš riješiti usput:
- Identifikatori modela: potraži
magistralu svom kodu, konfiguracijskim datotekama i varijablama okruženja. prompt_mode: dokumentacija o razmišljanju ga više ne spominje; ukloni ga iz svojih poziva.- Sistemski promptovi: izbriši predložak za razmišljanje specifičan za Magistral (fragment
thinkingsmješten u sistemsku poruku) i zadrži samo upute o metodi i formatu (Lekcija 6). - Čitanje odgovora: struktura iz Magistrala 25.07 i 25.09 (
ThinkChunkzatimTextChunk) odgovara trenutnim modelima, pa tvoj kod za čitanje ostaje valjan. Samo dodaj rukovanje slučajem običnog niza (string), koji Small 4 i Medium 3.5 vraćaju kada jereasoning_effort="none". Ako je tvoj kod dolazio iz Magistrala 25.06 i tražio oznake<think>u tekstu, zamijeni ga funkcijomsepareriz Lekcije 3.
Validacija migracije
Nemoj prelaziti nasumično. Ponovno pokreni uzorak svojih stvarnih slučajeva, zajedno s njihovim referentnim odgovorima, i usporedi tri metrike: kvalitetu (točnost, usklađenost formata), potrošene tokene (usage.completion_tokens) i kašnjenje (latency). Jednostavna skripta obavlja posao:
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 ovisi o tvojoj domeni: usporedba s očekivanom vrijednošću, prisutnost potrebnih elemenata ili validacija JSON-a. To je ono što dojam pretvara u odluku.
Iskorištavanje migracije
Budući da ionako diraš svaki poziv modelu, iskoristi ovu priliku da fiksiraš datirane identifikatore u produkciji (mistral-small-2603 umjesto mistral-small-latest) i da centraliziraš izbor modela i razine razmišljanja u jedinstvenu konfiguraciju. Sljedeće zastarijevanje – a bit će ga – tada će biti popravak u jednom retku.
Ključne točke
- Magistral je povučen 31. srpnja 2026.: svaki preostali poziv cilja na nedostupan model
- Magistral Small → Small 4; Magistral Medium → Small 4 ili Large 4 umjesto Medium 3.5, koji je sam zastario
- „Uvijek uključeno“ prevodi se u
reasoning_effort="high" - Ukloni
prompt_modei predložak za razmišljanje iz sistemskih promptova - Validiraj na svojim stvarnim slučajevima (kvaliteta, tokeni, kašnjenje), zatim fiksiraj datirane identifikatore