Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Migracija s Magistrala

Lekcija 8 od 12 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Gdje se nalazi tvoj kod?
  2. Tablica mapiranja
  3. Što se mijenja u kodu
  4. Validacija migracije
  5. Iskorištavanje migracije
  6. Ključne točke

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 siMistralova označena zamjenaOno što danas preporučujemo
Magistral Small (1.0, 1.1, 1.2)Mistral Small 4mistral-small-2603 s reasoning_effort="high"
Magistral Medium (1.0, 1.1, 1.2)Mistral Medium 3.5Small 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:

  1. Identifikatori modela: potraži magistral u svom kodu, konfiguracijskim datotekama i varijablama okruženja.
  2. prompt_mode: dokumentacija o razmišljanju ga više ne spominje; ukloni ga iz svojih poziva.
  3. Sistemski promptovi: izbriši predložak za razmišljanje specifičan za Magistral (fragment thinking smješten u sistemsku poruku) i zadrži samo upute o metodi i formatu (Lekcija 6).
  4. Čitanje odgovora: struktura iz Magistrala 25.07 i 25.09 (ThinkChunk zatim TextChunk) 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 je reasoning_effort="none". Ako je tvoj kod dolazio iz Magistrala 25.06 i tražio oznake <think> u tekstu, zamijeni ga funkcijom separer iz 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_mode i predložak za razmišljanje iz sistemskih promptova
  • Validiraj na svojim stvarnim slučajevima (kvaliteta, tokeni, kašnjenje), zatim fiksiraj datirane identifikatore