Ruoli: System, User, Assistant
In questa pagina
Il sistema di ruoli di Grok
Le conversazioni con Grok si articolano attorno a tre ruoli distinti che strutturano lo scambio. Ogni messaggio inviato al modello include un ruolo che ne indica la funzione all’interno della conversazione. Comprendere questi ruoli è essenziale per scrivere prompt efficaci e ottenere risposte coerenti.
L’API di Grok utilizza un formato di messaggio in cui ogni voce è un oggetto contenente un campo role e un campo content. Questa architettura ti permette di controllare con precisione il comportamento del modello.
Il ruolo System (o Developer)
Il messaggio di sistema è il primo messaggio della conversazione. Definisce il comportamento globale del modello: la sua personalità, i vincoli, il settore di competenza e le regole che deve seguire durante tutto lo scambio.
{
"role": "system",
"content": "You are a cybersecurity expert. You always respond in English, concisely. You cite sources when relevant. You refuse to provide instructions for carrying out attacks."
}
Grok accetta anche il ruolo developer come alias per system. I due sono intercambiabili e producono lo stesso effetto.
Cosa includere nel messaggio di sistema
- Identità: chi è il modello in questa conversazione (esperto, assistente, traduttore…)
- Vincoli: lingua, formato della risposta, lunghezza, tono
- Divieti: ciò che il modello non deve fare
- Contesto aziendale: il dominio, i termini tecnici da utilizzare
Migliori pratiche
- Inserisci sempre il messaggio di sistema per primo
- Sii esaustivo fin dall’inizio: è più efficace specificare tutto nel messaggio di sistema piuttosto che a metà conversazione
- Usa sezioni chiare (con trattini o titoli) per organizzare le tue istruzioni
Il ruolo User
I messaggi user rappresentano gli interventi dell’utente umano. È il ruolo più intuitivo: contiene le tue domande, le richieste e i dati di input.
{
"role": "user",
"content": "Analyze this network architecture and identify the three most critical vulnerabilities."
}
Il contenuto di un messaggio utente può essere una semplice stringa di testo o un array di oggetti per combinare testo e immagini (tratteremo questo aspetto nella lezione 4).
Consigli per i messaggi utente
- Formula una richiesta per messaggio, quando possibile
- Se hai più richieste correlate, numerale
- Fornisci i dati necessari direttamente nel messaggio
Il ruolo Assistant
I messaggi assistant contengono le risposte del modello. Normalmente non li scrivi tu: è Grok a generarli. Tuttavia, puoi includerli nella cronologia della conversazione per guidare il modello.
{
"role": "assistant",
"content": "Here are the three identified vulnerabilities: ..."
}
Perché pre-compilare i messaggi Assistant?
Includere messaggi fittizi dell’assistente nella tua cronologia è una tecnica potente:
- Guida lo stile: mostra al modello il formato di risposta atteso
- Mantiene la coerenza: simula una conversazione passata affinché il modello prosegua con lo stesso tono
- Few-shot nel contesto: crea coppie domanda/risposta come esempi
L’impatto della struttura dei ruoli
L’ordine e l’organizzazione dei messaggi influenzano direttamente la qualità della risposta. Ecco la struttura consigliata:
[
{"role": "system", "content": "Global instructions..."},
{"role": "user", "content": "First user message..."},
{"role": "assistant", "content": "Model response..."},
{"role": "user", "content": "Next message..."}
]
L’endpoint Chat Completions di Grok è stateless: non mantiene alcuna cronologia tra le richieste. Devi includere tutto il contesto conversazionale in ogni chiamata. Questo significa che, se desideri una conversazione di 5 turni, la tua quinta richiesta deve contenere i precedenti 4 turni.
Esercitazione pratica
Testa l’impatto del messaggio di sistema inviando la stessa domanda con due configurazioni diverse:
Configurazione A:
[
{"role": "system", "content": "You are a math teacher for high school seniors."},
{"role": "user", "content": "Explain limits."}
]
Configurazione B:
[
{"role": "system", "content": "You are a senior software engineer specialized in distributed systems."},
{"role": "user", "content": "Explain limits."}
]
La stessa domanda produce due risposte radicalmente diverse a seconda del ruolo di sistema definito. L’insegnante parlerà di limiti matematici, l’ingegnere di rate limiting e quote.
Punti chiave
- Tre ruoli strutturano le conversazioni:
system(odeveloper),usereassistant - Il messaggio di sistema definisce il comportamento globale e deve essere inserito per primo
- L’API è stateless: includi l’intera cronologia in ogni richiesta
- Pre-compilare i messaggi dell’assistente ti permette di guidare lo stile e il formato della risposta
- Un messaggio di sistema ben scritto è spesso più efficace di molteplici correzioni a metà conversazione