Lezione 2: Prompting che funziona

Introduzione e obiettivi

Nella Lezione 1 hai capito come ragiona Claude. Oggi impariamo a parlargli bene. Il «prompt» è semplicemente la tua richiesta: il testo che scrivi. E qui c'è la notizia più importante di tutto il corso: il 90% della qualità di una risposta dipende dalla qualità della richiesta, non dal modello.

La buona notizia è che non serve imparare formule magiche o «prompt segreti». Serve un metodo semplice e ripetibile, che oggi ti do e che userai per sempre. Vedremo:

• L'anatomia di un buon prompt: i cinque ingredienti che fanno la differenza.
• Come dare un ruolo e usare gli esempi per orientare le risposte.
• Come iterare: migliorare una risposta invece di ricominciare da zero.
• Gli errori che quasi tutti fanno all'inizio (e che tu smetterai di fare).

L'anatomia di un buon prompt

Un prompt efficace risponde, esplicitamente, a cinque domande. Non devi metterle tutte ogni volta, ma tienile a mente: quando una risposta è deludente, quasi sempre ne manca una.

Prima e dopo: lo stesso compito, due richieste

Guarda la differenza. Ecco un prompt debole, quello che scrive quasi tutti all'inizio:

Scrivimi una email per un cliente che non ha pagato.

Otterrai qualcosa di generico, magari troppo formale o troppo aggressivo. Ora lo stesso compito con i cinque ingredienti:

CONTESTO: sono un fornitore di servizi; il cliente è un'azienda
con cui lavoro da anni e voglio mantenere un buon rapporto.
La fattura n. 128 (1.200 €) è scaduta da 20 giorni.

COMPITO: scrivi una email di primo sollecito, gentile ma chiara.

FORMATO: oggetto + corpo, massimo 120 parole.

VINCOLI: tono cordiale, nessun linguaggio legale o minaccioso,
proponi di sentirci se ci sono problemi.

La seconda richiesta produce, alla prima, una email quasi pronta da inviare. Nota che non hai usato parole difficili: hai solo detto chiaramente cosa vuoi. Questo è il cuore del prompting.

Dare un ruolo e degli esempi

Due tecniche semplici alzano molto la qualità delle risposte.

Il ruolo

Dire a Claude chi essere orienta il registro e il tipo di attenzione. Confronta:

Rivedi questo testo.

Agisci come un editor esperto di testi divulgativi.
Rivedi questo testo per renderlo più chiaro e scorrevole,
segnalandomi le tre modifiche più importanti che hai fatto.

Il ruolo non è una «magia»: è un modo veloce per comunicare aspettative (competenza, tono, priorità). Usalo quando il compito ha un «mestiere» dietro (editor, analista, insegnante, addetto al supporto…).

Gli esempi (few-shot)

Il modo più potente di ottenere esattamente lo stile che vuoi è mostrare un esempio. In gergo si chiama few-shot: dai uno o due esempi di «input → output» e Claude imita lo schema. È utilissimo per compiti ripetitivi.

Trasforma le note in una riga di CRM così:

Esempio 1
Nota: "chiamato Rossi, interessato al pacchetto base, richiama lunedì"
Riga: [Rossi] | interesse: pacchetto base | prossima azione: richiamare lunedì

Esempio 2
Nota: "Bianchi vuole preventivo per 3 licenze entro venerdì"
Riga: [Bianchi] | interesse: 3 licenze | prossima azione: inviare preventivo entro venerdì

Ora fai lo stesso con questa nota:
"parlato con Verdi, non convinto dal prezzo, valutare sconto"

Con due esempi, Claude capisce il formato meglio di qualsiasi spiegazione. Questa tecnica sarà preziosa quando, nella Lezione 3, la trasformeremo in istruzioni permanenti di un Progetto.

Iterare invece di rifare

L'errore mentale più comune è trattare Claude come un distributore automatico: prompt → risposta → se non va, riscrivo tutto. In realtà stai conversando: la risposta imperfetta è un punto di partenza, non un fallimento.

Invece di ricominciare, correggi il tiro con messaggi brevi:

• «Più corto, la metà delle parole.»
• «Tono più informale, dammi del tu.»
• «Il secondo punto non mi convince, riscrivilo con un esempio concreto.»
• «Trasformalo in una tabella con colonne Pro e Contro.»

Due mosse avanzate che fanno una grande differenza:

• Chiedere il ragionamento: «Prima di rispondere, elenca i criteri che userai.» Spesso una risposta «ragionata ad alta voce» è più solida.
• Far criticare l'output: «Rileggi la tua risposta e trova due punti deboli, poi correggili.» Claude è sorprendentemente bravo a migliorarsi se glielo chiedi.

Gli errori più comuni

Ecco la lista degli errori che vedo più spesso in aula. Riconoscerli è metà del lavoro.

Laboratorio: il prompt in tre versioni

Questo laboratorio ti fa toccare con mano il valore dell'iterazione e della struttura.

Consegna

Scegli un compito reale del tuo lavoro (una email delicata, la scaletta di un intervento, la descrizione di un prodotto, un riassunto). Poi costruisci il prompt in tre versioni, salvando ogni volta la risposta di Claude:

1. Versione 1 — grezza: scrivi la richiesta «di pancia», come faresti d'istinto.
2. Versione 2 — strutturata: riscrivila usando i cinque ingredienti (contesto, compito, formato, vincoli, esempi).
3. Versione 3 — iterata: parti dalla risposta della v2 e miglioralा con 2–3 correzioni mirate.

Consegna finale

Prepara un breve documento «prima / dopo» con: le tre versioni del prompt, la risposta finale, e 3 righe di note su cosa è cambiato e perché la v3 è migliore della v1.

Mini-test di autoverifica

Sezione A: risposta multipla

1. I cinque ingredienti di un buon prompt sono contesto, compito, formato, vincoli e:
   a) modello   b) esempi   c) token   d) piano
2. Dare un ruolo a Claude serve soprattutto a:
   a) renderlo più veloce   b) orientare registro e tipo di attenzione   c) aumentare il contesto   d) evitare i costi
3. Il «few-shot» consiste nel:
   a) usare pochi token   b) fare più chat   c) fornire uno o due esempi di input→output   d) scegliere Haiku
4. Se la prima risposta è quasi buona, la mossa migliore è:
   a) riscrivere tutto il prompt   b) cambiare modello   c) correggere il tiro con un messaggio breve   d) accettarla comunque
5. Quale NON è un buon rimedio contro un prompt vago?
   a) Aggiungere contesto   b) Specificare il formato   c) Mettere dieci richieste insieme   d) Dare un esempio
6. «Rileggi la tua risposta e trova due punti deboli» è un esempio di:
   a) few-shot   b) far criticare/migliorare l'output   c) cambio di modello   d) vincolo di formato

Sezione B: risposta aperta

7. (3 punti) Prendi il prompt «Scrivimi un post per i social» e riscrivilo usando almeno quattro dei cinque ingredienti, riferito a un tuo caso concreto.
8. (3 punti) Spiega la differenza tra «rifare» e «iterare» una richiesta, con un esempio di due correzioni mirate.

Riepilogo della lezione