Roolit: System, User ja Assistant
Tällä sivulla
Ymmärrä roolijärjestelmä
Mistralin Chat Completions API rakentaa jokaisen keskustelun viesteille määritettyjen roolien ympärille. Jokaisen mallille lähetetyn viestin on sisällettävä rooli, joka määrittelee sen tehtävän vuorovaikutuksessa: kuka puhuu ja millä vallalla. Tämä mekanismi saattaa vaikuttaa pelkältä tekniseltä yksityiskohdalta, mutta se on itse asiassa kaiken ammattimaisen kehotuksen selkäranka – se erottaa chatissa esitetyn yksinkertaisen kysymyksen huolellisesti rakennetusta sovelluksesta.
Mistral tunnistaa neljä erillistä roolia, joilla kullakin on tarkka tehtävä:
| Rooli | Kuvaus | Esimerkki |
|---|---|---|
| system | Määrittelee mallin persoonallisuuden, käyttäytymisen ja yleisen kontekstin | "Olet ranskalainen lakiasiantuntija, joka on erikoistunut työoikeuteen." |
| user | Sisältää käyttäjän pyynnön tai ohjeen | "Mitä velvollisuuksia työnantajalla on taloudellisissa irtisanomisissa?" |
| assistant | Edustaa mallin vastauksia tai antaa sinun esitäyttää vastauksen alun | "Tässä ovat 5 tärkeintä velvollisuutta: 1. ..." |
| tool | Palauttaa funktiokutsun tuloksen (function calling) | Tietokantahaun JSON-tulos |
System-rooli: kehotuksesi perusta
System-viesti on viestiluettelossa ensimmäisenä, ja se toimii pysyvänä ohjeena, joka vaikuttaa koko keskusteluun. Ajattele sitä kuin työkuvausta, jonka antaisit uudelle tiimin jäsenelle ennen hänen ensimmäistä työpäiväänsä: se määrittelee odotetun persoonallisuuden (sävy, muodollisuustaso, kieli), halutun asiantuntijuusalueen, säännöt siitä, mitä mallin tulee tai ei tule tehdä, sekä oletusmuodon sen vastauksille. Kun tämä kuvaus on kirjoitettu, kaikki myöhemmät vaiheet sijoittuvat tähän kehykseen ilman, että sinun tarvitsee toistaa sitä.
messages = [
{
"role": "system",
"content": """Olet kokenut tekninen kirjoittaja, joka on erikoistunut API-dokumentaatioon.
Säännöt:
- Käytä tarkkaa teknistä englantia
- Sisällytä aina Python-koodiesimerkkejä
- Jäsennä vastauksesi otsikoiden ja luetteloiden avulla
- Älä koskaan ylitä 500 sanaa vastausta kohden"""
},
{
"role": "user",
"content": "Selitä, miten HTTP-virheitä käsitellään REST API:ssa."
}
]
Huomaa tärkeä seikka tulevia sovelluksiasi varten: kehittäjä hallinnoi system-kehotusta, ei loppukäyttäjä. Sovelluksesi käyttäjä ei koskaan näe sitä, mutta kaikki hänen vuorovaikutuksensa tapahtuvat siihen luomassasi kehyksessä. Tämä tekee siitä tehokkaimman ohjausvälineesi.
User-rooli: konkreettinen pyyntö
User-viesti sisältää varsinaisen pyynnön. Tämä on intuitiivisin rooli: se edustaa sitä, mitä ihminen sanoo mallille, ja jokainen käyttäjän uusi kysymys tai ohje muuttuu user-roolin viestiksi. Sen näennäinen yksinkertaisuus ei saa saada unohtamaan parhaita käytäntöjä: ole pyynnössäsi tarkka, määritä haluttu muoto, jos se poikkeaa system-kehotuksessa määritellystä, ja tarjoa mallin tarvitsemat tiedot suoraan viestissä – tiivistettävä teksti, analysoitavat luvut. Malli ei voi hakea sitä, mitä et sille anna.
Assistant-rooli: vastauksen ohjaaminen
Assistant-rooli on kolmesta hienovaraisin, sillä sillä on kaksi erillistä käyttötarkoitusta. Ensimmäinen on keskusteluhistoria: monivaiheisessa vuorovaikutuksessa mallin aiemmat vastaukset lisätään takaisin assistant-roolilla kontekstin ylläpitämiseksi. Näin malli “muistaa”, mitä se on sanonut:
messages = [
{"role": "user", "content": "Mikä on Ranskan pääkaupunki?"},
{"role": "assistant", "content": "Ranskan pääkaupunki on Pariisi."},
{"role": "user", "content": "Entä sen väkiluku?"}
]
Ilman välissä olevaa assistant-viestiä viimeisen kysymyksen “sen” ei viittaisi mihinkään: API on tilaton, ja sinä rakennat muistin uudelleen jokaisella kutsulla.
Toinen käyttötapa on esitäyttö (prefix): voit päättää viestiluettelosi assistant-viestillä, joka sisältää odotetun vastauksen alun. Malli jatkaa tästä kohdasta ikään kuin ensimmäiset sanat olisivat jo tulleet sen suusta. Tämä on tehokas tekniikka tulosteen muodon hallintaan:
messages = [
{"role": "user", "content": "Listaa 3 Python-verkkokehystä."},
{"role": "assistant", "content": "```json\n[", "prefix": True}
]
Huomaa kenttä "prefix": True: Mistralin API vaatii sen tässä viimeisessä assistant-viestissä käsitelläkseen sitä vastauksen alkuna.
Tässä malli ymmärtää kirjoittavansa JSONia ja täydentää aloitetun taulukon ilman saatesanoja tai johdantolausetta. Missä tekstikehotus “vastaa JSON-muodossa” saatettaisiin ignoroida, valmiiksi kirjoitettu vastauksen alku ei jätä paljon valinnanvaraa.
Tool-rooli: funktiotulokset
Tool-rooli astuu kuvaan funktiokutsujen (function calling) yhteydessä. Kun malli päättää kutsua ulkoista funktiota – verkkohaku, API-pyyntö, laskutoimitus – kyseisen funktion tulos lähetetään sille takaisin tool-viestinä, jonka se sitten integroi vastaukseensa. Tämä rooli on edistyneempi, ja sitä käsitellään erillisissä kursseissa; riittää, kun muistat sen olemassaolon ja sen, että se täydentää pääkolmikkoa.
Rakenna kokonainen keskustelu
Kootaan nyt kaikki nämä elementit realistiseksi vaihdoksi, jossa system-kehotus kehystää assistantia, historia pitää langan käsissä ja viimeinen kysymys rakentuu luontevasti aiempien päälle:
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "system",
"content": "Olet ranskalainen ruoka-apulainen. Vastaa ytimekkäästi."
},
{
"role": "user",
"content": "Miten teen klassisen vinaigretten?"
},
{
"role": "assistant",
"content": "Klassiseen vinaigretteeseen sekoita 1 lusikka sinappia, 3 lusikkaa oliiviöljyä ja 1 lusikka etikkaa."
},
{
"role": "user",
"content": "Entä kevyempi versio?"
}
]
)
Huomaa arkkitehtuuri: ensin system, sitten user/assistant-vuorottelu, joka toistaa keskustelun kulun. Tämä järjestys ei ole koristeellinen – se mahdollistaa sen, että malli tulkitsee “kevyemmän version” oikein juuri käsitellyn vinaigretten muunnokseksi.
Keskeiset asiat
- System-rooli kehystää mallin yleistä käyttäytymistä – se on tehokkain vipuvarresi
- User-rooli välittää käyttäjän konkreettisen pyynnön
- Assistant-rooli toimii sekä historiana että vastauksen muodon ohjaajana
- Tool-rooli hallitsee funktiokutsujen tuloksia
- Viestien järjestys on ratkaiseva: ensin system, sitten user/assistant-vuorottelu