Ruoli: system, developer, user e assistant
In questa pagina
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
systemedevelopersono intercambiabili nelle API xAI - L’ultimo messaggio nell’array deve essere un messaggio
user