Przejdź do głównej treści
Polski— Wybierz język
Menu

Role: system, developer, user i assistant

Lekcja 2 z 12 Zaktualizowano 30 lipca 2026 Programista
Na tej stronie
  1. Cztery role wiadomości
  2. Rola system (lub developer)
  3. Rola user
  4. Rola assistant
  5. Pełna struktura żądania
  6. Kluczowe wnioski

Cztery role wiadomości

Każda wiadomość wysyłana do punktu końcowego Chat Completions zawiera pole role, które określa, jak model Grok ją zinterpretuje. Zrozumienie tych ról jest kluczowe dla prawidłowego strukturyzowania rozmów i uzyskiwania wysokiej jakości odpowiedzi.

API xAI rozpoznaje cztery role: system, developer, user oraz assistant. Każda z nich ma określone miejsce i zastosowanie w tablicy wiadomości.

Rola system (lub developer)

Wiadomość system znajduje się na początku tablicy wiadomości. Definiuje ona ogólne zachowanie modelu dla całej rozmowy: ton, format odpowiedzi, ograniczenia, osobowość, język i tak dalej.

{
  "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."
}

Rola developer jest aliasem dla system. Obie są wymienne w API xAI. OpenAI wprowadziło rolę developer, aby lepiej odzwierciedlić jej przeznaczenie: są to instrukcje od programisty, a nie od „systemu“.

Najlepsze praktyki dotyczące wiadomości system

  • Bądź konkretny: „Odpowiadaj maksymalnie w 3 zdaniach“ jest skuteczniejsze niż „Bądź zwięzły“
  • Zdefiniuj format: określ, czy oczekujesz JSON-a, Markdowna, czy list wypunktowanych
  • Ustal limity: wskaż, czego model nie wolno robić
  • Dostarcz kontekst: podaj kontekst biznesowy („Jesteś asystentem przychodni weterynaryjnej“)

Rola user

Wiadomości user reprezentują dane wejściowe od użytkownika końcowego. Są to pytania, żądania lub instrukcje wysyłane przez osobę interagującą z Twoją aplikacją.

{
  "role": "user",
  "content": "What are the 3 most common web vulnerabilities?"
}

Wiadomość user może pojawić się w dowolnym miejscu rozmowy po wiadomości system. W rozmowie wielowątkowej zazwyczaj naprzemiennie wysyłasz wiadomości user i assistant.

Rola assistant

Wiadomości assistant reprezentują wcześniejsze odpowiedzi modelu. Gdy odsyłasz historię rozmowy, każda odpowiedź od Grok jest oznaczona tą rolą.

{
  "role": "assistant",
  "content": "The three most common web vulnerabilities are:\n1. SQL Injection\n2. Cross-Site Scripting (XSS)\n3. Broken Authentication"
}

Możesz również użyć roli assistant do promptowania few-shot: wstrzykiwania przykładów pożądanych odpowiedzi przed właściwą wiadomością użytkownika.

{
  "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."}
  ]
}

W tym przykładzie pierwsze dwie wymiany user/assistant służą jako demonstracja. Model rozumie oczekiwany format i zastosuje tę samą logikę do trzeciej wiadomości.

Pełna struktura żądania

Oto typowe żądanie łączące wszystkie trzy role w rozmowie wielowątkowej:

{
  "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."
    }
  ]
}

Kolejność jest zawsze taka sama: najpierw system, następnie naprzemienne user/assistant, przy czym ostatnia wiadomość musi być koniecznie typu user (jest to pytanie, na które model ma odpowiedzieć).

Kluczowe wnioski

  • system/developer: instrukcje programisty, zawsze pierwsze, definiują ogólne zachowanie
  • user: wiadomości od użytkownika końcowego, uruchamiają generowanie odpowiedzi
  • assistant: wcześniejsze odpowiedzi modelu, przydatne do historii i promptowania few-shot
  • Role system i developer są wymienne w API xAI
  • Ostatnia wiadomość w tablicy musi być wiadomością user