Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Ruoli: system, developer, user e assistant

Lezione 2 di 12 Aggiornata il 30 luglio 2026 Sviluppatore
In questa pagina
  1. I quattro ruoli dei messaggi
  2. Il ruolo system (o developer)
  3. Il ruolo user
  4. Il ruolo assistant
  5. Struttura completa della richiesta
  6. Punti chiave

I quattro ruoli dei messaggi

Ogni messaggio inviato all’endpoint Chat Completions include un campo role che determina come il modello Grok lo interpreta. Comprendere questi ruoli è essenziale per strutturare le tue conversazioni e ottenere risposte di qualità.

Le API xAI riconoscono quattro ruoli: system, developer, user e assistant. Ognuno ha una posizione e un utilizzo specifici all’interno dell’array dei messaggi.

Il ruolo system (o developer)

Il messaggio system arriva per primo nell’array dei messaggi. Definisce il comportamento globale del modello per l’intera conversazione: tono, formato di risposta, limiti, personalità, lingua e così via.

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

Il ruolo developer è un alias per system. I due sono intercambiabili nelle API xAI. OpenAI ha introdotto developer per riflettere meglio l’intento: si tratta delle istruzioni dello sviluppatore, non del “sistema”.

Migliori pratiche per il messaggio system

  • Sii specifico: “Rispondi in massimo 3 frasi” è più efficace di “Sii conciso”
  • Definisci il formato: specifica se ti aspetti JSON, Markdown o elenchi puntati
  • Imposta i limiti: indica cosa il modello non deve fare
  • Fornisci contesto: dai un contesto aziendale (“Sei un assistente per una clinica veterinaria”)

Il ruolo user

I messaggi user rappresentano l’input dell’utente finale. Si tratta delle domande, richieste o istruzioni inviate dalla persona che interagisce con la tua applicazione.

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

Un messaggio user può apparire ovunque nella conversazione dopo il messaggio system. In una conversazione multi-turno, alternerai tipicamente messaggi user e assistant.

Il ruolo assistant

I messaggi assistant rappresentano le risposte precedenti del modello. Quando invii indietro una cronologia di conversazione, ogni risposta di Grok è contrassegnata con questo ruolo.

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

Puoi anche usare il ruolo assistant per il few-shot prompting: iniettare esempi di risposte desiderate prima del messaggio utente effettivo.

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

In questo esempio, i primi due scambi user/assistant fungono da dimostrazione. Il modello comprende il formato previsto e applicherà la stessa logica al terzo messaggio.

Struttura completa della richiesta

Ecco una richiesta tipica che combina tutti e tre i ruoli in una conversazione multi-turno:

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

L’ordine è sempre lo stesso: system per primo, poi l’alternanza user/assistant, con l’ultimo messaggio obbligatoriamente user (questa è la domanda a cui il modello deve rispondere).

Punti chiave

  • system/developer: istruzioni dello sviluppatore, sempre per prime, definiscono il comportamento globale
  • user: messaggi dell’utente finale, attivano la generazione della risposta
  • assistant: risposte precedenti del modello, utili per la cronologia e il few-shot prompting
  • I ruoli system e developer sono intercambiabili nelle API xAI
  • L’ultimo messaggio nell’array deve essere un messaggio user