Corso di prompting base · 5 min di lettura

Struttura le tue istruzioni

Impara come organizzare i tuoi prompt con sezioni, tag XML e prioritizzazione gerarchica per risultati più coerenti e affidabili.

Introduzione

Obiettivi di apprendimento

Capire perché le istruzioni strutturate danno risultati più coerenti
Saper usare diverse tecniche di strutturazione (sezioni, tag XML, gerarchie)
Identificare gli errori strutturali comuni e come evitarli
Applicare i principi di struttura al tuo prompt di sistema

Nella sezione 2 hai imparato i cinque pilastri – COSA, PERCHÉ, COME, CHI e TONO. Ora facciamo un passo avanti, perché anche se hai tutti i componenti giusti al loro posto, possono facilmente diventare disordinati se non vengono organizzati nel modo giusto. La struttura non è una scelta estetica – è una parte fondamentale per far funzionare l’AI in modo affidabile e coerente.

In questa sezione impari tre tecniche di strutturazione concrete, gli errori più comuni da evitare e una checklist che puoi usare direttamente sui tuoi prompt.

Inizia capendo cosa fa effettivamente la struttura per un prompt – e perché conta.

Ci sono tre motivi concreti per cui la struttura fa la differenza in pratica – e influenzano direttamente come l’AI interpreta e segue le tue istruzioni.

Ora che sai perché la struttura è fondamentale, vediamo tre tecniche concrete che puoi iniziare a usare subito – indipendentemente da quanto sia semplice o complesso il tuo prompt.

Tecnica 1: Sezioni chiare con intestazioni

Il metodo di strutturazione più semplice è dividere il prompt in sezioni con nomi. Funziona perfettamente per la maggior parte dei casi d’uso e risponde direttamente ai cinque pilastri della sezione 2.

## RUOLO
Sei un supporto IT esperto e didattico che lavora in
un'azienda di medie dimensioni.

## COMPITO
Il tuo compito principale è rispondere alle domande IT
dei dipendenti e guidarli passo per passo attraverso le soluzioni.

## SCOPO
L'obiettivo è ridurre il carico sull'IT support e dare
ai dipendenti un aiuto rapido per i problemi ricorrenti.

## REGOLE
- Rispondi sempre in italiano
- Usa massimo 150 parole per risposta
- Se non sai la risposta, scrivi: "Non ho informazioni su questo.
  Contatta l'IT support a support@azienda.it"
- Includi sempre il riferimento alla fonte quando citi guide interne

## TONO
Sii amichevole, professionale e incoraggiante. Evita il gergo
tecnico se non è necessario.

Ogni sezione ha uno scopo chiaro e il modello può facilmente distinguere cosa deve fare (COMPITO) da come farlo (REGOLE + TONO).

Tecnica 2: Tag XML per strutturazione complessa

Quando le tue istruzioni diventano più avanzate – specialmente se hai molti esempi, lunghe liste o informazioni gerarchiche – i tag XML possono fare una grande differenza. Anthropic lo raccomanda in particolare per i modelli Claude.

Pensa ai tag XML come etichette sulle scatole. Proprio come scrivi “VETRO – FRAGILE” su un cartone quando fai i bagagli, i tag XML nominano le cose affinché sia le persone che i modelli sappiano cosa c’è dentro:

<ricettario>
  <ricetta>
    <nome>Frittelle</nome>
    <ingredienti>
      <ingrediente>Farina</ingrediente>
      <ingrediente>Uova</ingrediente>
    </ingredienti>
  </ricetta>
</ricettario>

Ogni <tag> apre una scatola e </tag> la chiude – puoi costruire gerarchie di scatole dentro scatole, proprio come un albero genealogico.

Vantaggi dell’XML

Confini più chiari tra le diverse parti
Più facile per il modello distinguere istruzioni e contenuto
Migliore per contesti lunghi e compiti complessi

Esempio di prompt di sistema con tag XML

<role>
Sei un esperto HR con competenza nel diritto del lavoro italiano.
</role>

<task>
Rispondi alle domande sulle policy HR dell'azienda e fornisci
orientamento su questioni di diritto del lavoro.
</task>

<constraints>
- Non dare mai consulenza legale – rimanda a sindacati o
  avvocati per i casi complessi
- Cita sempre il documento di policy corretto con il numero di pagina
- Rispondi entro 200 parole
- Se mancano informazioni: "Contatta direttamente l'HR per questa domanda"
</constraints>

<examples>
<example>
Utente: "A quanti giorni di ferie ho diritto?"
Assistente: "Secondo la policy ferie dell'azienda (p. 3), i dipendenti
a tempo pieno hanno diritto a 26 giorni di ferie all'anno. Contatta
l'HR a hr@azienda.it per il tuo esatto diritto alle ferie."
</example>
</examples>

<tone>
Professionale, amichevole e di supporto. Usa un linguaggio accessibile
che renda comprensibili le questioni di diritto del lavoro.
</tone>

Quando usare i tag XML?

