Роли: System, User и Assistant
На тази страница
Разберете системата от роли
API за чат довършвания (Chat Completions API) на Mistral структурира всеки разговор около роли, присвоени на съобщенията. Всяко съобщение, изпратено до модела, трябва да включва роля, която дефинира функцията му в размяната: кой говори и с какъв авторитет. Този механизъм може да изглежда като технически детайл, но всъщност е гръбнакът на всяко професионално подканване (prompt) – това е, което отличава обикновен въпрос, зададен в чат, от внимателно изградено приложение.
Mistral разпознава четири различни роли, всяка с точна функция:
| Role | Description | Example |
|---|---|---|
| system | Defines the model's personality, behavior, and overall context | "You are a French legal expert specializing in labor law." |
| user | Contains the user's request or instruction | "What are the employer's obligations in case of economic dismissal?" |
| assistant | Represents the model's responses, or lets you pre-fill the start of a response | "Here are the 5 main obligations: 1. ..." |
| tool | Returns the result of a function call (function calling) | JSON result from a database search |
Ролята system: основата на Вашето подканване
Съобщението system идва първо в списъка със съобщения и действа като постоянна директива, която влияе върху целия разговор. Мислете за него като за длъжностната характеристика, която бихте връчили на нов член на екипа преди първия му работен ден: то дефинира очакваната личност (тон, ниво на формалност, език), предпочитаната област на експертиза, правилата за това какво моделът трябва или не трябва да прави, и формата по подразбиране за неговите отговори. След като това описание бъде написано, всяка следваща размяна се вписва в тази рамка, без да се налага да я повтаряте.
messages = [
{
"role": "system",
"content": """You are a senior technical writer specializing in API documentation.
Rules:
- Use precise technical English
- Always include Python code examples
- Structure your responses with headings and lists
- Never exceed 500 words per response"""
},
{
"role": "user",
"content": "Explain how to handle HTTP errors in a REST API."
}
]
Отбележете важен момент за Вашите бъдещи приложения: системното подканване се управлява от разработчика, а не от крайния потребител. Потребителят на Вашето приложение никога не го вижда, но всичките му взаимодействия се случват в рамките, които сте установили там. Това го прави Вашият най-мощен лост за контрол.
Ролята user: конкретната заявка
Съобщението user съдържа конкретната заявка. Това е най-интуитивната роля: тя представлява това, което човекът казва на модела, и всеки нов въпрос или инструкция от потребителя става съобщение с роля user. Привидната ѝ простота не трябва да Ви кара да забравяте добрите практики: бъдете точни в заявката си, посочете желания формат, ако се различава от дефинирания в системното подканване, и предоставете данните, от които моделът се нуждае, директно в съобщението – текст за обобщаване, фигури за анализ. Моделът не може да извлече това, което не му дадете.
Ролята assistant: насочване на отговора
Ролята assistant е най-фината от трите, защото има две различни употреби. Първата е историята на разговора: при многократна размяна предишните отговори на модела се вмъкват отново с роля assistant, за да се запази контекстът. Така моделът „помни“ какво е казал:
messages = [
{"role": "user", "content": "What is the capital of France?"},
{"role": "assistant", "content": "The capital of France is Paris."},
{"role": "user", "content": "And its population?"}
]
Без междинното съобщение от assistant, „нейното“ в последния въпрос нямаше да се отнася до нищо: API е без състояние (stateless) и Вие възстановявате паметта при всяко извикване.
Втората употреба е попълване предварително (prefilling/prefix): можете да завършите списъка си със съобщения със съобщение assistant, което съдържа началото на очаквания отговор. Моделът ще продължи от тази точка, сякаш първите думи вече са излезли от устата му. Това е мощна техника за контрол на формата на изхода:
messages = [
{"role": "user", "content": "List 3 Python frameworks for the web."},
{"role": "assistant", "content": "```json\n[", "prefix": True}
]
Обърнете внимание на полето "prefix": True: API на Mistral го изисква за това последно съобщение assistant, за да го третира като начало на отговор.
Тук моделът разбира, че пише JSON, и ще довърши започнатия масив, без увод или встъпително изречение. Докато текстова инструкция „отговори в JSON“ може да бъде игнорирана, вече написаното начало на отговора оставя малък избор.
Ролята tool: резултати от функции
Ролята tool влиза в игра по време на извикване на функции (function calling). Когато моделът реши да извика външна функция – уеб търсене, заявка към API, изчисление – резултатът от тази функция му се изпраща обратно като съобщение tool, което той след това интегрира в своя отговор. Тази роля е по-напреднала и ще бъде разгледана в специализирани курсове; просто запомнете, че съществува и допълва основното трио.
Изграждане на пълен разговор
Нека сега сглобим всички тези елементи в реалистична размяна, където системното подканване рамкира assistant, историята поддържа нишката, а последният въпрос се гради естествено върху предходното:
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "system",
"content": "You are a French culinary assistant. Respond concisely."
},
{
"role": "user",
"content": "How do I make a classic vinaigrette?"
},
{
"role": "assistant",
"content": "For a classic vinaigrette, mix 1 spoon of mustard, 3 spoons of olive oil, and 1 spoon of vinegar."
},
{
"role": "user",
"content": "And for a lighter version?"
}
]
)
Наблюдавайте архитектурата: system първо, след което редуване user/assistant, което възпроизвежда потока на разговора. Този ред не е декоративен – той позволява на модела правилно да интерпретира „по-лека версия“ като вариант на винегрета, който току-що обсъди.
Ключови изводи
- Ролята system рамкира цялостното поведение на модела – това е Вашият най-мощен лост
- Ролята user носи конкретната заявка на потребителя
- Ролята assistant служи едновременно като история и като ръководство за формата на отговора
- Ролята tool обработва резултатите от извиквания на функции
- Редът на съобщенията е от решаващо значение: system първо, след това редуване user/assistant