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

Ir-Rwoli: System, User, u Assistant

Lezzjoni 2 / 16 Aġġornat 2 ta’ Novembru 2026 Bidbieni
F'din il-paġna
  1. Ifhem is-sistema tar-rwoli
  2. Ir-rwol tas-system: il-fondazzjoni tal-prompt tiegħek
  3. Ir-rwol tal-user: it-talba konkreta
  4. Ir-rwol tal-assistant: iggwida t-tweġiba
  5. Ir-rwol tal-tool: riżultati tal-funzjonijiet
  6. Ibni konversazzjoni sħiħa
  7. Punti Ewlenin

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