Roly: Systém, Používateľ a Asistent
Na tejto strane
Pochopte systém rolí
API Chat Completions od spoločnosti Mistral štruktúruje každú konverzáciu okolo rolí priradených správam. Každá správa odoslaná modelu musí obsahovať rolu, ktorá definuje jej funkciu v rámci výmeny: kto hovorí a s akou právomocou. Tento mechanizmus sa môže zdať ako technický detail, no v skutočnosti je chrbtovou kosťou každého profesionálneho promptu – práve on odlišuje jednoduchú otázku položenú v chate od starostlivo vybudovanej aplikácie.
Mistral rozpoznáva štyri odlišné role, pričom každá má presne určenú funkciu:
| Rola | Popis | Príklad |
|---|---|---|
| system | Definuje osobnosť, správanie a celkový kontext modelu | "Ste francúzsky právny expert špecializujúci sa na pracovné právo." |
| user | Obsahuje požiadavku alebo inštrukciu používateľa | "Aké sú povinnosti zamestnávateľa v prípade prepúšťania z ekonomických dôvodov?" |
| assistant | Predstavuje odpovede modelu alebo vám umožňuje predvyplniť začiatok odpovede | "Tu je 5 hlavných povinností: 1. ..." |
| tool | Vracia výsledok volania funkcie (function calling) | Výsledok JSON z vyhľadávania v databáze |
Rola system: základ vášho promptu
Správa system je v zozname správ prvá a funguje ako trvalá smernica, ktorá ovplyvňuje celú konverzáciu. Predstavte si ju ako pracovnú náplň, ktorú by ste odovzdali novému členovi tímu pred jeho prvým dňom: definuje očakávanú osobnosť (tón, úroveň formálnosti, jazyk), preferovanú oblasť expertízy, pravidlá toho, čo model musí alebo nesmie robiť, a predvolený formát jeho odpovedí. Akonáhle je tento popis napísaný, každá následná výmena zapadá do tohto rámca bez toho, aby ste ho museli opakovať.
messages = [
{
"role": "system",
"content": """Ste senior technický spisovateľ špecializujúci sa na dokumentáciu API.
Pravidlá:
- Používajte presnú technickú angličtinu
- Vždy zahrňte príklady kódu v Pythone
- Štruktúrujte svoje odpovede pomocou nadpisov a zoznamov
- Nikdy neprekročte 500 slov na odpoveď"""
},
{
"role": "user",
"content": "Vysvetlite, ako zaobchádzať s chybami HTTP v REST API."
}
]
Všimnite si dôležitý bod pre vaše budúce aplikácie: prompt systému spravuje vývojár, nie koncový používateľ. Používateľ vašej aplikácie ho nikdy nevidí, no všetky jeho interakcie prebiehajú v rámci, ktorý ste tam stanovili. To z neho robí váš najsilnejší nástroj kontroly.
Rola user: konkrétna požiadavka
Správa user obsahuje konkrétnu požiadavku. Je to najintuitívnejšia rola: predstavuje to, čo človek povie modelu, a každá nová otázka alebo inštrukcia od používateľa sa stáva správou s rolou user. Jej zdanlivá jednoduchosť by vás nemala priviesť k zabudnutiu na osvedčené postupy: buďte vo svojej požiadavke presní, špecifikujte požadovaný formát, ak sa líši od toho definovaného v systémovej smernici, a poskytnite údaje, ktoré model potrebuje, priamo v správe – text na zhrnutie, údaje na analýzu. Model nemôže získať to, čo mu nedáte.
Rola assistant: usmerňovanie odpovede
Rola assistant je z tejto trojice najjemnejšia, pretože má dva odlišné spôsoby využitia. Prvým je história konverzácie: vo výmene s viacerými kolami sa predchádzajúce odpovede modelu vkladajú späť s rolou assistant, aby sa zachoval kontext. Takto si model „pamätá“, čo povedal:
messages = [
{"role": "user", "content": "Aké je hlavné mesto Francúzska?"},
{"role": "assistant", "content": "Hlavným mestom Francúzska je Paríž."},
{"role": "user", "content": "A aký má počet obyvateľov?"}
]
Bez intermediárnej správy asistenta by sa zámeno „jej“ v poslednej otázke nemalo na čo vzťahovať: API je bezstavové (stateless) a pamäť obnovujete pri každom volaní.
Druhým využitím je predvyplnenie (prefix): zoznam správ môžete ukončiť správou assistant, ktorá obsahuje začiatok očakávanej odpovede. Model bude pokračovať od tohto bodu, akoby prvé slová už vyšli z jeho úst. Je to silná technika na kontrolu formátu výstupu:
messages = [
{"role": "user", "content": "Vymenuj 3 Python frameworky pre web."},
{"role": "assistant", "content": "```json\n[", "prefix": True}
]
Všimnite si pole "prefix": True: API spoločnosti Mistral ho vyžaduje pri tejto poslednej správe assistant, aby ju považovalo za začiatok odpovede.
Model tu chápe, že píše JSON, a dokončí začatý pole bez úvodu alebo úvodnej vety. Kým textová inštrukcia „odpovedz v JSON“ môže byť ignorovaná, už napísaný začiatok odpovede ponecháva malý priestor na výber.
Rola tool: výsledky funkcií
Rola tool prichádza do úvahy počas volania funkcií (function calling). Keď sa model rozhodne zavolať externú funkciu – vyhľadávanie na webe, požiadavku na API, výpočet – výsledok tejto funkcie sa mu pošle späť ako správa tool, ktorú následne integruje do svojej odpovede. Táto rola je pokročilejšia a bude pokrytá v špecializovaných kurzoch; stačí si zapamätať, že existuje a dopĺňa hlavnú trojicu.
Vytvorenie kompletnej konverzácie
Teraz poskladajme všetky tieto prvky do realistickej výmeny, kde systémový prompt rámcuje asistenta, história udržiava vlákno a posledná otázka prirodzene nadväzuje na to, čo predchádzalo:
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "system",
"content": "Ste francúzsky kulinársky asistent. Odpovedajte stručne."
},
{
"role": "user",
"content": "Ako pripravím klasickú vinaigretu?"
},
{
"role": "assistant",
"content": "Na klasickú vinaigretu zmiešajte 1 lyžicu horčice, 3 lyžice olivového oleja a 1 lyžicu octu."
},
{
"role": "user",
"content": "A ako na ľahšiu verziu?"
}
]
)
Všimnite si architektúru: najprv systém, potom striedanie user/assistant, ktoré reprodukuje tok konverzácie. Tento poriadok nie je dekoratívny – práve on umožňuje modelu správne interpretovať „ľahšiu verziu“ ako variant vinaigretty, o ktorej práve diskutoval.
Kľúčové poznatky
- Rola system rámcuje celkové správanie modelu – je to váš najsilnejší nástroj
- Rola user nesie konkrétnu požiadavku používateľa
- Rola assistant slúži ako história aj ako sprievodca formátom odpovede
- Rola tool spracováva výsledky volania funkcií
- Poradie správ je kľúčové: najprv systém, potom striedanie user/assistant