Come preparare PDF e manuali per un assistente AI affidabile: testo leggibile, struttura, test con domande reali e aggiornamenti, con AI SNS CHAT.
Ha caricato il manuale in PDF, l'assistente AI risponde, ma a volte sbaglia, si contraddice o ignora un'informazione che era chiaramente a pagina 12. Non è quasi mai un problema di "intelligenza" dell'AI: dipende da come il documento è stato scritto e preparato. In questa guida trova un metodo in sei passi per trasformare PDF e manuali in risposte affidabili su chat del sito, WhatsApp e Messenger.
Perché i documenti che si leggono bene per un umano mettono in difficoltà l'AI
Un manuale è pensato per essere sfogliato da una persona che conosce il contesto. Ha un indice, richiami del tipo "vedi sezione 4.2", tabelle con celle unite, immagini con didascalie e note a piè di pagina. Un assistente AI, invece, non legge il documento dall'inizio alla fine: cerca i brani più pertinenti alla domanda del cliente e risponde basandosi solo su quelli.
Questo cambia le regole. Un brano che dipende da un'altra pagina ("come descritto sopra") perde senso quando viene estratto da solo. Una tabella appiattita in testo può mescolare colonne e prezzi. Un PDF scansionato come immagine può non contenere affatto testo selezionabile.
Immagini, ad esempio, un'azienda che vende caldaie e carica il proprio catalogo: la domanda "Quanto dura la garanzia sul modello X?" richiede un passaggio che nomini chiaramente il modello e la durata, nello stesso punto. Se il modello è nell'intestazione di pagina e la garanzia in una tabella tre pagine dopo, il recupero fallisce.
Passo 1: decida cosa l'AI deve sapere (e cosa no)
Prima di caricare qualunque file, faccia un inventario. Non tutto ciò che possiede è adatto a un cliente.
Da includere
- Guide d'uso, FAQ, condizioni di spedizione e reso, orari, procedure di assistenza
- Schede prodotto aggiornate e listini che desidera davvero comunicare
- Politiche di garanzia e di pagamento
Da escludere o rivedere
- Documenti interni (margini, trattative, note del personale)
- Versioni superate dello stesso manuale
- Contratti con dati personali di clienti o dipendenti
Il punto sui dati personali merita attenzione, anche nella cornice del GDPR: ciò che entra nella base di conoscenza può essere citato in una risposta a uno sconosciuto. Il principio di minimizzazione vale anche qui: carichi solo ciò che è necessario per rispondere.
Passo 2: verifichi che il testo sia davvero leggibile
Apra il PDF e provi a selezionare una frase con il mouse. Se non ci riesce, il file è un'immagine e l'AI non ha testo da usare. Altri segnali di allarme:
- Testo disposto su due o tre colonne che, copiato, risulta mescolato
- Tabelle con celle unite o intestazioni ripetute su ogni pagina
- Contenuti importanti presenti solo in schemi, screenshot o foto
- Intestazioni e piè di pagina ripetuti che inquinano ogni brano
Copi il testo di una pagina complessa e lo incolli in un editor semplice: ciò che vede è, più o meno, ciò che vede l'AI. Se è illeggibile per lei, lo è anche per l'assistente.
- 01Scelta dei contenuti
- 02Verifica del testo
- 03Riscrittura a blocchi
- 04Test con domande reali
Passo 3: ristrutturi per il recupero delle informazioni
Qui si ottiene il miglioramento maggiore. L'obiettivo è che ogni blocco di testo sia comprensibile da solo.
Un argomento per sezione
Ogni sezione dovrebbe rispondere a una sola domanda: "Come si effettua un reso?", "Quali metodi di pagamento accettate?". Titoli chiari e formulati come le domande dei clienti aiutano molto.
Niente rimandi
Sostituisca "vedi sopra" con l'informazione stessa. Se il termine di reso è di 14 giorni, lo scriva ogni volta che serve.
Nomi completi
Scriva "Caldaia Alfa 24 kW" e non "il modello". Il brano recuperato deve nominare il soggetto di cui parla.
Tabelle in frasi
Una tabella complessa può essere riscritta come elenco: "Spedizione standard: 3-5 giorni lavorativi, gratuita sopra 59 euro." È meno elegante per l'occhio, ma molto più sicuro per l'AI.
Passo 4: faccia dire al contenuto ciò che vuole che dica
I documenti spesso contengono ambiguità che per un collega sono ovvie. Per l'AI no.
- Date e validità: indichi "valido dal 1 marzo 2026", non "da quest'anno".
- Eccezioni: scriva subito accanto alla regola, non in fondo. "Reso entro 14 giorni, esclusi i prodotti personalizzati."
- Cosa non fate: dichiarare esplicitamente ciò che non offrite ("Non effettuiamo installazioni all'estero") evita che l'AI improvvisi.
- Tono e lingua: coerenza di terminologia. Se il documento alterna "ticket", "pratica" e "richiesta", scelga un termine.
Per i casi in cui la risposta non c'è, definisca nelle istruzioni dell'agente cosa fare: ammettere di non saperlo e proporre il passaggio a una persona. Un buon assistente che dice "non ho questa informazione, la metto in contatto con un collega" è più utile di uno che inventa.
Passo 5: provi con domande reali prima dei clienti
Raccolga 20-30 domande vere, prese da email, messaggi WhatsApp e chat del sito degli ultimi mesi. Includa quelle formulate male, con errori di battitura o in modo colloquiale ("ma i resi quanto costano?"). Poi le ponga all'assistente e valuti ogni risposta.
Annoti ogni errore e ne cerchi la causa: contenuto mancante, contenuto ambiguo o contenuto contraddittorio tra due documenti. Correggere la fonte è quasi sempre meglio che aggiungere istruzioni all'assistente.
Passo 6: mantenga i contenuti aggiornati
Una base di conoscenza non è un progetto che si chiude. Prezzi, orari e politiche cambiano, e un'AI sicura di sé con informazioni vecchie fa più danni di una che non risponde.
- Assegni un responsabile per ciascun gruppo di documenti
- Aggiorni la fonte ogni volta che cambia una politica, non "a fine trimestre"
- Rimuova le versioni superate invece di lasciarle accanto alle nuove
- Riesegua periodicamente le domande di prova, soprattutto dopo modifiche importanti
- Rilegga le conversazioni reali: le domande senza risposta indicano cosa manca
Come farlo in AI SNS CHAT
In AI SNS CHAT le fonti si gestiscono dalla voce Data sources nella barra laterale, che comprende File, Text snippets, Website, Q&A, Notion, Social, Tickets e Suggestions.
- Carichi i documenti puliti. In Files aggiunga i PDF già verificati. Per le parti che vuole controllare parola perTesto, usi Text snippets, e per le risposte che non possono sbagliare Q&A. Lo spazio disponibile dipende dal piano: da 30 MB (Free) a 3 GB (Corporate), con pacchetti di storage aggiuntivi.
- Colleghi la documentazione esistente. Se i contenuti vivono già altrove, dalla sezione Channels può usare i connettori per Confluence, GitBook, ReadMe, Guru, Zendesk Guide, Google Drive, OneDrive, Dropbox, Box, SharePoint e Notion. Per i connettori wiki il limite è di 1,5 milioni di caratteri e 400 pagine per sincronizzazione, e se il contenuto viene troncato lo vedrà segnalato.
- Imposti persona e limiti. Nelle impostazioni dell'agente definisca ruolo, tono e comportamento quando manca l'informazione, ad esempio passare la conversazione a un operatore.
- Provi nel Playground. Ponga le sue domande di prova prima di pubblicare. Con il confronto A/B dei modelli può anche vedere come cambiano le risposte.
- Corregga dalle conversazioni reali. In Activity → Chat logs trova le conversazioni su widget, WhatsApp, Messenger e altri canali, con le valutazioni positive e negative. In una chat può prendere in carico la conversazione e modificare una risposta trasformandola nella risposta ideale per addestrare l'agente.
- Tenga traccia dei cambiamenti. Ogni fonte mostra chi l'ha aggiunta e chi l'ha modificata per ultimo, e in Workspace settings → Activity i titolari vedono creazioni, modifiche e caricamenti. Con i punti di ripristino (fino a 40 per agente) può tornare indietro dopo una modifica sbagliata.
Per quanto riguarda i dati, le passaggi della base di conoscenza mostrati a sconosciuti vengono ripuliti dai dati personali, e le pratiche sono progettate con riferimento a GDPR e APPI. I dettagli sono nella pagina sicurezza. Per i piani, consulti i prezzi; l'insieme delle funzioni è in funzionalità.
Domande frequenti
Meglio caricare i PDF o collegare il nostro strumento di documentazione?
Se la documentazione è già mantenuta in uno strumento come Confluence, GitBook o Google Drive, il collegamento evita di avere due copie da allineare. I PDF vanno bene per manuali stabili o documenti che non esistono altrove. In ogni caso, controlli che il contenuto sia leggibile e ben strutturato.
Perché l'AI ignora un'informazione che è chiaramente nel mio PDF?
Le cause più comuni sono un PDF scansionato senza testo selezionabile, tabelle o colonne che si mescolano all'estrazione, oppure un'informazione separata dal nome del prodotto a cui si riferisce. Provi a copiare il testo della pagina e a riscrivere il passaggio in forma autonoma e con titolo chiaro.
Come evito che l'AI indovini quando la risposta non è nei manuali?
Indichi nelle istruzioni dell'agente di ammettere quando non ha l'informazione e di proporre il passaggio a una persona. In AI SNS CHAT può configurare la presa in carico da parte di un operatore, con turni e avvisi su Slack, Teams, WhatsApp o email. Verifichi poi questo comportamento con domande di prova fuori argomento.
Ogni quanto devo aggiornare la base di conoscenza?
Ogni volta che cambia una politica, un prezzo o un orario, senza aspettare una scadenza fissa. In più, una rilettura periodica delle conversazioni reali mostra le domande rimaste senza risposta e i contenuti da correggere.


