Il-prompting ta' mudell tar-raġunament
F'din il-paġna
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_efforthuwa 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_modekienu 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