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

Rwoli u Messaġġi

Lezzjoni 2 / 16 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Il-Qalba tal-Protokoll Konversazzjonali
  2. Ir-Raba’ Rwoli
  3. L-Istruttura Sħiħa ta’ Skambju Multi-Dawra
  4. Kontenut Strutturat
  5. Il-Flag tal-Prefiss
  6. Punti Ewlenin

Il-Qalba tal-Protokoll Konversazzjonali

L-API ta’ Chat Completions ma taċċettax test sempliċi (raw text). Hija tistenna array ta’ messaġġi strutturati, li kull wieħed minnhom ikun assenjat rwol speċifiku. Dan is-sistema ta’ rwoli tippermetti lill-mudell jiddistingwi min qed jitkellem, x’inhu l-kuntest, u kif għandu jirrispondi. L-istess test—“Dejjem irrispondi f’JSON”—ikollu piż differenti skont jekk jasolx bħala istruzzjoni ta’ żviluppatur jew bħala input ta’ utent. Li tmexxi din l-istruttura huwa dak li jifred chatbot koerenti minn sistema li titbiegħed mis-suġġett wara tliet skambji biss.

Ir-Raba’ Rwoli

L-API ta’ Mistral tirrikonoxxi erba’ rwoli distinti, li kull wieħed iservi funzjoni preċiża fil-konversazzjoni.

Ir-Rwol system

Il-messaġġ tas-sistema jiddefinixxi l-imġiba ġenerali tal-mudell. Meta jitqiegħed l-ewwel, jinqara qabel ma jseħħ kwalunkwe skambju. Hawnhekk tistabbilixxi t-ton, il-limitazzjonijiet u l-kuntest għall-applikazzjoni tiegħek. Imaġina assistent iddisinjat għal ditta tal-liġi; il-messaġġ tas-sistema huwa ekwivalenti għan-nota ta’ briefing li tagħti lil assoċjat ġdid qabel l-ewwel każ tiegħu.

messages = [
    {
        "role": "system",
        "content": "You are a legal assistant specializing in French law. "
                   "Respond precisely and cite relevant legal articles. "
                   "If you are unsure, state it explicitly."
    }
]

L-iżviluppatur jimmaniġġja dan il-messaġġ, qatt mhux l-utent finali, u qatt ma jidher fl-interfaċċa tal-applikazzjoni tiegħek.

Ir-Rwol user

Imbagħad jiġi l-messaġġ tal-utent uman: il-mistoqsija, l-istruzzjoni, jew it-test li għandu jiġi pproċessat. Din hija l-unika parti tal-konversazzjoni li l-utenti tiegħek jikkontrollaw direttament.

messages.append({
    "role": "user",
    "content": "What are the statutes of limitations in civil law?"
})

Ir-Rwol assistant

Dan ir-rwol iżomm ir-risposti preċedenti tal-mudell. Isir essenzjali ladarba l-konversazzjoni taqbeż dawra waħda (single turn). Mingħajru, utent li jistaqsi “X’inhu dwar id-dejn kummerċjali?” jirċievi rispons barra mit-tema għax il-mudell ma jkunx jaf x’qed jiġi diskuss.

messages.append({
    "role": "assistant",
    "content": "In French civil law, the standard statute of limitations is 5 years..."
})

Ir-Rwol tool

L-aħħar rwol jidħol fis-seħħ waqt is-sejħa tal-funzjonijiet (function calling). Meta l-mudell jitlob l-eżekuzzjoni ta’ funzjoni esterna—pereżempju, li tikkonsulta API tat-temp—inti tmexxi dik il-funzjoni fil-parti tiegħek u tirritorna r-riżultat taħt dan ir-rwol, billi tirreferi għall-ID tas-sejħa speċifika:

messages.append({
    "role": "tool",
    "content": '{"temperature": 22, "city": "Paris"}',
    "tool_call_id": "call_abc123"
})

L-Istruttura Sħiħa ta’ Skambju Multi-Dawra

