Scrivere la missione di un agente IA: il metodo in cinque punti
Un agente funziona bene quanto la sua missione è chiara. Questo corso vi fornisce un metodo in cinque punti per scriverla: lo scopo, gli input, gli output, i limiti e il tono. Vedrete missioni fallite riscritte, e capirete perché un buon agente deve porvi domande prima di agire.
- Una missione chiara dice lo scopo, gli input, gli output, i limiti e il tono.
- I limiti contano quanto lo scopo: scrivete ciò che l'agente non deve mai fare.
- Un output ben descritto si verifica a colpo d'occhio.
- Un buon agente vi pone domande prima di agire, ed è un buon segno.
Quando un agente delude, il riflesso è accusare l'IA. Il più delle volte, è la missione che era vaga. Un nuovo impiegato a cui si dice « occupati dei clienti » farebbe altrettanto disastri. Questo corso non parla di formule magiche. Propone una griglia semplice per dire ciò che vi aspettate, come fareste con un apprendista serio.
IMissione o prompt: quale differenza?
La descrizione scritta di ciò che un agente deve fare, da cosa, per produrre cosa, e entro quali limiti.
Un prompt è un'istruzione puntuale data a un assistente come ChatGPT, per una risposta immediata. Una missione serve a ogni passaggio dell'agente, per settimane. Deve quindi stare in piedi senza che siate lì per precisare.
È la differenza essenziale. In una conversazione, correggete in corso d'opera. Un agente che lavora ogni lunedì ha solo la sua missione e i suoi documenti. Tutto quello che non avete scritto, dovrà indovinarlo, e un agente che indovina finisce per sbagliare.
III cinque punti di una buona missione
- 1L'obiettivo
Una frase con un verbo d'azione e un risultato atteso. « Preparare ogni venerdì la pianificazione delle consegne della settimana successiva », non « aiutarmi con le consegne ».
- 2Gli input
Ciò che l'agente legge per lavorare: quali documenti, quali email, quale elenco. Dite anche quale versione fa fede se due file si contraddicono.
- 3Gli output
Ciò che produce, in quale forma, per chi. Un'email di dieci righe, un preventivo nel formato abituale, una tabella riepilogativa. Più è preciso, più è verificabile.
- 4I limiti
Quello che non fa mai e i casi in cui si ferma per avvisarvi. Gli importi, i temi, i clienti, i giorni da evitare.
- 5Il tono
Forma di cortesia o confidenziale, lunghezza, formule da evitare, firma. Allegate uno o due testi che avete scritto e che vi assomigliano.
Il punto più trascurato è quello dei limiti. Si pensa a cosa l'agente deve fare, raramente a cosa non deve fare. Eppure è lì che si annidano gli errori fastidiosi: uno sconto concesso, un cliente sollecitato durante una controversia, un messaggio inviato una domenica sera.
IIITre missioni fallite, riscritte
Ecco tre missioni tipiche, come spesso si scrivono nelle piccole aziende, poi la loro versione corretta. Notate che la buona versione non è molto più lunga: è semplicemente più precisa.
IVDescrivere l'output per poterlo verificare
Un'uscita ben descritta vi fa risparmiare tempo nella convalida. Se sapete come deve apparire il risultato, vedete subito cosa non va. Precisate la lunghezza, la struttura, gli elementi obbligatori. Per una mail di sollecito, ad esempio: numero di fattura, importo, data di scadenza, mezzo di pagamento, formula di cortesia. Se manca un elemento, lo individuate in cinque secondi invece di rileggere il testo tre volte.
Spuntate ciò che è vero per voi: l'elenco ricorda le vostre risposte su questo dispositivo.
VPerché un agente deve chiedere ciò che gli manca
Anche una buona missione lascia dei vuoti. Scrivete « sollecita le fatture scadute », ma cosa fare di un cliente che ha pagato metà? Un agente che suppone sceglierà al vostro posto. Un agente che chiede vi obbliga a decidere una volta per tutte. Un'agenzia immobiliare che affida la risposta alle richieste di visita penserà agli orari e ai beni disponibili. L'agente, invece, chiederà cosa rispondere a qualcuno che vuole visitare un bene già sotto compromesso. Questo caso accade, e nessuno l'aveva scritto. Per questo un agente ABYS richiede tutto quello che gli serve prima di lavorare: le sue domande non sono un fastidio, sono i casi che non avevate previsto.
VIFar evolvere la missione senza rompere tutto
Una missione non è scolpita nella pietra. Cambiate una cosa alla volta, poi guardate il passaggio successivo. Se modificate contemporaneamente il tono, i tempi e l'elenco dei clienti, non saprete più cosa ha prodotto il cambiamento. Su ABYS, una prova in bianco permette di verificare l'effetto di una modifica senza che nulla parta. Vi consiglio di annotare, in una riga, ogni cambiamento e la sua data: è la vostra memoria quando un risultato vi sorprende.
Un meccanico scrive: « Ogni lunedì, a partire dall'elenco allegato, prepara una mail di dieci righe per ogni fattura scaduta, usando la cortesia formale. » Quale punto del metodo manca?
?Le domande che ci vengono poste
Come scrivere un buon prompt per un'IA?
Dite lo scopo in una frase, date il contesto e i documenti utili, descrivete il risultato atteso, precisate cosa non fare e il tono voluto. Date un esempio di quello che vi piace. Per un agente che lavora da solo per settimane, questi cinque punti diventano indispensabili.
Quale lunghezza deve avere la missione di un agente IA?
Abbastanza lunga da coprire lo scopo, gli input, gli output, i limiti e il tono, spesso una decina o una ventina di righe. Una missione troppo breve lascia l'agente indovinare. Una missione troppo lunga mescola l'essenziale e l'accessorio: i dettagli di riferimento hanno il loro posto nei documenti allegati.
Devo scrivere la missione in inglese perché funzioni meglio?
No. Gli agenti attuali comprendono molto bene il francese. Scrivete nella lingua dei vostri clienti e dei vostri documenti: rileggerete più facilmente la missione, e il tono dei messaggi prodotti sarà più naturale.
Perché il mio agente IA non fa quello che voglio?
Il più delle volte, la missione lascia un margine di interpretazione: uno scopo vago, un documento mancante, un limite non scritto. Rileggete con i cinque punti, confrontate con il risultato ottenuto, poi correggete un solo elemento alla volta e rilanciare una prova in bianco.
Avete la vostra missione in cinque punti? Descrivetela con vostre parole: l'agente vi farà le domande che mancano prima di proporre il suo piano.
Crea il mio agenteDa leggere poi
Creare il vostro primo agente IA in dieci minuti, senza installare nulla
Al termine di questo tutorial, saprete creare un agente IA che si occupa di un'attività precisa della vostra settimana. Saprete cosa lu…
Leggi la lezioneQuali documenti dare a un agente IA, e quali conservare
Un agente IA lavora a partire da ciò che gli dai. Questa guida ti dice quali documenti lo aiutano davvero, sotto quale forma…
Leggi la lezioneGli otto errori che fanno fallire un agente IA, e i loro rimedi
Quando un agente IA delude, la causa è raramente la tecnica. È quasi sempre un'istruzione vaga, un documento dimenticato o un…
Leggi la lezione