Il problema

Gli agenti non ricevono gli ordini in un formato pulito. Il cliente scatta una foto agli appunti, manda un PDF con gli articoli da riacquistare, registra un messaggio vocale o scrive una lista su WhatsApp. Poi l’agente deve ricopiare tutto nell’app, articolo per articolo.

È un lavoro lento e ripetitivo, e ogni passaggio a mano è un’occasione di errore: un codice sbagliato, una quantità letta male, una variante confusa con un’altra. Su un ordine, un errore ricade sull’agente e sul cliente.

Vincoli

  • Un tablet, quindi poco spazio per mostrare più informazioni insieme.
  • Un file alla volta: non si possono caricare più file insieme.
  • Connessione obbligatoria: senza internet l’AI non lavora.
  • Il flusso dell’ordine manuale non si tocca: la funzionalità doveva aggiungersi all’esistente, non sostituirlo.
  • Due settimane di design.
  • Niente agenti nei test: il cliente non aveva tempo da dedicare, quindi i test si sono fatti con il suo IT manager.

Come ho lavorato

Ho raccolto i requisiti e i vincoli tecnici con gli sviluppatori, poi ho costruito con Claude Code un prototipo funzionante del flusso d’ordine, che integrava il comportamento dell’AI. Lo abbiamo mostrato al cliente: ha fatto l’effetto wow e ha validato diverse scelte prima dello sviluppo.

  1. Scegli il fileFoto, PDF, audio o testo, uno alla volta
  2. L’AI elaboraUn dialog di caricamento; senza connessione non parte
  3. RevisioneFile e articoli affiancati, con un badge di confidenza
  4. OrdineGli articoli entrano nell’ordine manuale esistente
Il flusso, dal file all’ordine. L’agente resta nel flusso che conosce già: la funzionalità si aggiunge, non lo sostituisce.

Le decisioni chiave

1. Il file originale accanto alla lista

Decisione
Dopo l’elaborazione l’agente vede da una parte gli articoli riconosciuti, dall’altra il file originale: la foto, il PDF, il testo o l’audio.
Alternativa scartata
Mostrare solo la lista. Su un tablet lo spazio per due colonne è poco, e l’idea di rinunciare al confronto era concreta.
Perché
Senza il file sotto gli occhi l’agente non ha niente con cui controllare il lavoro dell’AI. Ho insistito per il confronto affiancato, ed è stata la scelta più apprezzata nella demo del prototipo.

2. Gli articoli nello stesso ordine del file

Decisione
La lista segue l’ordine in cui gli articoli compaiono nel file.
Alternativa scartata
Ordinarli in altri modi.
Perché
L’agente scorre file e lista insieme, riga per riga. Così il controllo è più veloce.

3. La confidenza a parole, non a numeri

Decisione
Ogni articolo ha un badge: «Attendibile», «Parzialmente attendibile» o «Non riconosciuto». Quando l’agente sostituisce un articolo, compare «Modificato».
Perché
Gli utenti vogliono poter controllare tutto, ma poi al controllo dedicano poca attenzione. Il badge porta l’occhio solo sui punti critici, e dice in parole cosa fare, senza affidarsi solo al colore.
Wireframe della schermata di revisione, con contenuti fittizi: gli appunti e, accanto, gli articoli nello stesso ordine, ognuno con unità di vendita, quantità e badge di confidenza. In fondo, quanti articoli l’AI ha rilevato, proposto e non trovato.

La revisione, passo per passo

  1. Il cliente manda gli appunti: una foto, un PDF, un audio o un testo copiato da WhatsApp.

  2. L’AI legge il file e compila gli articoli nello stesso ordine: l’agente scorre file e lista insieme, riga per riga.

  3. Ogni articolo ha un badge che dice a parole quanto fidarsi: «Attendibile», «Parzialmente attendibile», «Modificato».

  4. Quello che l’AI non riconosce resta evidenziato, da cercare o aggiungere a mano.

  5. In fondo, il riepilogo: quanti articoli l’AI ha rilevato, proposto e non trovato.

  6. L’agente conferma e gli articoli entrano nell’ordine manuale che conosce già.

4. L’AI prepara la bozza, l’agente conferma

Decisione
L’AI inserisce la maggior parte degli articoli. Quelli non riconosciuti sono evidenziati, per cercarli o aggiungerli a mano, e si può sempre aggiungere al volo un articolo che nel file non c’era. Dopo la revisione tutto passa nell’ordine manuale che l’agente conosce già.
Perché
L’agente resta responsabile dell’ordine. L’AI deve fargli risparmiare tempo, non togliergli il controllo.

5. Un prototipo funzionante invece di un mockup

Decisione
Ho costruito con Claude Code un prototipo del flusso che si usa davvero, con l’AI integrata.
Alternativa scartata
Mockup statici.
Perché
Con l’AI il comportamento conta quanto l’aspetto: attese, articoli riconosciuti a metà, correzioni. Un prototipo funzionante lo fa vedere.
Che cosa ha comportato
Nella demo il cliente ha visto subito il valore della funzionalità e alcune scelte, come il confronto affiancato, sono state validate prima dello sviluppo.

La soluzione

  • Quattro tipi di input: foto, PDF, audio e testo copiato da WhatsApp.
  • Elaborazione: un dialog di caricamento mentre l’AI lavora; senza connessione la funzionalità non parte.
  • Un file alla volta: mentre c’è un file in elaborazione la selezione è bloccata, e una label lo spiega.
  • Revisione: file e lista affiancati, articoli nello stesso ordine, badge di confidenza, non riconosciuti evidenziati, aggiunta al volo.
  • Conferma: gli articoli entrano nell’ordine manuale esistente.

Risultati

  • −30% dei tempi di inserimento. Lo abbiamo misurato in un test con l’IT manager del cliente: lo stesso ordine, da una foto di una lista di articoli, inserito prima a mano e poi con la funzionalità. Il tempo comprende anche l’elaborazione dell’AI e il controllo.
  • In produzione da marzo 2026 per il cliente, con un feedback positivo.
  • Verso l’app standard: la funzionalità ora si sta integrando nella versione per tutti i clienti.

Cosa ho imparato

Con l’AI il paradosso è il controllo: gli utenti lo vogliono sempre, ma lo esercitano con poca attenzione. Per questo l’interfaccia non deve chiedere di ricontrollare tutto, ma indicare con chiarezza dove guardare.

La prossima volta vorrei testare con gli utenti veri, gli agenti sul campo. Questa volta il cliente non ha potuto dedicarci tempo, e un IT manager non lavora sotto la stessa pressione di chi raccoglie un ordine tra una visita e l’altra.