Ejja naraw dawn ir-rwoli fl-azzjoni matul konversazzjoni reali fejn l-utent jirfina t-talba tiegħu wara rispons inizjali:

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.getenv("MISTRAL_API_KEY"))

conversation = [
    {
        "role": "system",
        "content": "You are a French chef. Propose simple and tasty recipes."
    },
    {
        "role": "user",
        "content": "I want to make a dessert with apples."
    }
]

# First turn
response = client.chat.complete(
    model="mistral-large-latest",
    messages=conversation
)

assistant_reply = response.choices[0].message.content
print(assistant_reply)

# Add response to history
conversation.append({"role": "assistant", "content": assistant_reply})

# Second turn
conversation.append({
    "role": "user",
    "content": "Can you adapt this recipe for 8 people?"
})

response = client.chat.complete(
    model="mistral-large-latest",
    messages=conversation
)

print(response.choices[0].message.content)

Innota x’qed jagħmel dan il-kodiċi fil-fatt: f’kull dawra, jibgħat lura l-istorja sħiħa. Il-mudell m’għandux memorja persistenti bejn it-talbiet. “Din ir-riċetta” tagħmel sens biss għax ir-rispons preċedenti għadu fl-array. Inti responsabbli għalkollox li timmaniġġja l-istat tal-konversazzjoni.

Kontenut Strutturat

Il-qasam content jaċċetta żewġ forom. L-aktar waħda komuni hija string sempliċi. Iżda malli tibgħat xi ħaġa ħlief test—pereżempju, stampa biex tiddeskriviha—tibdel għal lista ta’ blokok ittajpjati:

# Simple content (text)
{"role": "user", "content": "Describe this image."}

# Structured content (multimodal)
{"role": "user", "content": [
    {"type": "text", "text": "Describe this image."},
    {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}
]}

Il-Flag tal-Prefiss

Mistral toffri karatteristika unika: il-flag tal-prefiss (prefix flag). Inti tikteb il-bidu tar-rispons tal-assistenti stess, u l-mudell huwa mġiegħel ikompli minn hemm. Dan huwa effettiv ħafna meta jkollok bżonn tanalizza l-output b’marġni żero ta’ żball.

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {"role": "system", "content": "You always respond in JSON."},
        {"role": "user", "content": "List 3 European capitals."},
        {"role": "assistant", "content": '{"capitals": [', "prefix": True}
    ]
)

Il-mudell jkompli l-ġenerazzjoni wara {"capitals": [, u b’hekk jelimina immedjatament ir-risku li tara “Sure, here is your JSON:” tidher qabel il-bracket tal-ftuħ. Fil-produzzjoni, din il-garanzija tal-format spiss tiswi aktar minn istruzzjoni ripetuta tliet darbiet fil-messaġġ tas-sistema.

Adotta żewġ drawwiet minnufih. Żomm il-messaġġ tas-sistema konċiż: paragrafu wieħed miktub tajjeb jagħti riżultati aħjar minn żewġ paġni ta’ regoli, li parti minnhom il-mudell eventwalment se jinjora. U qatt ma tinventa risponsi foloz tal-assistenti biex tiggwida l-mudell, bl-eċċezzjoni waħda tal-apprendiment b’eżempji ftit (few-shot learning), li se nkopru fil-Lezzjoni 10. Għal konversazzjonijiet twal, ibgħat l-istorja sħiħa, iżda mmonitorja t-tieqa tal-kuntest (context window) u neħħi d-dawrat l-aktar antiki qabel ma taqbeżha.

Punti Ewlenin

  • Erba’ rwoli: system (imġiba), user (talba), assistant (rispons), tool (riżultat tal-funzjoni)
  • Il-messaġġ tas-sistema jmur l-ewwel u jiddefinixxi l-qafas tal-applikazzjoni
  • Il-mudell m’għandux memorja: ibgħat l-istorja sħiħa ma’ kull talba
  • Il-flag tal-prefiss tifforza l-bidu tar-rispons biex tikkontrolla l-format tal-output