Rwoli u Messaġġi
F'din il-paġna
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