Come scrivere un’attività per un agente AI perché il risultato sia quello giusto

L’attività «Spostare le impostazioni nel nuovo modulo» sembra chiara. L’agente sposta tutte le schede, i test passano. E nel frattempo cambia l’ordine dei campi nella scheda «Account», perché così è più logico, e toglie il vecchio suggerimento sotto la password.

Nulla di tutto questo è un errore. L’agente ha fatto un lavoro sensato, ma non quello che ci si aspettava. L’aspettativa era che per l’utente non cambiasse nulla. Solo che esisteva soltanto nella testa di chi ha scritto l’attività.

Tre cose che l’agente non può indovinare

L’agente è bravo a capire come fare una cosa. Fa più fatica a indovinare che cosa debba uscirne esattamente e dove fermarsi. Per questo conviene che l’attività risponda a tre domande:

  • cosa deve venirne fuori: come apparirà o come funzionerà a lavoro finito;
  • cosa non toccare: ciò che l’agente potrebbe scambiare per un miglioramento, ma che al momento non serve;
  • come verificare: cosa mostrerà che è tutto a posto.

La stessa attività con le aspettative:

Sposta le impostazioni nel nuovo modulo. Per l’utente non cambia nulla: stessi campi, nello stesso ordine, con gli stessi suggerimenti. Elimina i vecchi gestori del modulo. Verifica: ogni scheda salva, gli errori compaiono sotto il campo.

Quattro frasi invece di una. Scriverle richiede un paio di minuti. Capire dopo quali modifiche servivano davvero di solito richiede di più.

Dove stanno le aspettative in Tascue

Alcune aspettative sono le stesse in quasi tutte le attività: «il minimo di codice nuovo», «lascia le modifiche nella copia di lavoro», «alla fine scrivi in breve cosa è stato fatto e cosa no». Non serve riscriverle ogni volta. Sono i frammenti: scritti una volta, finiscono da soli in fondo al prompt.

Per indicare dove guardare ci sono i campi. «Schermata: Impostazioni», e l’agente parte dal punto giusto invece di cercare in tutto il progetto.

Nel testo dell’attività resta ciò che appartiene solo a quella attività: il risultato, i limiti e la verifica. Prima di passarla all’agente si può aprire «Anteprima» e leggere l’intero prompt così come lo vedrà l’agente.

Quando il risultato non torna comunque

A volte le aspettative non coincidono anche con un’attività dettagliata. In quel caso è più semplice aggiungere la correzione all’attività stessa, e non solo alla chat con l’agente. L’attività torna in «In corso», e alla prossima esecuzione l’agente la legge tutta, correzione compresa.

Così le aspettative restano accanto all’attività. Dopo un mese si vede non solo cosa è stato fatto, ma anche cosa ci si aspettava.

Segui Tascue su LinkedIn