Scrivere le istruzioni di un assistente
Strutturare istruzioni verificabili, scritte con i futuri utenti.
ObiettivoAlla fine di questa lezione saprete redigere con i futuri utenti istruzioni per un assistente verificabili, strutturate in ruolo, risultato, fonti, limiti e comportamento in caso di dubbio.
Le istruzioni sono il testo permanente che delimita un assistente. Dicono a chi si rivolge, cosa deve produrre, come, e cosa non deve fare. È la tappa di co-progettazione partecipativa del ciclo WorkStreams: le istruzioni si scrivono con le persone che useranno l’assistente, non solo per loro.
La struttura che funziona
- Ruolo e pubblico: «Aiuti il team contabilità a rispondere alle domande dei collaboratori sulle note spese.»
- Risultato atteso: formato, lunghezza, lingua e tono.
- Fonti di riferimento: i documenti che fanno fede in caso di dubbio.
- Limiti: ciò che non fa, e a chi indirizza la persona.
- Comportamento in caso di incertezza: porre una domanda o dire che non sa, mai inventare.
Scrivete istruzioni verificabili. «Sii chiaro» non si può verificare. «Rispondi in cinque righe al massimo e cita l’articolo della direttiva pertinente» si può verificare. Ogni frase delle istruzioni deve poter essere controllata su una risposta reale.
Un workshop di co-progettazione
- Riunite tre o quattro futuri utenti per un’ora.
- Chiedete a ciascuno di portare due domande reali ricevute di recente.
- Fate redigere a Learnya una prima versione delle istruzioni a partire dagli appunti del workshop.
- Testate insieme le domande portate in una conversazione del progetto.
- Correggete le istruzioni in diretta, poi riproponete le stesse domande per confrontare.
Il workshop ha un secondo effetto, importante quanto il primo. Le persone che hanno scritto le istruzioni capiscono perché l’assistente risponde così, e lo difendono presso i colleghi. Un assistente progettato senza di loro resta lo strumento di qualcun altro.