Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Üleminek Magistralilt

Õppetund 8 / 12 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Kus su kood praegu seisab?
  2. Vastavustabel
  3. Mis muutub koodis
  4. Ülemineku valideerimine
  5. Ülemineku maksimaalne ärakasutamine
  6. Peamised punktid

Õppetund kirjutati 2. novembril 2026 ümber. Algselt kirjeldas see tund Magistrali „pidevat“ põhjendamist. Kuna kõik Magistrali mudelid suleti 31. juulil 2026, käsitleb see nüüd üleminekut parameetrile reasoning_effort. Allikad: Models — deprecated and removed models · Reasoning · Native reasoning (deprecated).

Kus su kood praegu seisab?

Viimased Magistrali versioonid, Small 1.2 ja Medium 1.2 (-2509), tunnistati 2026. aasta kevadel iganenuks ja suleti 31. juulil 2026; versioonid 1.0 ja 1.1 olid juba suletud 30. novembril 2025. Igasugune kood, mis kutsub endiselt magistral-small-latest, magistral-medium-latest või selle pere kuupäevaga identifikaatorit, suunab mudelile, mida enam ei eksisteeri. Üleminek ei ole enam midagi, mida planeerida – see on midagi, mida tuleb teha kohe.

Vastavustabel

Sa kasutasidMistrali määratud asendajaMida me täna soovitame
Magistral Small (1.0, 1.1, 1.2)Mistral Small 4mistral-small-2603 koos reasoning_effort="high"
Magistral Medium (1.0, 1.1, 1.2)Mistral Medium 3.5Small 4, kui kvaliteet sobib, vastasel juhul mistral-large-4-0 koos reasoning_effort="high"

Miks mitte järgida Mistrali määratud asendajat Magistral Mediumile täpselt? Sest Mistral Medium 3.5 on ise iganenud alates 31. oktoobrist 2026 ja selle sulgemine on planeeritud 30. aprilliks 2027, kus selle järeltulijaks on Large 4. Sellele üleminek tähendab kohustust teha kuue kuu pärast teine üleminek. Large 4 on avalikus eelvaates: kui see küpsustase ei sobi sinu tootmiskeskkonda, jääb Medium 3.5 võimalikuks vaheastmeks, eeldusel, et planeerid järgmise vahetuse juba praegu.

Mis muutub koodis

Magistral põhjendas alati; praegused mudelid põhjendavad ainult siis, kui sa neid selleks palud. Loomulik vaste „pidevale“ režiimile on seetõttu reasoning_effort="high".

# Enne: Magistral (suletud)
response = client.chat.complete(
    model="magistral-medium-latest",
    messages=[
        {"role": "system", "content": "You are a rigorous analyst."},
        {"role": "user", "content": question},
    ],
    prompt_mode=None,   # keelas Magistrali vaikimisi süsteemse vihje
)

# Pärast: Mistral Large 4 koos selge põhjendamisega
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",
)

Neli punkti, millele tähelepanu pöörata:

  1. Mudeli identifikaatorid: otsi oma koodist, konfiguratsioonifailidest ja keskkonnamuutujatest sõna magistral.
  2. prompt_mode: põhjendamise dokumentatsioonis seda enam ei mainita; eemalda see oma väljakutsetest.
  3. Süsteemsed vihjed: kustuta Magistrali-spetsiifiline põhjendamise mall (süsteemsõnumisse paigutatud thinking fragment) ja säilita ainult meetodi ning vormingu juhised (6. õppetund).
  4. Vastuste lugemine: Magistrali 25.07 ja 25.09 struktuur (ThinkChunk, seejärel TextChunk) kattub praeguste mudelitega, seega jääb sinu lugemiskood kehtivaks. Lisa vaid tavalise stringi juhtumi käsitlemine, mida Small 4 ja Medium 3.5 tagastavad, kui reasoning_effort="none". Kui su kood pärines Magistrali 25.06 versioonist ja otsis tekstist <think> sildid, asenda see 3. õppetunnist pärit funktsiooniga separer.

Ülemineku valideerimine

Ära vaheta pimesi. Käivita uuesti valik oma reaalsetest juhtumitest koos nende võrdlusvastustega ja võrdle kolme näitajat: kvaliteet (täpsus, vormingu järgimine), tarbitud tokenid (usage.completion_tokens) ja latentsus. Lihtne skript teeb selle töö ära:

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

Funktsioon verifier sõltub sinu valdkonnast: võrdlus oodatava väärtusega, nõutavate elementide olemasolu või JSON-i valideerimine. See on see, mis muudab mulje otsuseks.

Ülemineku maksimaalne ärakasutamine

Kui niikuinii puudutad iga mudelikutset, kasuta seda võimalust, et lukustada tootmises kuupäevaga identifikaatorid (mistral-small-2603 asemel mistral-small-latest) ja tsentraliseerida mudeli ning põhjendamise taseme valik ühte konfiguratsiooni. Järgmine iganemine – ja neid tuleb veel – on siis üherealine parandus.

Peamised punktid

  • Magistral suleti 31. juulil 2026: iga allesjäänud kutse suunab kättesaamatule mudelile
  • Magistral Small → Small 4; Magistral Medium → Small 4 või Large 4, mitte Medium 3.5, mis on ise iganenud
  • „Pidev“ režiim tõlgitakse kui reasoning_effort="high"
  • Eemalda prompt_mode ja põhjendamise mall süsteemsetest vihjetest
  • Valideeri oma reaalsetel juhtumitel (kvaliteet, tokenid, latentsus) ja seejärel lukusta kuupäevaga identifikaatorid