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

Роли: system, developer, user и assistant

Урок 2 от 12 Обновен 30 юли 2026 г. Програмист
На тази страница
  1. Четирите роли на съобщенията
  2. Ролята system (или developer)
  3. Ролята user
  4. Ролята assistant
  5. Пълна структура на заявката
  6. Ключови изводи

Четирите роли на съобщенията

Всяко съобщение, изпратено до крайната точка 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