Премини към основното съдържание
Български— Изберете език
Меню

Роли и съобщения

Урок 2 от 16 Обновен 2 ноември 2026 г. Програмист
На тази страница
  1. Сърцевината на конversationния протокол
  2. Четирите роли
  3. Пълна структура на многократна размяна
  4. Структурирано съдържание
  5. Флагът за префикс
  6. Ключови изводи

Сърцевината на конversationния протокол

API за чат довършвания (Chat Completions API) не приема суров текст. Той очаква масив от структурирани съобщения, всяко от които е присвоено на конкретна роля. Тази система от роли позволява на модела да различи кой говори, какъв е контекстът и как трябва да отговори. Един и същи текст – „Винаги отговаряй в JSON“ – носи различна тежест в зависимост от това дали пристига като инструкция от разработчика или като входни данни от потребителя. Овладяването на тази структура е това, което разделя последователния чатбот от система, която се отклонява от темата след три размени.

Четирите роли

API на Mistral разпознава четири различни роли, всяка от които изпълнява точна функция в разговора.

Ролята system

Системното съобщение дефинира общото поведение на модела. Разположено първо, то се прочита преди всяка размяна. Тук задавате тона, ограниченията и контекста за вашето приложение. Представете си асистент, проектиран за адвокатска кантора; системното съобщение е еквивалентно на инструктажната бележка, която бихте връчили на нов сътрудник преди първия му случай.

messages = [
    {
        "role": "system",
        "content": "You are a legal assistant specializing in French law. "
                   "Respond precisely and cite relevant legal articles. "
                   "If you are unsure, state it explicitly."
    }
]

Разработчикът управлява това съобщение, никога крайният потребител, и то никога не се появява в интерфейса на вашето приложение.

Ролята user

Следва съобщението на човешкия потребител: въпросът, инструкцията или текстът за обработка. Това е единствената част от разговора, която вашите потребители контролират директно.

messages.append({
    "role": "user",
    "content": "What are the statutes of limitations in civil law?"
})

Ролята assistant

Тази роля съдържа предишните отговори на модела. Тя става съществена, щом разговорът надхвърли един оборот. Без нея потребител, който попита „А какво да кажем за търговския дълг?“, би получил отговор извън темата, защото моделът нямаше да знае какво се обсъжда.

messages.append({
    "role": "assistant",
    "content": "In French civil law, the standard statute of limitations is 5 years..."
})

Ролята tool

Последната роля влиза в игра по време на извикването на функции. Когато моделът поиска изпълнение на външна функция – например заявка към API за времето – Вие изпълнявате тази функция от ваша страна и връщате резултата под тази роля, позовавайки се на ID на конкретното извикване:

messages.append({
    "role": "tool",
    "content": '{"temperature": 22, "city": "Paris"}',
    "tool_call_id": "call_abc123"
})

Пълна структура на многократна размяна

Нека видим тези роли в действие по време на реален разговор, в който потребителят прецизира заявката си след първоначален отговор:

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.getenv("MISTRAL_API_KEY"))

conversation = [
    {
        "role": "system",
        "content": "You are a French chef. Propose simple and tasty recipes."
    },
    {
        "role": "user",
        "content": "I want to make a dessert with apples."
    }
]

# First turn
response = client.chat.complete(
    model="mistral-large-latest",
    messages=conversation
)

assistant_reply = response.choices[0].message.content
print(assistant_reply)

# Add response to history
conversation.append({"role": "assistant", "content": assistant_reply})

# Second turn
conversation.append({
    "role": "user",
    "content": "Can you adapt this recipe for 8 people?"
})

response = client.chat.complete(
    model="mistral-large-latest",
    messages=conversation
)

print(response.choices[0].message.content)

Забележете какво всъщност прави този код: при всеки оборот той изпраща обратно цялата история. Моделът няма постоянна памет между заявките. „Тази рецепта“ има смисъл единствено защото предишният отговор все още е в масива. Вие носите пълна отговорност за управлението на състоянието на разговора.

Структурирано съдържание

Полето content приема две форми. Най-честата е обикновен низ. Но веднага щом предадете нещо различно от текст – например изображение за описание – преминавате към списък от типизирани блокове:

# Simple content (text)
{"role": "user", "content": "Describe this image."}

# Structured content (multimodal)
{"role": "user", "content": [
    {"type": "text", "text": "Describe this image."},
    {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}
]}

Флагът за префикс

Mistral предлага уникална функция: флагът за префикс. Вие сами написвате началото на отговора на асистента и моделът е принуден да продължи оттам. Това е изключително ефективно, когато трябва да анализирате изхода с нулева граница на грешка.

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {"role": "system", "content": "You always respond in JSON."},
        {"role": "user", "content": "List 3 European capitals."},
        {"role": "assistant", "content": '{"capitals": [', "prefix": True}
    ]
)

Моделът възобновява генерирането след {"capitals": [, незабавно елиминирайки риска да се появи „Разбира се, ето вашия JSON:“ преди отварящата скоба. В производствена среда тази гаранция за формат често струва повече от инструкция, повторена три пъти в системното съобщение.

Възприйте два навика веднага. Поддържайте системното съобщение кратко: един добре написан параграф дава по-добри резултати от две страници правила, част от които моделът в крайна сметка ще игнорира. И никога не измисляйте фалшиви отговори на асистента, за да насочите модела, с едно изключение – обучението с малко примери (few-shot learning), което ще разгледаме в Урок 10. За дълги разговори изпращайте пълната история, но следете прозореца на контекста и премахвайте най-старите обороти, преди да го надхвърлите.

Ключови изводи

  • Четири роли: system (поведение), user (заявка), assistant (отговор), tool (резултат от функция)
  • Системното съобщение отива първо и дефинира рамката на приложението
  • Моделът няма памет: изпращайте пълната история с всяка заявка
  • Флагът за префикс принуждава началото на отговора, за да контролира формата на изхода