Роли: system, developer, user и assistant
На тази страница
Четирите роли на съобщенията
Всяко съобщение, изпратено до крайната точка Chat Completions, включва поле role, което определя как моделът Grok го интерпретира. Разбирането на тези роли е от съществено значение за структурирането на разговорите Ви и получаването на качествени отговори.
API на xAI разпознава четири роли: system, developer, user и assistant. Всяка от тях има специфична позиция и употреба в масива със съобщения.
Ролята system (или developer)
Съобщението system идва първо в масива със съобщения. То дефинира цялостното поведение на модела за целия разговор: тон, формат на отговора, ограничения, личност, език и т.н.
{
"role": "system",
"content": "You are a cybersecurity expert. Always respond in English, concisely and technically. If you do not know the answer, state it clearly."
}
Ролята developer е псевдоним за system. Двете са взаимозаменяеми в API на xAI. OpenAI въведе developer, за да отрази по-точно намерението: това са инструкциите на разработчика, а не на „системата“.
Най-добри практики за съобщението system
- Бъдете конкретни: „Отговаряйте с максимум 3 изречения“ е по-ефективно от „Бъдете кратки“
- Дефинирайте формата: посочете дали очаквате JSON, Markdown или списъци с точки
- Задайте ограничения: укажете какво моделът не трябва да прави
- Предоставете контекст: дайте бизнес контекст („Вие сте асистент за ветеринарна клиника“)
Ролята user
Съобщенията user представляват входните данни от крайния потребител. Това са въпросите, заявките или инструкциите, изпратени от лицето, взаимодействащо с Вашето приложение.
{
"role": "user",
"content": "What are the 3 most common web vulnerabilities?"
}
Съобщение user може да се появи навсякъде в разговора след съобщението system. При разговор с много обръщения обикновено редувате съобщения user и assistant.
Ролята assistant
Съобщенията assistant представляват предишните отговори на модела. Когато изпращате история на разговора, всеки отговор от Grok се маркира с тази роля.
{
"role": "assistant",
"content": "The three most common web vulnerabilities are:\n1. SQL Injection\n2. Cross-Site Scripting (XSS)\n3. Broken Authentication"
}
Можете да използвате ролята assistant и за few-shot prompting: инжектиране на примери за желани отговори преди действителното съобщение от потребителя.
{
"messages": [
{"role": "system", "content": "Classify the sentiment: positive, negative, or neutral."},
{"role": "user", "content": "I love this product!"},
{"role": "assistant", "content": "positive"},
{"role": "user", "content": "Customer service is deplorable."},
{"role": "assistant", "content": "negative"},
{"role": "user", "content": "The delivery arrived yesterday."}
]
}
В този пример първите два обмена user/assistant служат като демонстрация. Моделът разбира очаквания формат и ще приложи същата логика към третото съобщение.
Пълна структура на заявката
Ето типична заявка, комбинираща и трите роли в разговор с много обръщения:
{
"model": "grok-4.20-0309-reasoning",
"messages": [
{
"role": "system",
"content": "You are a teaching assistant specialized in mathematics. Explain concepts step by step."
},
{
"role": "user",
"content": "What is a derivative?"
},
{
"role": "assistant",
"content": "A derivative measures the instantaneous rate of change of a function..."
},
{
"role": "user",
"content": "Give me a concrete example."
}
]
}
Редът винаги е един и същ: първо system, след което редуване на user/assistant, като последното съобщение задължително трябва да бъде user (това е въпросът, на който моделът трябва да отговори).
Ключови изводи
- system/developer: инструкции на разработчика, винаги първи, дефинират цялостното поведение
- user: съобщения от крайния потребител, задействат генерирането на отговор
- assistant: предишни отговори на модела, полезни за историята и few-shot prompting
- Ролите
systemиdeveloperса взаимозаменяеми в API на xAI - Последното съобщение в масива трябва да бъде съобщение
user