“Un prompt non è un desiderio sussurrato a un genio. È un capitolato che consegni a un appaltatore.”
Un prompt è un documento strutturato
Un prompt di produzione non è una frase. È un documento a livelli: un messaggio di sistema che stabilisce il ruolo e le regole, istruzioni chiare per il compito, due o tre esempi risolti, l'input reale dell'utente, e una specifica del formato di output. Ogni livello svolge un compito diverso, e ometterne uno è dove la qualità si disperde.
Il motivo per cui la struttura batte l'astuzia: i modelli sono molto più bravi nell'imitazione che nel seguire istruzioni astratte. Mostra al modello esattamente come è fatto un buon output e replicherà il pattern. Descrivilo con aggettivi e improvviserà.
Le tecniche portanti
La maggior parte dei consigli sui prompt è un ottimo locale che crolla alla prossima release del modello. Pochi principi si generalizzano perché riguardano l'informazione, non i trucchi:
- Vincoli: indica il formato, la lunghezza e cosa escludere. Una scatola stretta si riempie bene; un prompt aperto si improvvisa.
- Esempi (few-shot): mostra coppie input/output. La singola cosa a più alto impatto che puoi aggiungere a un prompt.
- Decomposizione: dividi un compito in più passi in più prompt, oppure chiedi al modello di ragionare per passi prima di rispondere.
- Ruolo e pubblico: "sei un editor tecnico scrupoloso che scrive per non esperti" plasma il registro in modo più affidabile di qualsiasi aggettivo nell'istruzione.
- Schema di output: indica la forma esatta (chiavi JSON, sezioni) di cui farai il parsing.
Lascia che il modello pensi prima di rispondere
Per qualsiasi cosa che coinvolga ragionamento, chiedere direttamente la risposta finale lascia qualità sul tavolo. Lasciare che il modello produca prima un ragionamento intermedio (la "chain of thought") migliora in modo misurabile i risultati sui problemi a più passi, perché ogni token generato può condizionarsi sui precedenti. Gli stai dando spazio per lavorare.
La forma pratica: chiedi il ragionamento, poi la risposta, in un output strutturato, ed estrai la risposta. Oppure, con i modelli di "reasoning" più recenti, la riflessione avviene internamente e paghi semplicemente in latenza e token. In ogni caso, i problemi difficili vogliono deliberazione, non una risposta istintiva.
Versiona i tuoi prompt come codice
Un prompt è la stringa più portante della tua applicazione, e i team di routine lo modificano in una casella di testo in produzione senza alcuna cronologia. È folle nel momento in cui lo dici ad alta voce. I prompt appartengono al controllo di versione, con un changelog, legato all'esecuzione di eval che ha giustificato la modifica.
La disciplina: una modifica di prompt è una modifica di codice. Ottiene una diff, una review, un'esecuzione di eval e un percorso di rollback. "Ho ritoccato il prompt e sembra meglio" è il modo in cui i team spediscono regressioni silenziose che scoprono da utenti arrabbiati una settimana dopo.
Una riga per ciascuno
- Un prompt è un documento strutturato: sistema, istruzioni, esempi, input, schema di output.
- Gli esempi battono le istruzioni; i vincoli battono la speranza; lascia che il modello ragioni prima delle risposte difficili.
- Non collezionare trucchi; interiorizza i principi, che sopravvivono ai cambi di modello.
- I prompt sono codice: versionali, revisionali e condiziona le modifiche a un'esecuzione di eval.
Dove andare ora