Come mantenere aggiornata la knowledge base del vostro agente AI: inventario, responsabili, revisioni settimanali e modifiche sicure per PMI.
Avete messo online un agente AI sulla chat del sito o su WhatsApp e per qualche settimana le risposte erano ottime. Poi sono cambiati un listino, gli orari di apertura, una condizione di reso, e l'agente ha continuato a rispondere come prima. Questo articolo propone una routine semplice e sostenibile per una piccola impresa: un inventario iniziale, responsabili chiari, un ciclo di miglioramento settimanale e modi sicuri per cambiare le fonti senza peggiorare le risposte.
Perché le knowledge base invecchiano
Una knowledge base non si rompe: si allontana lentamente dalla realtà. Le cause sono quasi sempre le stesse:
- Il business cambia più in fretta dei documenti. Prezzi, promozioni, tempi di consegna e orari stagionali vengono aggiornati sul sito o nel gestionale, ma non nella fonte che l'agente legge.
- Esistono più versioni della stessa informazione. Un PDF del 2023, una pagina del sito e un testo incollato a mano possono dire cose diverse. L'agente non sa quale sia quella giusta.
- Nessuno ne è responsabile. Chi ha caricato i documenti il primo giorno spesso non è la persona che sa quando una politica cambia.
- I clienti pongono domande nuove. Il catalogo evolve, arrivano nuove stagioni, nuove norme, nuovi dubbi. Le fonti iniziali non le coprono.
Il risultato è un agente che risponde con sicurezza a una domanda con un dato superato. Per il cliente è peggio di una risposta mancante, perché si fida.
Partite da un inventario, non da una riscrittura
Davanti a una base di conoscenza disordinata la tentazione è ricominciare da capo. Di solito non serve e costa settimane. Cominciate invece da un foglio di calcolo con una riga per ogni fonte.
Cosa annotare per ogni fonte
- Nome e tipo: file, frammento di testo, sito web, coppia domanda-risposta, documento di un tool esterno.
- Argomento: resi, spedizioni, prezzi, prenotazioni, garanzia.
- Responsabile: una persona, non un reparto.
- Ultima verifica: la data in cui qualcuno ha controllato che il contenuto sia ancora vero.
- Decisione: tenere, aggiornare, unire con un'altra fonte, eliminare.
Nella maggior parte dei casi scoprirete tre cose: duplicati da unire, documenti scaduti da eliminare e buchi evidenti (ad esempio nessuna fonte sulla gestione dei dati personali dei clienti). Correggere questi tre punti dà già un miglioramento tangibile.
Assegnate responsabili e un ritmo di revisione
La manutenzione funziona quando ha un nome e una cadenza. Nelle PMI non serve un comitato: basta una regola leggera.
| Ruolo | Compito | Frequenza |
|---|---|---|
| Referente della knowledge base | Guarda le conversazioni problematiche e decide cosa correggere | Una volta a settimana |
| Responsabile di argomento | Verifica che le fonti del proprio ambito siano vere | Ogni mese o a ogni cambiamento |
| Titolare o direzione | Approva modifiche a prezzi, garanzie e condizioni | Quando cambiano le regole |
Aggiungete due eventi che fanno scattare una revisione fuori calendario: un cambio di listino o di politica commerciale e il lancio di un nuovo prodotto o servizio. Se in azienda esiste già un momento fisso (la riunione del lunedì, la chiusura del mese), agganciate lì dieci minuti di controllo. Una routine che vive dentro un'abitudine esistente resiste più a lungo di una nuova.
Lasciate che siano le conversazioni a dirvi cosa correggere
Non occorre indovinare dove sono i problemi: le conversazioni reali li mostrano. Che arrivino da WhatsApp, Messenger o dalla chat del sito, i segnali da cercare sono quattro:
- Valutazioni negative (pollice verso il basso) su una risposta.
- Passaggi a un operatore per domande che l'agente avrebbe dovuto saper gestire.
- Domande ripetute che indicano un argomento mal coperto.
- Risposte vaghe, che di solito segnalano una fonte mancante o troppo generica.
Per ogni caso chiedetevi quale sia la causa: informazione assente, informazione superata, due fonti in contrasto oppure istruzioni dell'agente troppo ampie. La correzione cambia a seconda della risposta. Se manca un fatto, si aggiunge una fonte. Se è superato, si aggiorna o si elimina. Se due fonti si contraddicono, se ne tiene una sola.
- 01Leggere le conversazioni segnalate
- 02Individuare la causa
- 03Correggere la fonte
- 04Verificare con una prova
Chiudete sempre il ciclo con una prova: ponete di nuovo la stessa domanda all'agente e controllate che la risposta sia cambiata. Una correzione non verificata è solo una speranza.
Una nota sui dati personali
Le conversazioni contengono nomi, numeri di telefono, a volte ordini. Quando le rileggete per migliorare l'agente, limitate l'accesso a chi ne ha davvero bisogno e non copiate dati personali nelle fonti. Una risposta modello deve essere generica ("il rimborso viene effettuato entro i termini indicati"), non il testo di una conversazione con un cliente reale. Questo è coerente con i principi del GDPR, in particolare minimizzazione e limitazione delle finalità.
Tenete le fonti ordinate e dentro i limiti
Ogni piano ha uno spazio di archiviazione limitato, e le fonti molto grandi rendono più difficile capire da dove arrivi una risposta. Alcune regole di igiene:
- Eliminate le versioni vecchie invece di lasciarle accanto a quelle nuove.
- Dividete i documenti enormi per argomento: un manuale di 80 pagine è più difficile da controllare di cinque schede tematiche.
- Usate le coppie domanda-risposta per le informazioni che devono essere esatte e brevi, come orari, indirizzi e condizioni di reso.
- Evitate i testi di marketing nelle fonti di assistenza: promettono più di quanto l'azienda possa mantenere.
- Controllate i limiti dei connettori. Per le fonti wiki e di documentazione, una sincronizzazione ha un tetto di 1,5 milioni di caratteri e 400 pagine, e un eventuale troncamento viene segnalato.
Un esempio ipotetico mostra l'effetto di una pulizia trimestrale su un negozio online:
Il numero in sé conta poco. Conta che ogni fonte rimasta abbia un responsabile e una data di verifica.
Cambiate in sicurezza: provate, tracciate, tornate indietro
Modificare una fonte può migliorare una risposta e peggiorarne un'altra. Per questo ogni cambiamento significativo segue tre passi.
- Provate prima di pubblicare. Fate le domande che contano (le dieci più frequenti e le due o tre più delicate) in un ambiente di prova, non davanti ai clienti.
- Tracciate chi ha cambiato cosa. Quando una risposta peggiora, sapere chi ha toccato quale fonte e quando dimezza il tempo di diagnosi.
- Abbiate una via di ritorno. Prima di una modifica ampia, assicuratevi di poter ripristinare lo stato precedente.
Come farlo in AI SNS CHAT
Ecco dove si trovano, nella piattaforma, gli strumenti per questa routine.
Fonti di conoscenza. Dalla barra laterale, la sezione Data sources raccoglie File, Frammenti di testo, Sito web, Q&A, Notion, Social, Ticket e Suggerimenti. Le coppie Q&A sono adatte ai dati che devono essere precisi. Nella sezione Channels trovate inoltre i connettori verso strumenti di documentazione come Confluence, GitBook, Zendesk Guide, Google Drive, OneDrive, Dropbox, Box e SharePoint. Per Notion la rilettura avviene su richiesta: dopo aver aggiornato la pagina originale, ricordatevi di rileggerla. Non date per scontato che ogni modifica fatta altrove arrivi da sola all'agente.
Leggere le conversazioni. In Activity → Chat logs trovate le conversazioni di tutti i canali tranne l'email, che ha una propria Inbox. Potete filtrare, segnalare, escalare, risolvere, esportare e consultare le valutazioni con pollice su e giù. Quando correggete la risposta di un operatore trasformandola nella risposta ideale, l'agente ne trae un addestramento. La sezione Analytics mostra Topics, Question history e Sentiment; le analisi avanzate richiedono il piano Pro.
Provare le modifiche. Il Playground permette di fare le domande all'agente prima di esporlo ai clienti, e la versione di confronto A/B consente di mettere a paragone due modelli. Se volete sperimentare su larga scala, Duplicate crea una copia dell'agente con persona, modello e dati di addestramento (senza le conversazioni).
Tracciare e tornare indietro. In Workspace settings → Activity, visibile a titolari e amministratori, il registro registra ogni creazione, modifica, eliminazione o caricamento con nome, email, funzione e orario. Ogni fonte indica inoltre chi l'ha aggiunta e chi l'ha modificata per ultimo. Per il ripristino, ogni agente dispone di punti di ripristino (fino a 40), e il Cestino conserva gli elementi eliminati per 30 giorni. Esistono anche backup notturni scaricabili, di cui vengono conservati gli ultimi 7.
Limiti di spazio. L'archiviazione dipende dal piano: da 30 MB (Free) a 3 GB (Corporate), con pacchetti aggiuntivi acquistabili. I dettagli sono nella pagina prezzi, mentre l'elenco completo delle funzioni è in funzionalità.
Sicurezza dei contenuti. I passaggi della knowledge base mostrati a utenti sconosciuti vengono ripuliti dai dati personali. Le pratiche sono progettate con riferimento a GDPR e APPI; maggiori informazioni sono in sicurezza.
Una checklist di una pagina
Una volta, all'inizio
- Fate l'inventario di tutte le fonti in un foglio di calcolo.
- Eliminate duplicati e documenti scaduti.
- Assegnate un responsabile a ogni argomento.
Ogni settimana (15-30 minuti)
- Leggete le conversazioni con valutazione negativa o passaggio a un operatore.
- Per ognuna individuate la causa e correggete la fonte.
- Riprovate la domanda nel Playground.
Ogni mese
- Ogni responsabile verifica le proprie fonti e aggiorna la data di controllo.
- Rileggete le fonti collegate a strumenti esterni, come Notion.
Ogni trimestre
- Fate una pulizia: unite, dividete, eliminate.
- Controllate lo spazio usato rispetto al limite del piano.
A ogni cambio di listino o politica
- Aggiornate le fonti prima di comunicare il cambiamento ai clienti.
- Provate le domande più delicate.
Conclusione
Una knowledge base aggiornata non richiede un grande progetto, ma una piccola abitudine: un inventario onesto, un responsabile per argomento, un quarto d'ora a settimana sulle conversazioni reali e modifiche fatte con la possibilità di tornare indietro. Cominciate dalla pulizia delle fonti e dalla prima revisione settimanale: sono i due passi che cambiano di più la qualità delle risposte.
Domande frequenti
Con quale frequenza dovremmo rivedere la knowledge base del nostro agente AI?
Una revisione leggera delle conversazioni problematiche ogni settimana, una verifica delle fonti per argomento ogni mese e una pulizia ogni trimestre sono un buon punto di partenza. In più, rivedete subito le fonti ogni volta che cambiano prezzi, orari o condizioni. Se il volume di conversazioni è basso, potete allungare gli intervalli, ma non abbandonate la cadenza.
Qual è il modo più rapido per correggere una risposta sbagliata?
Individuate la conversazione in Activity → Chat logs, capite se la causa è un'informazione assente, superata o contraddittoria e correggete la fonte. Se la risposta sbagliata è stata data a un cliente e un operatore ha ribattuto con quella corretta, potete trasformarla nella risposta ideale per addestrare l'agente. Poi riprovate la stessa domanda nel Playground.
Possiamo vedere chi ha modificato una fonte di conoscenza?
Sì. Ogni fonte mostra chi l'ha aggiunta e chi l'ha modificata per ultimo. Inoltre il registro in Workspace settings → Activity, accessibile a titolari e amministratori, elenca ogni creazione, modifica, eliminazione o caricamento con nome, email, funzione e orario.
Cosa facciamo se un aggiornamento peggiora le risposte?
Ripristinate lo stato precedente: ogni agente ha punti di ripristino (fino a 40) e gli elementi eliminati restano nel Cestino per 30 giorni. Per evitare il problema, provate le modifiche nel Playground o su una copia dell'agente creata con Duplicate, e cambiate poche fonti alla volta.
L'agente recepisce automaticamente le modifiche del nostro strumento di documentazione?
Non conviene darlo per scontato. Per Notion, ad esempio, il contenuto viene riletto su richiesta, quindi dopo ogni aggiornamento importante rileggetelo. I connettori wiki hanno inoltre un limite per sincronizzazione (1,5 milioni di caratteri e 400 pagine), con segnalazione dell'eventuale troncamento. Dopo ogni sincronizzazione, fate una domanda di prova.


