Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Ruoli: System, User, Assistant

Lezione 2 di 14 Aggiornata il 30 luglio 2026 Principiante
In questa pagina
  1. Il sistema di ruoli di Grok
  2. Il ruolo System (o Developer)
  3. Il ruolo User
  4. Il ruolo Assistant
  5. L’impatto della struttura dei ruoli
  6. Esercitazione pratica
  7. Punti chiave

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 (o developer), user e assistant
  • 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