Roluri: System, User și Assistant
Pe această pagină
Înțelegeți sistemul de roluri
API-ul Chat Completions de la Mistral structurează fiecare conversație în jurul rolurilor atribuite mesajelor. Fiecare mesaj trimis modelului trebuie să includă un rol care îi definește funcția în cadrul schimbului: cine vorbește și cu ce autoritate. Acest mecanism poate părea un detaliu tehnic, dar reprezintă, de fapt, coloana vertebrală a oricărui prompt profesional – este ceea ce face diferența dintre o simplă întrebare pusă într-un chat și o aplicație construită cu grijă.
Mistral recunoaște patru roluri distincte, fiecare având o funcție precisă:
| Rol | Descriere | Exemplu |
|---|---|---|
| system | Definește personalitatea, comportamentul și contextul general al modelului | "Ești un expert juridic francez specializat în dreptul muncii." |
| user | Conține cererea sau instrucțiunea utilizatorului | "Care sunt obligațiile angajatorului în cazul concedierii pentru motive economice?" |
| assistant | Reprezintă răspunsurile modelului sau vă permite să pre-completați începutul unui răspuns | "Iată cele 5 obligații principale: 1. ..." |
| tool | Returnează rezultatul unui apel de funcție (function calling) | Rezultat JSON dintr-o căutare în baza de date |
Rolul system: fundamentul promptului dumneavoastră
Mesajul system vine primul în lista de mesaje și acționează ca o directivă permanentă care influențează întreaga conversație. Gândiți-vă la el ca la fișa postului pe care ați înmâna-o unui nou membru al echipei înainte de prima zi de lucru: definește personalitatea așteptată (ton, nivel de formalitate, limbaj), domeniul de expertiză preferat, regulile privind ceea ce modelul trebuie sau nu trebuie să facă și formatul implicit al răspunsurilor sale. Odată scrisă această descriere, fiecare schimb ulterior se încadrează în acest cadru fără a fi nevoie să îl repetați.
messages = [
{
"role": "system",
"content": """Ești un scriitor tehnic senior specializat în documentația API.
Reguli:
- Folosește engleza tehnică precisă
- Include întotdeauna exemple de cod Python
- Structurează răspunsurile cu titluri și liste
- Nu depăși niciodată 500 de cuvinte per răspuns"""
},
{
"role": "user",
"content": "Explică cum să gestionezi erorile HTTP într-un API REST."
}
]
Rețineți un aspect important pentru viitoarele dumneavoastră aplicații: promptul system este gestionat de dezvoltator, nu de utilizatorul final. Utilizatorul aplicației dumneavoastră nu îl vede niciodată, dar toate interacțiunile sale au loc în cadrul stabilit acolo. Acest lucru îl face cea mai puternică pârghie de control de care dispuneți.
Rolul user: cererea concretă
Mesajul user conține cererea specifică. Acesta este cel mai intuitiv rol: reprezintă ceea ce spune omul modelului, iar fiecare nouă întrebare sau instrucțiune din partea utilizatorului devine un mesaj cu rolul user. Simplitatea sa aparentă nu ar trebui să vă facă să uitați bunele practici: fiți preciși în cererea dumneavoastră, specificați formatul dorit dacă diferă de cel definit în promptul system și furnizați direct în mesaj datele de care are nevoie modelul – un text de rezumat, cifre de analizat. Modelul nu poate recupera ceea ce nu îi oferiți.
Rolul assistant: ghidarea răspunsului
Rolul assistant este cel mai subtil dintre cele trei, deoarece are două utilizări distincte. Prima este istoricul conversației: într-un schimb cu mai multe tururi, răspunsurile anterioare ale modelului sunt reinserate cu rolul assistant pentru a menține contextul. Așa „își amintește“ modelul ceea ce a spus:
messages = [
{"role": "user", "content": "Care este capitala Franței?"},
{"role": "assistant", "content": "Capitala Franței este Paris."},
{"role": "user", "content": "Și populația sa?"}
]
Fără mesajul intermediar assistant, pronumele „sa“ din ultima întrebare nu ar avea la ce să se refere: API-ul este fără stare (stateless), iar dumneavoastră reconstruiți memoria la fiecare apel.
A doua utilizare este pre-completarea (prefix): puteți termina lista de mesaje cu un mesaj assistant care conține începutul răspunsului așteptat. Modelul va continua de la acest punct, ca și cum primele cuvinte ar fi ieșit deja din gura sa. Aceasta este o tehnică puternică pentru controlul formatului de ieșire:
messages = [
{"role": "user", "content": "Listează 3 framework-uri Python pentru web."},
{"role": "assistant", "content": "```json\n[", "prefix": True}
]
Observați câmpul "prefix": True: API-ul Mistral îl cere pe acest ultim mesaj assistant pentru a-l trata ca început al unui răspuns.
Aici, modelul înțelege că scrie JSON și va completa tabloul început, fără preambul sau propoziție introductivă. În timp ce o instrucțiune textuală de tipul „răspunde în JSON“ ar putea fi ignorată, un început de răspuns deja scris lasă puțin loc de alegere.
Rolul tool: rezultatele funcțiilor
Rolul tool intră în joc în timpul apelurilor de funcții (function calling). Când modelul decide să apeleze o funcție externă – o căutare pe web, o cerere API, un calcul – rezultatul acelei funcții îi este trimis înapoi sub formă de mesaj tool, pe care îl integrează apoi în răspunsul său. Acest rol este mai avansat și va fi abordat în cursuri dedicate; rețineți doar că există și completează trio-ul principal.
Construiți o conversație completă
Să asamblăm acum toate aceste elemente într-un schimb realist, în care promptul system încadrează asistentul, unde istoricul menține firul narativ, iar ultima întrebare se construiește natural pe baza celor precedente:
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "system",
"content": "Ești un asistent culinar francez. Răspunde concis."
},
{
"role": "user",
"content": "Cum fac o vinetă clasică?"
},
{
"role": "assistant",
"content": "Pentru o vinetă clasică, amestecați 1 lingură de muștar, 3 linguri de ulei de măsline și 1 lingură de oțet."
},
{
"role": "user",
"content": "Și pentru o versiune mai ușoară?"
}
]
)
Observați arhitectura: system primul, apoi o alternanță user/assistant care reproduce fluxul conversației. Această ordine nu este decorativă – ea permite modelului să interpreteze corect „o versiune mai ușoară“ ca o variantă a vinetei tocmai discutate.
Puncte cheie
- Rolul system încadrează comportamentul general al modelului – este pârghia dumneavoastră cea mai puternică
- Rolul user transmite cererea concretă a utilizatorului
- Rolul assistant servește atât ca istoric, cât și ca ghid pentru formatul răspunsului
- Rolul tool gestionează rezultatele apelurilor de funcții
- Ordinea mesajelor este crucială: system primul, apoi alternanța user/assistant