Ir-Rwoli: System, User, u Assistant
F'din il-paġna
Ifhem is-sistema tar-rwoli
L-API ta’ Chat Completions ta’ Mistral tistruttura kull konversazzjoni madwar rwoli assenjati lill-messaġġi. Kull messaġġ mibgħut lill-mudell irid jinkludi rwol li jiddefinixxi l-funzjoni tiegħu fl-iskambju: min qed jitkellem, u b’liema awtorità. Dan il-mekkaniżmu jista’ jidher bħal dettall tekniku, iżda fil-fatt huwa l-għamara ta’ kwalunkwe prompt professjonali—huwa dak li jiddistingwi mistoqsija sempliċi mitluba f’chat minn applikazzjoni mibnija bir-reqqa.
Mistral jirrikonoxxi erba’ rwoli distinti, kull wieħed b’funzjoni preċiża:
| Rwol | Deskrizzjoni | Eżempju |
|---|---|---|
| system | Jiddefinixxi l-personalità tal-mudell, l-imġiba, u l-kuntest ġenerali | "Inti espert legali Franċiż speċjalizzat fil-liġi tax-xogħol." |
| user | Fih it-talba jew l-istruzzjoni tal-utent | "X'inhuma l-obbligi tal-impjegatur fil-każ ta' tkeċċija ekonomika?" |
| assistant | Jirrappreżenta t-tweġibiet tal-mudell, jew jippermettilek timla minn qabel il-bidu ta' tweġiba | "Hawn huma l-5 obbligi ewlenin: 1. ..." |
| tool | Jirritorna r-riżultat ta' sejħa ta' funzjoni (function calling) | Riżultat JSON minn tfittxija fil-bażi tad-data |
Ir-rwol tas-system: il-fondazzjoni tal-prompt tiegħek
Il-messaġġ system jiġi l-ewwel fil-lista tal-messaġġi u jaġixxi bħala direttiva permanenti li tinfluwenza l-konversazzjoni kollha. Ħsiebu bħala d-deskrizzjoni tax-xogħol li tagħti lil membru ġdid tat-tim qabel l-ewwel jum tax-xogħol tiegħu: tiddefinixxi l-personalità mistennija (ton, livell ta’ formalità, lingwa), il-qasam ta’ għarfien preferut, ir-regoli dwar x’għandu jew ma għandux jagħmel il-mudell, u l-format default għat-tweġibiet tiegħu. Ladarba din id-deskrizzjoni tkun miktuba, kull skambju sussegwenti jaqa’ f’dan il-qafas mingħajr ma jkollok terġa’ tirrepetiha.
messages = [
{
"role": "system",
"content": """Inti kittieb tekniku anzjan speċjalizzat fid-dokumentazzjoni tal-API.
Regoli:
- Uża Ingliż tekniku preċiż
- Dejjem inkludi eżempji ta' kodiċi Python
- Istruttura t-tweġibiet tiegħek b'intestaturi u listi
- Qatt ma taqbeż il-500 kelma kull tweġiba"""
},
{
"role": "user",
"content": "Spjega kif tittratta l-iżbalji HTTP f'API REST."
}
]
Innota punt importanti għall-applikazzjonijiet futuri tiegħek: il-prompt tas-system huwa ġestit mill-iżviluppatur, mhax mill-utent finali. L-utent tal-applikazzjoni tiegħek qatt ma jarah, iżda l-interazzjonijiet kollha tiegħu jsiru fil-qafas li stabbilixxejt hemmhekk. Dan jagħmilha l-aktar leva ta’ kontroll qawwija tiegħek.
Ir-rwol tal-user: it-talba konkreta
Il-messaġġ user fih it-talba speċifika. Dan huwa l-aktar rwol intuwittiv: jirrappreżenta dak li l-bniedem jgħid lill-mudell, u kull mistoqsija jew istruzzjoni ġdida mill-utent issir messaġġ bir-rwol user. Is-sempliċità apparenti tiegħu m’għandhiex tgħallmek tinnesa l-aħjar prattiki: kun preċiż fit-talba tiegħek, speċifika l-format mixtieq jekk ikun differenti minn dak iddefinit fil-prompt tas-system, u pprovdi d-data li l-mudell jeħtieġ direttament fil-messaġġ—test li għandu jiġi ssuntat, figuri li għandhom jiġu analizzati. Il-mudell ma jistax jiġbed dak li inti ma tagħtihx.
Ir-rwol tal-assistant: iggwida t-tweġiba
Ir-rwol assistant huwa l-aktar wieħed sottili mit-tlieta għax għandu żewġ użi distinti. L-ewwel huwa l-istorja tal-konversazzjoni: f’skambju b’diversi dawriet, it-tweġibiet preċedenti tal-mudell jerġgħu jiddaħħlu bir-rwol assistant biex jinżamm il-kuntest. Hekk huwa kif il-mudell “jiftakar” dak li qal:
messages = [
{"role": "user", "content": "X'inhi l-kapitali ta' Franza?"},
{"role": "assistant", "content": "Il-kapitali ta' Franza hija Pariġi."},
{"role": "user", "content": "U l-popolazzjoni tagħha?"}
]
Mingħajr il-messaġġ intermedjarju tal-assistant, il-”tagħha” fl-aħħar mistoqsija ma tkun tirreferi għal xejn: l-API hija stateless, u inti terġa’ tibni l-memorja ma’ kull sejħa.
It-tieni użu huwa l-prefilling (prefiss): tista’ temm il-lista tal-messaġġi tiegħek b’messaġġ assistant li fih il-bidu tat-tweġiba mistennija. Il-mudell ikompli minn dan il-punt, daqslikieku l-ewwel kliem diġà ħareġ minn fommu. Din hija teknika qawwija biex tikkontrolla l-format tal-output:
messages = [
{"role": "user", "content": "Elenska 3 frameworks ta' Python għall-web."},
{"role": "assistant", "content": "```json\n[", "prefix": True}
]
Innota l-kamp "prefix": True: l-API ta’ Mistral jeħtieġha fuq dan l-aħħar messaġġ assistant biex tittrattah bħala l-bidu ta’ tweġiba.
Hawnhekk, il-mudell jifhem li qed jikteb JSON u jikkompleta l-array mibdi, mingħajr preambolu jew sentenza introduttorja. Fejn istruzzjoni testwali “wieġeb f’JSON” tista’ tiġi injorata, bidu diġà miktub għat-tweġiba iħalli ftit għażla.
Ir-rwol tal-tool: riżultati tal-funzjonijiet
Ir-rwol tool jidħol fis-seħħ waqt is-sejħa tal-funzjonijiet (function calling). Meta l-mudell jiddeċiedi li jsejjaħ funzjoni esterna—tiftix fil-web, talba lill-API, kalkolu—ir-riżultat ta’ dik il-funzjoni jintbagħat lura lilu bħala messaġġ tool, li mbagħad jintegra fit-tweġiba tiegħu. Dan ir-rwol huwa aktar avvanzat u se jiġi kopert f’korsi ddedikati; ftakar biss li jeżisti u jikkomplema t-trijewm ewlieni.
Ibni konversazzjoni sħiħa
Ejja issa ngħaqqdu dawn l-elementi kollha f’skambju realistiku, fejn il-prompt tas-system jiframma l-assistant, fejn l-istorja żżomm il-fil, u fejn l-aħħar mistoqsija tibni b’mod naturali fuq dak li ġara qabel:
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "system",
"content": "Inti assistent kulinarju Franċiż. Wieġeb b'mod konċiż."
},
{
"role": "user",
"content": "Kif nagħmel vinaigrette klassika?"
},
{
"role": "assistant",
"content": "Għal vinaigrette klassika, ħallat kuċċara waħda ta' mustarda, 3 kuċċarati ta' żejt taż-żebbuġa, u kuċċara waħda ta' ħall."
},
{
"role": "user",
"content": "U għal verżjoni eħfef?"
}
]
)
Osserva l-arkitettura: system l-ewwel, imbagħad alternanza user/assistant li tirriproduċi l-fluss tal-konversazzjoni. Dan l-ordni mhuwiex dekorattiv—huwa dak li jippermetti lill-mudell jinterpreta korrettament “verżjoni eħfef” bħala varjant tal-vinaigrette li għadu kemm iddiskuta.
Punti Ewlenin
- Ir-rwol system jiframma l-imġiba ġenerali tal-mudell—hija l-aktar leva qawwija tiegħek
- Ir-rwol user iġorr it-talba konkreta tal-utent
- Ir-rwol assistant iservi kemm bħala storja kif ukoll bħala gwida għall-format tat-tweġiba
- Ir-rwol tool jittratta r-riżultati tas-sejħiet tal-funzjonijiet
- L-ordni tal-messaġġi huwa kruċjali: system l-ewwel, imbagħad alternanza user/assistant