Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Rollen: system, developer, user und assistant

Lektion 2 von 12 Aktualisiert am 30. Juli 2026 Entwickler
Auf dieser Seite
  1. Die vier Nachrichtenrollen
  2. Die Rolle system (oder developer)
  3. Die Rolle user
  4. Die Rolle assistant
  5. Die vollständige Anforderungsstruktur
  6. Wichtige Kernaussagen

Die vier Nachrichtenrollen

Jede Nachricht, die an den Endpunkt Chat Completions gesendet wird, enthält ein Feld role, das bestimmt, wie das Grok-Modell die Nachricht interpretiert. Das Verständnis dieser Rollen ist unerlässlich, um Gespräche strukturiert aufzubauen und qualitativ hochwertige Antworten zu erhalten.

Die xAI-API erkennt vier Rollen: system, developer, user und assistant. Jede hat eine spezifische Position und Verwendung innerhalb des Nachrichtenarrays.

Die Rolle system (oder developer)

Die Nachricht mit der Rolle system steht zu Beginn des Nachrichtenarrays. Sie definiert das allgemeine Verhalten des Modells für den gesamten Gesprächsverlauf: Tonfall, Antwortformat, Grenzen, Persönlichkeit, Sprache und vieles mehr.

{
  "role": "system",
  "content": "Sie sind ein Sicherheitsexperte. Antworten Sie stets auf Englisch, präzise und technisch. Wenn Sie die Antwort nicht kennen, geben Sie dies klar an."
}

Die Rolle developer ist ein Alias für system. Beide sind in der xAI-API austauschbar. OpenAI hat developer eingeführt, um die Absicht besser widerzuspiegeln: Es handelt sich um Anweisungen des Entwicklers, nicht um die des „Systems”.

Best Practices für die system-Nachricht

  • Seien Sie spezifisch: „Antworten Sie maximal in drei Sätzen” ist wirksamer als „Seien Sie prägnant”.
  • Definieren Sie das Format: Geben Sie an, ob Sie JSON, Markdown oder Aufzählungslisten erwarten.
  • Setzen Sie Grenzen: Weisen Sie das Modell darauf hin, was es nicht tun darf.
  • Bereitstellen Sie Kontext: Geben Sie geschäftlichen Kontext vor („Sie sind ein Assistent einer Tierklinik”).

Die Rolle user

Nachrichten mit der Rolle user repräsentieren die Eingaben des Endnutzers. Dies sind die Fragen, Anfragen oder Anweisungen, die von der Person gesendet werden, die mit Ihrer Anwendung interagiert.

{
  "role": "user",
  "content": "Welche sind die drei häufigsten Web-Schwachstellen?"
}

Eine Nachricht mit der Rolle user kann zu jedem Zeitpunkt im Gespräch nach der system-Nachricht erscheinen. In einem mehrstufigen Gespräch wechseln Sie typischerweise zwischen user- und assistant-Nachrichten.

Die Rolle assistant

Nachrichten mit der Rolle assistant repräsentieren die vorherigen Antworten des Modells. Wenn Sie einen Gesprächsverlauf zurücksenden, wird jede Antwort von Grok mit dieser Rolle gekennzeichnet.

{
  "role": "assistant",
  "content": "Die drei häufigsten Web-Schwachstellen sind:\n1. SQL-Injection\n2. Cross-Site Scripting (XSS)\n3. Defekte Authentifizierung"
}

Sie können die Rolle assistant auch für Few-Shot Prompting verwenden: Sie injizieren Beispiele für gewünschte Antworten vor der eigentlichen user-Nachricht.

{
  "messages": [
    {"role": "system", "content": "Klassifizieren Sie die Stimmung: positiv, negativ oder neutral."},
    {"role": "user", "content": "Ich liebe dieses Produkt!"},
    {"role": "assistant", "content": "positiv"},
    {"role": "user", "content": "Der Kundenservice ist verwerflich."},
    {"role": "assistant", "content": "negativ"},
    {"role": "user", "content": "Die Lieferung ist gestern eingetroffen."}
  ]
}

In diesem Beispiel dienen die ersten beiden user/assistant-Austausche als Demonstration. Das Modell versteht das erwartete Format und wendet dieselbe Logik auf die dritte Nachricht an.

Die vollständige Anforderungsstruktur

Hier ist eine typische Anforderung, die alle drei Rollen in einem mehrstufigen Gespräch kombiniert:

{
  "model": "grok-4.20-0309-reasoning",
  "messages": [
    {
      "role": "system",
      "content": "Sie sind eine Lehrkraft, die sich auf Mathematik spezialisiert hat. Erklären Sie Konzepte Schritt für Schritt."
    },
    {
      "role": "user",
      "content": "Was ist eine Ableitung?"
    },
    {
      "role": "assistant",
      "content": "Eine Ableitung misst die momentane Änderungsrate einer Funktion..."
    },
    {
      "role": "user",
      "content": "Geben Sie mir ein konkretes Beispiel."
    }
  ]
}

Die Reihenfolge ist immer dieselbe: system zuerst, dann abwechselnd user/assistant, wobei die letzte Nachricht zwingend eine user-Nachricht sein muss (dies ist die Frage, die das Modell beantworten muss).

Wichtige Kernaussagen

  • system/developer: Anweisungen des Entwicklers, stets zuerst, definiert das allgemeine Verhalten.
  • user: Nachrichten des Endnutzers, lösen die Antwortgenerierung aus.
  • assistant: Vorherige Modellantworten, nützlich für Historie und Few-Shot Prompting.
  • Die Rollen system und developer sind in der xAI-API austauschbar.
  • Die letzte Nachricht im Array muss eine user-Nachricht sein.