Quando hai più di 3 esempi
Quando gestisci contesti lunghi (documenti, tabelle di dati, ecc.)
Quando costruisci assistenti complessi con più strumenti
Quando vuoi essere particolarmente chiaro su cosa sono istruzioni vs. dati

Tecnica 3: Organizzazione gerarchica per assistenti complessi

Per casi d’uso più avanzati potresti aver bisogno di costruire gerarchie dove alcune istruzioni sono più importanti di altre.

Il principio di prioritizzazione (Google e Anthropic)

Metti le istruzioni più critiche tardi nel prompt
I vincoli negativi (“NON fare X”) devono venire alla fine
Le regole di formato importanti devono essere ripetute vicino alla fine

## RUOLO GENERALE
Sei un assistente AI per il servizio clienti di una piattaforma e-commerce.

## COMPITI PRIMARI
1. Rispondere a domande su stato degli ordini, consegne e resi
2. Aiutare i clienti con le informazioni sull'account
3. Escalare i casi complessi al supporto umano

## COMPITI SECONDARI
- Fornire raccomandazioni di prodotti su richiesta
- Informare sulle promozioni in corso

## REGOLE DI SICUREZZA CRITICHE (segui sempre queste)
NON condividere MAI numeri di carta completi o password
NON modificare MAI gli indirizzi di consegna senza verifica via email
NON effettuare MAI rimborsi superiori a 500 € senza approvazione
In caso di sospetta frode → ferma immediatamente ed escalare

## IMPORTANTE: Ordine di priorità in caso di conflitto
In caso di dubbio, dai sempre la priorità alle regole di sicurezza
rispetto al servizio rapido.

Le regole di sicurezza sono contrassegnate come critiche, posizionate tardi nel prompt e i simboli visivi (❌ ✅) rendono i vincoli extra chiari.

Conoscere le tecniche giuste è una cosa – evitare le insidie più comuni è un’altra. Ecco i tre errori che si verificano più frequentemente.

Errore 1: Tutto in un unico blocco di testo

Evita:

Sei un assistente di supporto clienti che deve aiutare gli utenti con
domande sui prodotti e devi essere gentile e rispondere brevemente e se
non sai la risposta devi dirlo e devi sempre chiedere se l'utente ha
bisogno di ulteriore aiuto...

Meglio: suddividi in sezioni chiare (RUOLO, COMPITO, REGOLE, TONO) secondo la Tecnica 1 sopra.

Errore 2: Istruzioni mescolate con esempi

Evita:

Devi categorizzare le email dei clienti. Per esempio "Voglio restituire
il mio ordine" va categorizzata come Reso e devi essere conciso e se
riguarda la consegna va categorizzata come Consegna e rispondi sempre
solo con la categoria.

Meglio:

## COMPITO
Categorizza le email dei clienti in arrivo nella categoria giusta.

## CATEGORIE
- Reso
- Consegna
- Domande sul prodotto
- Supporto tecnico
- Altro

## ESEMPI
Email: "Voglio restituire il mio ordine"
Categoria: Reso

Email: "Quando arriva il mio pacco?"
Categoria: Consegna

## FORMATO
Rispondi solo con il nome della categoria, nient'altro.

Errore 3: Vincoli importanti all’inizio del prompt

I modelli possono “dimenticare” vincoli importanti se posizionati troppo presto – specialmente le istruzioni negative.

Evita (posizionamento sbagliato):

NON modificare MAI i dati utente senza approvazione.

[... 300 parole con altre istruzioni ...]

Ora aiuta l'utente con la sua richiesta.

Meglio (regole critiche alla fine):

[... altre istruzioni ...]

## CRITICO: Regole di sicurezza (segui sempre)
- NON modificare MAI i dati utente senza approvazione esplicita
- NON condividere MAI informazioni sensibili con persone non autorizzate

Passa sempre il tuo prompt di sistema attraverso questa checklist prima di metterlo in produzione – ti aiuta a valutare se la struttura regge davvero.

Riepilogo

La struttura non è solo “formattazione bella” – è una parte fondamentale per far funzionare l’AI in modo affidabile. Ecco le quattro intuizioni più importanti da portare con sé.

Sezioni chiare rendono facile per il modello trovare le informazioni giuste e riducono drasticamente il rischio di interpretazioni errate.
I tag XML aiutano con contesti complessi e molti esempi – creano confini chiari che il modello può navigare in sicurezza.
La prioritizzazione gerarchica garantisce che le regole importanti vengano seguite e che i compiti primari non soffochino i vincoli critici.
Le istruzioni critiche alla fine impediscono al modello di “dimenticarle” – metti sempre i vincoli negativi e le regole di sicurezza tardi nel prompt.

Metti alla prova le tue conoscenze

Domanda 1 di 5

Perché la struttura è importante in un prompt di sistema?

Fa sembrare il prompt professionale
Aiuta il modello a identificare rapidamente cosa sono istruzioni, esempi e vincoli
È tecnicamente necessario affinché l'AI funzioni
Rende il prompt più lungo e dettagliato

Struttura le tue istruzioni

Introduzione

1. Il modello sa dove cercare

2. Ottieni risultati coerenti

3. Più facile da mantenere e sviluppare