In molti team il prompt resta un file nascosto, che modifica chi capita quando capita. Qualcosa non torna? Si aggiunge una frase. Il tono non convince? Un’altra. Dopo qualche settimana il file assomiglia a una soffitta dove nessuno butta più niente.
Eppure, nei prodotti che usano agenti AI, quel file è interfaccia a tutti gli effetti. Non un trucco tecnico: è il documento che fissa ruolo, tono, limiti, priorità, formato e comportamento dell’agente.
Il prompt modella l’esperienza
Dal prompt dipende se l’agente risulta prudente o invadente, chiaro o prolisso, operativo o vago, trasparente o troppo sicuro di sé, rispettoso dei limiti o pronto a improvvisare. L’utente quel testo non lo vede quasi mai. Ne sente però gli effetti a ogni risposta.
Cosa deve contenere un prompt di prodotto
Un prompt che funziona mette nero su bianco diverse cose:
- il ruolo dell’agente;
- l’obiettivo del task;
- le fonti ammesse;
- le azioni vietate;
- quando chiedere chiarimenti;
- quando escalare a un umano;
- il formato dell’output;
- il tono;
- come bilanciare velocità, accuratezza e sicurezza quando entrano in conflitto.
Niente di tutto questo sostituisce i controlli scritti nel codice. Li completa.
Versionare i prompt per gestire l’incertezza
Quando cambi un prompt e la performance si muove, devi poter dire cosa è successo. Per questo il versionamento è la base. Di ogni versione conviene tenere traccia del numero, della data di modifica e del motivo per cui l’hai toccato, dell’esperimento collegato, delle metriche prima e dopo, e dei problemi ancora aperti.
Senza questa storia diventa difficile capire se un miglioramento arriva dal modello, dai dati o dalle istruzioni che hai scritto tu.
Allineare prompt, design e permessi
Il prompt va scritto insieme a chi progetta l’esperienza, non dopo. Se la UI promette “risposta immediata” ma il prompt impone prudenza e verifica, l’utente percepisce una stonatura. Se l’interfaccia invita a chiedere qualsiasi cosa mentre il perimetro reale è stretto, resterà deluso. Prompt, interfaccia e permessi devono raccontare la stessa storia.
Applicare il prompt come interfaccia senza complicare il lavoro
Non partire dallo strumento più nuovo. Parti dal punto in cui il team perde tempo, discute senza dati o decide con informazioni incomplete. Lì capisci se il tema ha valore operativo o è solo una bella idea.
La regola, in fondo, è semplice. Un agente non è una chat brillante. Ha bisogno di input chiari, di strumenti limitati, di una memoria controllata e di una regola esplicita che gli dica quando passare la decisione a una persona perché il rischio è salito troppo.
In pratica conviene procedere così:
- definire quali dati l’agente può leggere e quali no;
- scrivere il risultato atteso in forma verificabile, non come intenzione generica;
- decidere quando serve una revisione umana prima di inviare o salvare l’output;
- misurare tempo risparmiato, errori evitati e casi in cui l’agente si ferma.
Cosa misurare per capire se funziona
La domanda giusta non è “abbiamo usato AI?” né “abbiamo aggiunto una dashboard?”. È un’altra: quale decisione è diventata più veloce, più chiara o più sicura? Se nessuna decisione cambia, il progetto rischia di restare decorazione tecnica.
Misura su almeno tre piani: tempo operativo risparmiato, qualità del risultato e fiducia del team nel processo. Il solo tempo inganna, perché un flusso più rapido ma meno controllabile non è un progresso. Anche la sola qualità inganna: un sistema perfetto ma troppo lento non entra mai nel lavoro di tutti i giorni.
C’è poi un controllo finale, molto concreto. Chiedi a chi userà il processo cosa farebbe domani con questa informazione. Se la risposta resta vaga, non manca tecnologia. Manca un legame chiaro tra dato, responsabilità e azione.
Il punto
Il prompt è il contratto comportamentale dell’agente: dice come il sistema si muove nel mondo. Trattarlo come un dettaglio tecnico è un errore. Considerarlo un artefatto di prodotto lo rende più chiaro, più misurabile e più facile da migliorare.