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

Il-prompting ta' mudell tar-raġunament

Lezzjoni 6 / 12 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. X’inbidel minn Magistral
  2. Is-separazzjoni tar-raġunament mit-tweġiba
  3. L-adattament skont id-dominju
  4. Tliet żbalji komuni
  5. Punti Ewlenin

Lezzjoni miktuba mill-ġdid fit-2 ta’ Novembru, 2026. Din il-lezzjoni kienet tkopri s-sistema prompt ta’ Magistral, li ġiet irtirata fil-31 ta’ Lulju, 2026. Id-dokumentazzjoni attwali tar-raġunament (Reasoning) ma teħtieġx aktar system prompt dedikat: reasoning_effort huwa biżżejjed. It-taqsimiet li ġejjin jiddistingwu bejn dak li ddikjarat id-dokumentazzjoni ta’ Magistral, dak li nbidel, u r-regoli tal-prompting li għadhom utli.

X’inbidel minn Magistral

Magistral kien jaħdem l-aħjar b’system prompt default, li d-dokumentazzjoni kienet tirriproduċi (issa arkkivjat fil-paġna Native reasoning (deprecated)). Fil-qosor, kien jistruġi lill-mudell biex jabbozza r-raġunament tiegħu l-ewwel, bħal monologu intern, segwit minn tweġiba awtonoma; biex jikteb f’Markdown, juża LaTeX għall-ekwazzjonijiet; u biex iwieġeb fil-lingwa tal-mistoqsija. Kien saħansitra jinkludi mudell tar-raġunament, fil-forma ta’ framment thinking imqiegħed fil-messaġġ tas-sistema. Parametru, prompt_mode, kien jippermettilek tifforza dan il-prompt default ("reasoning") jew tiddiżattivah (None).

Mal-mudelli attwali, l-ebda waħda minn dawn mhix meħtieġa: il-paġna tar-raġunament ma ssemmi la system prompt dedikat u lanqas prompt_mode. Inti tattivaw ir-raġunament b’reasoning_effort, u s-system prompt tiegħek jerġa’ lura għal system prompt standard, iddedikat għar-rwol, il-metodu, u l-format mistenni. Jekk qed timmigra minn Magistral, neħħi l-mudell tar-raġunament mill-messaġġi tas-sistema tiegħek u prompt_mode mis-sejħiet tiegħek, imbagħad qabbel ir-riżultati (Lezzjoni 8).

Is-separazzjoni tar-raġunament mit-tweġiba

Il-mudell issa għandu żewġ spazji distinti: ir-raġunament, li l-utent spiss ma jarahx, u t-tweġiba finali. Prompt tajjeb iqis dan. Jiddeskrivi l-metodu mistenni, dak li espert tad-dominju jivverifika, u jistabbilixxi l-format tat-tweġiba: it-tweġiba trid tkun tinftiehem mingħajr ir-raġunament, peress li r-raġunament ġeneralment ikun moħbi.

import os
from mistralai.client import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

system_prompt = """You are a senior Python debugging expert.

METHOD
- Read all the code before formulating a diagnosis.
- Formulate at least two hypotheses before concluding.
- Verify that your fix does not create a new problem.

FINAL RESPONSE
1. The precise diagnosis
2. The root cause
3. The corrected code
4. A test that proves the fix"""

response = client.chat.complete(
    model="mistral-small-2603",
    messages=[
        {"role": "system", "content": system_prompt},
        {"role": "user", "content": "My code crashes with a RecursionError: def fibonacci(n): return fibonacci(n-1) + fibonacci(n-2)"},
    ],
    reasoning_effort="high",
)

Fuq din il-funzjoni fibonacci li ma għandhiex każ bażiku, ir-rekwiżit ta’ żewġ ipoteżijies jeskludi d-dijanjożi riflessa “żid il-limitu tar-rikorsjoni” u twassal għall-kawża reali.

L-adattament skont id-dominju

L-istess qafas, metodu mbagħad format tat-tweġiba, jaddatta ruħu għad-dominju speċifiku. Fil-matematika, il-metodu jiffoka fuq l-ipoteżijiet u t-tip ta’ prova:

math_prompt = """You are a rigorous mathematician.

METHOD
- State the hypotheses before every proof.
- Explicitly choose between induction, contradiction, or direct calculation.
- Verify the result on a specific case.

FINAL RESPONSE
Formal proof: hypotheses, justified steps, conclusion."""

Fl-analiżi strateġika, jiffoka fuq il-partijiet ikkonċernati u l-kwantifikazzjoni, u t-tweġiba mistennija ssir rakkomandazzjoni akkumpanjata minn pjan:

strategy_prompt = """You are a strategy consultant.

METHOD
- Evaluate each option based on feasibility, impact, and risk.
- Quantify whenever possible, even if only as an order of magnitude.
- Seek the strongest objection to your own recommendation.

FINAL RESPONSE
A clear recommendation, the pros and cons of each option, an action plan with dated steps."""

Tliet żbalji komuni

Il-prompt huwa wisq vag. “Int assistent utli” ma jgħid xejn dwar il-metodu: il-mudell jirraġuna skont l-abitudnijiet tiegħu minflok tiegħek. Iddeskrivi dak li espert ikun jivverifika.

Il-prompt huwa kontradittorju. “Kun konċiż ħafna. Iddettalja kull pass fil-fond.” ipoġġi lill-mudell quddiem ordni impossibbli. Solvi l-kontradizzjoni billi tqassam ir-rwoli: id-dettall jappartjeni għar-raġunament, il-konċiżjoni għat-tweġiba finali.

good_prompt = """Be concise in your final response: conclusions and essential figures only.
Explore details in your reasoning, not in the response."""

It-talba tal-proċess fit-tweġiba. Li titlob “irraġuna pass pass” fit-tweġiba viżibbli tagħmel lill-mudell jikteb darbtejn dak li diġà għamel fir-raġunament tiegħu: it-tweġiba titwal, u inti tħallas darbtejn għall-istess passi f’tokens tal-output. Itlob passi fit-tweġiba biss jekk l-utent jeħtieġ jaqrahom, pereżempju f’tutor edukattiv.

Punti Ewlenin

  • Is-system prompt default u prompt_mode kienu speċifiċi għal Magistral: m’għadx huma meħtieġa
  • Attiva r-raġunament b’reasoning_effort, u żomm is-system prompt fir-rwol klassiku tiegħu
  • Iddeskrivi l-metodu mistenni u l-format ta’ tweġiba li tinqara mingħajr ir-raġunament
  • Qassam ir-rwoli: dettall fir-raġunament, konċiżjoni fit-tweġiba
  • Tagħmilx lill-mudell jerġa’ jikteb il-proċess fit-tweġiba jekk ħadd m’għandu bżonn jaqrah