Struttura le tue istruzioni

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.

A cosa serve la struttura nel prompting?

Pensa alla differenza tra una valigia ben organizzata e una in cui è stato gettato tutto alla rinfusa. Il contenuto è lo stesso, ma la struttura determina se trovi rapidamente ciò di cui hai bisogno – o se devi scavare attraverso tutto.

Per i modelli AI vale esattamente lo stesso principio: un prompt ben strutturato aiuta il modello a identificare rapidamente cosa è importante, quali regole si applicano e come le diverse parti si collegano tra loro. Un prompt non strutturato lascia il modello a indovinare – e le supposizioni portano a risultati incoerenti.

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.

Tre motivi per cui la struttura è fondamentale

1. Il modello sa dove cercare

Quando le informazioni sono suddivise in sezioni chiare, il modello non deve indovinare cosa è un’istruzione, un esempio o informazioni di background. Questo riduce drasticamente il rischio di interpretazioni errate.

2. Ottieni risultati coerenti

Un prompt caotico può dare risposte diverse ogni volta – anche con lo stesso input. La struttura crea prevedibilità e affidabilità, il che è critico quando stai costruendo qualcosa da usare in pratica.

3. Più facile da mantenere e sviluppare

Quando tu o qualcun altro del team dovete aggiornare il prompt in seguito, è enormemente più semplice se tutto ha il suo posto. Sai subito dove adattare le regole, aggiungere esempi o cambiare il tono.

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.

Tecniche di strutturazione da usare subito

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.

Errori strutturali comuni – e come evitarli

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.

Checklist: il tuo prompt ha una buona struttura?

Usa questa checklist mentre costruisci e migliori il tuo prompt di sistema:

✅ Ho sezioni chiare? (Ruolo, Compito, Regole, ecc.)

✅ Gli esempi sono separati dalle istruzioni?

✅ I miei vincoli più importanti sono posizionati tardi nel prompt?

✅ Qualcun altro può leggere e capire il mio prompt in 30 secondi?

✅ Le istruzioni negative (“NON fare”) sono chiaramente contrassegnate?

✅ Uso tag XML se ho contesti complessi o molti esempi?

Se puoi rispondere sì ad almeno 4 su 6 punti, sei sulla strada giusta!

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

5 domande · 100% per superarlo · Rivedi le risposte al termine

Inizia il quiz →