Vaidmenys: sistema, naudotojas ir asistentas
Šiame puslapyje
Suprask vaidmenų sistemą
Mistral „Chat Completions“ API kiekvieną pokalbį grindžia žinutėms priskirtais vaidmenimis. Kiekviena modeliui siunčiama žinutė turi turėti vaidmenį, apibrėžiantį jos funkciją dialoge: kas kalba ir kokiais įgaliojimais. Tai gali atrodyti kaip techninė smulkmena, tačiau iš tikrųjų tai yra bet kokio profesionalaus prompto stuburas – būtent tai atskiria paprastą klausimą pokalbių lange nuo kruopščiai sukurtos programos.
Mistral atpažįsta keturis skirtingus vaidmenis, kurių kiekvienas atlieka tiksliai apibrėžtą funkciją:
| Vaidmuo | Aprašymas | Pavyzdys |
|---|---|---|
| system | Apibrėžia modelio asmenybę, elgseną ir bendrą kontekstą | "Esi prancūzų teisės ekspertas, specializuojantis darbo teisėje." |
| user | Turi naudotojo prašymą arba instrukciją | "Kokie yra darbdavio įsipareigojimai ekonominio atleidimo atveju?" |
| assistant | Atspindi modelio atsakymus arba leidžia iš anksto užpildyti atsakymo pradžią | "Štai 5 pagrindiniai įsipareigojimai: 1. ..." |
| tool | Grąžina funkcijos iškvietimo rezultatą (function calling) | JSON rezultatas iš duomenų bazės paieškos |
Sistemos vaidmuo: tavo prompto pamatas
Žinutė su system vaidmeniu sąraše yra pirmoji ir veikia kaip nuolatinė direktyva, daranti įtaką visam pokalbiui. Įsivaizduok tai kaip darbo aprašymą, kurį įteiktum naujam komandos nariui prieš pirmąją darbo dieną: jame apibrėžiama pageidaujama asmenybė (tonas, oficialumo lygis, kalba), pageidaujama kompetencijos sritis, taisyklės, ką modelis privalo arba neturi daryti, bei numatytasis atsakymų formatas. Kai šis aprašymas parašytas, visas tolesnis bendravimas vyksta šiame rėme, ir tau nereikia jo kartoti.
messages = [
{
"role": "system",
"content": """Esi vyresnysis techninis rašytojas, specializuojantis API dokumentacijoje.
Taisyklės:
- Naudok tikslią techninę anglų kalbą
- Visada įtrauk Python kodo pavyzdžius
- Struktūrizuok atsakymus naudodamas antraštes ir sąrašus
- Niekada neviršyk 500 žodžių viename atsakyme"""
},
{
"role": "user",
"content": "Paaiškink, kaip tvarkyti HTTP klaidas REST API."
}
]
Atkreipk dėmesį į svarbų aspektą tavo būsimoms programoms: sistemos promptą valdo kūrėjas, o ne galutinis naudotojas. Tavo programos naudotojas jo niekada nemato, tačiau visa jo sąveika vyksta tavo čia nustatytose ribose. Tai daro jį galingiausiu tavo kontrolės svertu.
Naudotojo vaidmuo: konkretus prašymas
Žinutė su user vaidmeniu turi konkretų prašymą. Tai pats intuityviausias vaidmuo: jis atspindi tai, ką žmogus sako modeliui, ir kiekvienas naujas naudotojo klausimas ar instrukcija tampa žinute su user vaidmeniu. Dėl akivaizdaus paprastumo nepamiršk geriausios praktikos: būk tikslus savo prašyme, nurodyk pageidaujamą formatą, jei jis skiriasi nuo nustatytojo sistemos prompte, ir pateik duomenis, kurių modeliui reikia, tiesiai žinutėje – tekstą santraukai, skaičius analizei. Modelis negali gauti to, ko tu jam neduodi.
Asistento vaidmuo: atsakymo nukreipimas
Assistant vaidmuo yra subtiliausias iš trijų, nes turi dvi skirtingas paskirtis. Pirmoji – pokalbio istorija: kelių ėjimų dialoge ankstesni modelio atsakymai įterpiami pakartotinai su assistant vaidmeniu, kad būtų išlaikytas kontekstas. Būtent taip modelis „prisimena“, ką jis pasakė:
messages = [
{"role": "user", "content": "Kokia yra Prancūzijos sostinė?"},
{"role": "assistant", "content": "Prancūzijos sostinė yra Paryžius."},
{"role": "user", "content": "O jos gyventojų skaičius?"}
]
Be tarpinės asistento žinutės, įvardis „jos“ paskutiniame klausime nieko nereikštų: API neturi būsenos (stateless), todėl atmintį atkuriate kiekvienu kvietimu.
Antroji paskirtis – išankstinis užpildymas (prefix): savo žinučių sąrašo pabaigoje gali pridėti assistant žinutę, kurioje yra tikėtino atsakymo pradžia. Modelis tęs nuo šio taško lyg pirmieji žodžiai jau būtų ištarti. Tai galinga technika išvesties formatui valdyti:
messages = [
{"role": "user", "content": "Išvardink 3 Python karkasus žiniatinkliui."},
{"role": "assistant", "content": "```json\n[", "prefix": True}
]
Atkreipk dėmesį į lauką "prefix": True": Mistral API jo reikalauja šioje paskutinėje assistant` žinutėje, kad ją traktuotų kaip atsakymo pradžią.
Čia modelis supranta rašantis JSON ir užbaigs pradėtą masyvą be įžangos ar pristatomųjų sakinių. Ten, kur tekstinė instrukcija „atsakyk JSON formatu“ gali būti ignoruojama, jau parašyta atsakymo pradžia palieka mažai pasirinkimo.
Įrankio vaidmuo: funkcijų rezultatai
Tool vaidmuo įsijungia vykdant funkcijų iškvietimus (function calling). Kai modelis nusprendžia iškviesti išorinę funkciją – žiniatinklio paiešką, API užklausą, skaičiavimą – tos funkcijos rezultatas jam grąžinamas kaip tool žinutė, kurią jis tada integruoja į savo atsakymą. Šis vaidmuo yra pažangesnis ir bus nagrinėjamas specialiuose kursuose; tiesiog įsimink, kad jis egzistuoja ir papildo pagrindinį trejetą.
Sukurk pilną pokalbį
Dabar sujunkime visus šiuos elementus į realistišką dialogą, kuriame sistemos promptas apibrėžia asistentą, istorija palaiko giją, o paskutinis klausimas natūraliai remiasi tuo, kas buvo prieš tai:
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "system",
"content": "Esi prancūzų kulinarinis asistentas. Atsakyk glaustai."
},
{
"role": "user",
"content": "Kaip pagaminti klasikinę vinaigretę?"
},
{
"role": "assistant",
"content": "Klasikinei vinaigretei sumaišyk 1 šaukštą garstyčių, 3 šaukštus alyvuogių aliejaus ir 1 šaukštą acto."
},
{
"role": "user",
"content": "O lengvesnė versija?"
}
]
)
Stebėk architektūrą: pirmiausia sistema, tada naudotojo ir asistento kaita, atkartojanti pokalbio eigą. Ši tvarka nėra dekoratyvinė – būtent ji leidžia modeliui teisingai interpretuoti „lengvesnę versiją“ kaip tik ką aptartos vinaigretės variantą.
Svarbiausi punktai
- System vaidmuo apibrėžia bendrą modelio elgseną – tai tavo galingiausias svertas
- User vaidmuo perduoda konkretų naudotojo prašymą
- Assistant vaidmuo tarnauja tiek kaip istorija, tiek kaip atsakymo formato gidas
- Tool vaidmuo tvarko funkcijų iškvietimų rezultatus
- Žinučių eiliškumas yra kritiškai svarbus: pirmiausia sistema, tada naudotojo ir asistento kaita