Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Ruoli: System, User e Assistant

Lezione 2 di 16 Aggiornata il 2 novembre 2026 Principiante
In questa pagina
  1. Comprendere il sistema dei ruoli
  2. Il ruolo system: le fondamenta del tuo prompt
  3. Il ruolo user: la richiesta concreta
  4. Il ruolo assistant: guidare la risposta
  5. Il ruolo tool: risultati delle funzioni
  6. Costruire una conversazione completa
  7. Punti chiave

Comprendere il sistema dei ruoli

Le API Chat Completions di Mistral strutturano ogni conversazione attorno ai ruoli assegnati ai messaggi. Ogni messaggio inviato al modello deve includere un ruolo che ne definisca la funzione nello scambio: chi sta parlando e con quale autorità. Questo meccanismo potrebbe sembrare un dettaglio tecnico, ma è in realtà la spina dorsale di qualsiasi prompt professionale: è ciò che distingue una semplice domanda posta in una chat da un’applicazione costruita con cura.

Mistral riconosce quattro ruoli distinti, ognuno con una funzione precisa:

Role Description Example
system Defines the model's personality, behavior, and overall context "You are a French legal expert specializing in labor law."
user Contains the user's request or instruction "What are the employer's obligations in case of economic dismissal?"
assistant Represents the model's responses, or lets you pre-fill the start of a response "Here are the 5 main obligations: 1. ..."
tool Returns the result of a function call (function calling) JSON result from a database search

Il ruolo system: le fondamenta del tuo prompt

Il messaggio system arriva per primo nell’elenco dei messaggi e agisce come una direttiva permanente che influenza l’intera conversazione. Consideralo come la descrizione del lavoro che consegneresti a un nuovo membro del team prima del suo primo giorno: definisce la personalità attesa (tono, livello di formalità, lingua), l’area di competenza preferita, le regole su ciò che il modello deve o non deve fare e il formato predefinito delle sue risposte. Una volta scritta questa descrizione, ogni scambio successivo si inserisce in questo quadro senza che tu debba ripeterlo.

messages = [
    {
        "role": "system",
        "content": """You are a senior technical writer specializing in API documentation.
Rules:
- Use precise technical English
- Always include Python code examples
- Structure your responses with headings and lists
- Never exceed 500 words per response"""
    },
    {
        "role": "user",
        "content": "Explain how to handle HTTP errors in a REST API."
    }
]

Nota un punto importante per le tue future applicazioni: il prompt di sistema è gestito dallo sviluppatore, non dall’utente finale. L’utente della tua applicazione non lo vede mai, ma tutte le sue interazioni avvengono all’interno del quadro che hai stabilito lì. Questo lo rende la tua leva di controllo più potente.

Il ruolo user: la richiesta concreta

Il messaggio user contiene la richiesta specifica. Questo è il ruolo più intuitivo: rappresenta ciò che l’essere umano dice al modello e ogni nuova domanda o istruzione dell’utente diventa un messaggio con il ruolo user. La sua apparente semplicità non deve farti dimenticare le migliori pratiche: sii preciso nella tua richiesta, specifica il formato desiderato se differisce da quello definito nel prompt di sistema e fornisci direttamente nel messaggio i dati di cui il modello ha bisogno: un testo da riassumere, cifre da analizzare. Il modello non può recuperare ciò che non gli dai.

Il ruolo assistant: guidare la risposta

Il ruolo assistant è il più sottile dei tre perché ha due usi distinti. Il primo è la cronologia della conversazione: in uno scambio multi-turno, le risposte precedenti del modello vengono reinserite con il ruolo assistant per mantenere il contesto. È così che il modello «ricorda» ciò che ha detto:

messages = [
    {"role": "user", "content": "What is the capital of France?"},
    {"role": "assistant", "content": "The capital of France is Paris."},
    {"role": "user", "content": "And its population?"}
]

Senza il messaggio intermedio dell’assistant, il «sua» nell’ultima domanda non si riferirebbe a nulla: l’API è stateless e tu ricostruisci la memoria a ogni chiamata.

Il secondo uso è il prefilling (prefisso): puoi terminare il tuo elenco di messaggi con un messaggio assistant che contiene l’inizio della risposta attesa. Il modello continuerà da questo punto, come se le prime parole fossero già uscite dalla sua bocca. Questa è una tecnica potente per controllare il formato dell’output:

messages = [
    {"role": "user", "content": "List 3 Python frameworks for the web."},
    {"role": "assistant", "content": "```json\n[", "prefix": True}
]

Nota il campo "prefix": True: l’API di Mistral lo richiede su quest’ultimo messaggio assistant per trattarlo come l’inizio di una risposta.

Qui, il modello capisce che sta scrivendo JSON e completerà l’array iniziato, senza preamboli o frasi introduttive. Laddove un’istruzione testuale «rispondi in JSON» potrebbe essere ignorata, un inizio di risposta già scritto lascia poche scelte.

Il ruolo tool: risultati delle funzioni

Il ruolo tool entra in gioco durante il function calling. Quando il modello decide di chiamare una funzione esterna (una ricerca sul web, una richiesta API, un calcolo), il risultato di tale funzione gli viene inviato come messaggio tool, che integra poi nella sua risposta. Questo ruolo è più avanzato e sarà trattato in corsi dedicati; ricorda semplicemente che esiste e completa la triade principale.

Costruire una conversazione completa

Mettiamo ora insieme tutti questi elementi in uno scambio realistico, dove il prompt di sistema inquadra l’assistant, dove la cronologia mantiene il filo del discorso e dove l’ultima domanda si costruisce naturalmente su quanto precede:

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {
            "role": "system",
            "content": "You are a French culinary assistant. Respond concisely."
        },
        {
            "role": "user",
            "content": "How do I make a classic vinaigrette?"
        },
        {
            "role": "assistant",
            "content": "For a classic vinaigrette, mix 1 spoon of mustard, 3 spoons of olive oil, and 1 spoon of vinegar."
        },
        {
            "role": "user",
            "content": "And for a lighter version?"
        }
    ]
)

Osserva l’architettura: prima il system, poi un’alternanza user/assistant che riproduce il flusso della conversazione. Questo ordine non è decorativo: è ciò che permette al modello di interpretare correttamente «una versione più leggera» come una variante della vinaigrette appena discussa.

Punti chiave

  • Il ruolo system inquadra il comportamento globale del modello: è la tua leva più potente
  • Il ruolo user trasporta la richiesta concreta dell’utente
  • Il ruolo assistant funge sia da cronologia sia da guida per il formato della risposta
  • Il ruolo tool gestisce i risultati delle chiamate di funzione
  • L’ordine dei messaggi è cruciale: prima system, poi alternanza user/assistant