Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Migrazzjoni minn Magistral

Lezzjoni 8 / 12 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Fejn qiegħed il-kodiċi tiegħek?
  2. It-tabella ta’ korrispondenza
  3. X’jinbidel fil-kodiċi
  4. Validazzjoni tal-migrazzjoni
  5. L-aħjar użu mill-migrazzjoni
  6. Punti Ewlenin

Lezzjon miktuba mill-ġdid fit-2 ta’ Novembru, 2026. Din il-lezzjon kienet tiddeskrivi r-raġunar “dejjem attiv” ta’ Magistral. Peress li l-mudelli kollha ta’ Magistral ġew irtirati fil-31 ta’ Lulju, 2026, issa tkopri l-migrazzjoni lejn reasoning_effort. Sorsi: Mudelli — mudelli deprekati u mneħħija · Raġunar · Raġunar nattivo (deprekat).

Fejn qiegħed il-kodiċi tiegħek?

L-aħħar verżjonijiet ta’ Magistral, Small 1.2 u Medium 1.2 (-2509), ġew deprekati fir-rebbiegħa tal-2026 u irtirati fil-31 ta’ Lulju, 2026; il-verżjonijiet 1.0 u 1.1 kienu diġà ġew irtirati fit-30 ta’ Novembru, 2025. Kwalunkwe kodiċi li għadu jsejjaħ magistral-small-latest, magistral-medium-latest, jew identifikatur datat minn dik il-familja qed jimmira lejn mudell li ma jeżistix aktar. Il-migrazzjoni m’għadhiex xi ħaġa li tridd tippjana—hija xi ħaġa li trid tagħmel issa.

It-tabella ta’ korrispondenza

Kont tużaIs-sostituzzjoni nnominata minn MistralX’nirrakkomandaw illum
Magistral Small (1.0, 1.1, 1.2)Mistral Small 4mistral-small-2603 b’reasoning_effort="high"
Magistral Medium (1.0, 1.1, 1.2)Mistral Medium 3.5Small 4 jekk il-kwalità tkun biżżejjed, inkella mistral-large-4-0 b’reasoning_effort="high"

Għaliex ma ssegwix is-sostituzzjoni nnominata minn Mistral għal Magistral Medium kelma b’kelma? Għax Mistral Medium 3.5 huwa huwa stess deprekat mill-31 ta’ Ottubru, 2026, b’irtirar skedat għat-30 ta’ April, 2027, u Large 4 bħala s-suċċessur tiegħu. Il-migrazzjoni lejh tfisser li timpenja ruħek għal tieni migrazzjoni sitt xhur wara. Large 4 jinsab f’Public Preview: jekk dak il-livell ta’ maturità ma jkunx xieraq għall-ambjent tal-produzzjoni tiegħek, Medium 3.5 jibqa’ possibbli bħala pass intermedjarju, sakemm tiskeda l-bidla li jmiss issa.

X’jinbidel fil-kodiċi

Magistral kien dejjem jirraġuna; il-mudelli attwali jirraġunaw biss meta titlobhom. L-ekwivalenti naturali ta’ “dejjem attiv” għalhekk huwa reasoning_effort="high".

# Qabel: Magistral (irtirat)
response = client.chat.complete(
    model="magistral-medium-latest",
    messages=[
        {"role": "system", "content": "Int analista rigoruż."},
        {"role": "user", "content": question},
    ],
    prompt_mode=None,   # diżattivat is-sistema prompt default ta' Magistral
)

# Wara: Mistral Large 4 b'raġunar espliċitu
response = client.chat.complete(
    model="mistral-large-4-0",
    messages=[
        {"role": "system", "content": "Int analista rigoruż."},
        {"role": "user", "content": question},
    ],
    reasoning_effort="high",
)

Erba’ punti li trid tindirizza matul it-triq:

  1. Identifikaturi tal-mudell: fittex magistral fil-kodiċi tiegħek, fil-fajls tal-konfigurazzjoni u fil-varjabbli tal-ambjent.
  2. prompt_mode: id-dokumentazzjoni dwar ir-raġunar ma ssemmihx aktar; neħħieh mis-sejħiet tiegħek.
  3. System prompts: ħassar it-template tar-raġunar speċifiku għal Magistral (il-framment thinking imqiegħed fil-messaġġ tas-sistema) u żomm biss l-istruzzjonijiet tal-metodu u tal-format (Lezzjoni 6).
  4. Qari tar-risposti: l-istruttura minn Magistral 25.07 u 25.09 (ThinkChunk imbagħad TextChunk) taqbel mal-mudelli attwali, allura l-kodiċi tal-qari tiegħek jibqa’ validu. Żid biss l-immaniġġjar għall-każ ta’ string sempliċi, li Small 4 u Medium 3.5 jirritornaw meta reasoning_effort="none". Jekk il-kodiċi tiegħek ġie minn Magistral 25.06 u kien ifittex it-tags <think> fit-test, ibdlu bil-funzjoni separer mil-Lezzjoni 3.

Validazzjoni tal-migrazzjoni

Tibdilx blindament. Erġa’ għaddi kampjun tal-każijiet reali tiegħek, flimkien mat-tweġibiet ta’ referenza tagħhom, u qabbel tliet metriċi: kwalità (preċiżjoni, konformità tal-format), tokens ikkunsmati (usage.completion_tokens), u latenza. Skript sempliċi jagħmel ix-xogħol:

import time

def comparer(client, cas, configs):
    """cas: lista ta' (mistoqsija, verifier); configs: lista ta' (mudell, livell)."""
    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)} korrett, {tokens} tokens, {duree:.0f} s")

comparer(client, mes_cas, [
    ("mistral-small-2603", "high"),
    ("mistral-large-4-0", "medium"),
    ("mistral-large-4-0", "high"),
])

Il-funzjoni verifier tiddependi mid-dominju tiegħek: tqabbil ma’ valur mistenni, preżenza ta’ elementi meħtieġa, jew validazzjoni JSON. Dan huwa dak li jbiddel impressjoni f’deċiżjoni.

L-aħjar użu mill-migrazzjoni

Peress li qed tmiss kull sejħa tal-mudell xorta waħda, uża din l-opportunità biex tiffissa identifikaturi datati fil-produzzjoni (mistral-small-2603 minflok mistral-small-latest) u biex tiċċentralizza l-għażla tal-mudell u l-livell tar-raġunar f’konfigurazzjoni waħda. Id-deprekazzjoni li jmiss—u se jkun hemm waħda—mbagħad tkun fix ta’ linja waħda.

Punti Ewlenin

  • Magistral ġie rtirat fil-31 ta’ Lulju, 2026: kwalunkwe sejħa li fadal timmira lejn mudell mhux disponibbli
  • Magistral Small → Small 4; Magistral Medium → Small 4 jew Large 4 minflok Medium 3.5, li huwa nnifsu deprekat
  • “Dejjem attiv” jittraduċi għal reasoning_effort="high"
  • Neħħi prompt_mode u t-template tar-raġunar mis-system prompts
  • Ivvvalida fuq il-każijiet reali tiegħek (kwalità, tokens, latenza), imbagħad iffissa l-identifikaturi datati