Un agente di supporto IA basato su RAG (retrieval-augmented generation) non inventa le risposte: trova il passaggio più pertinente della tua documentazione e risponde a partire da quello. Il che significa che il limite massimo di qualità del tuo supporto IA è esattamente la qualità della tua documentazione.
La buona notizia: la documentazione che funziona bene per il recupero da parte dell'IA è la stessa che funziona bene per le persone impazienti. Ecco cosa fa davvero la differenza.
1. Scrivi titoli a forma di risposta
Il recupero lavora sul significato, ma parte dalla struttura. Una sezione intitolata «Fatturazione» non corrisponde a nulla di specifico. Una sezione intitolata «Come disdico il mio abbonamento?» corrisponde alle parole esatte che un utente frustrato digita a mezzanotte.
Rivedi i tuoi titoli: se non riesci a immaginare un utente che lo digita come domanda, riscrivilo come domanda.
2. Un argomento per sezione
I documenti vengono suddivisi in frammenti prima dell'indicizzazione. Una sezione che tratta tutto d'un fiato rimborsi, cambi di piano e fatture diventa un frammento confuso che corrisponde a metà a tutto e non risponde del tutto a niente.
Mantieni le sezioni brevi e con un solo scopo. Se un paragrafo inizia con «Inoltre,», probabilmente vuole essere una sezione a sé.
3. Usa le parole dei tuoi utenti
Tu dici «workspace», i tuoi utenti dicono «account». Tu dici «credenziali di autenticazione», loro dicono «password». La ricerca semantica colma parte di questa distanza, ma ogni passaggio di traduzione costa in precisione.
Prendi il vocabolario direttamente dalle vere email di supporto: sono un corpus gratuito di come i tuoi utenti formulano davvero le cose.
4. Indica limiti e prezzi come fatti, in un unico posto
Le domande più pericolose per un agente IA sono quelle sui numeri: prezzi, quote, scadenze. Se i tuoi prezzi compaiono in quattro posti con tre valori diversi, prima o poi l'IA citerà quello obsoleto.
Tieni una sola sezione di riferimento per prezzi e limiti e aggiornala appena qualcosa cambia. Ovunque altrove, inserisci un link invece di ripeterla.
5. Non nascondere le risposte negli screenshot
Il testo dentro le immagini è invisibile al recupero. Uno screenshot della pagina delle impostazioni con una freccia sul pulsante di esportazione non risponde a nulla; la frase «Vai su Impostazioni → Dati → Esporta per scaricare i tuoi dati in CSV» risponde per sempre.
Gli screenshot vanno benissimo come illustrazione. Assicurati solo che le parole esistano anche come parole.
6. Lascia che le lacune ti dicano cosa scrivere dopo
Non riuscirai mai a prevedere tutte le domande in anticipo, e non devi farlo. Il report sulle lacune di conoscenza di Resply elenca le domande a cui l'IA non ha saputo rispondere con sicurezza, ordinate per frequenza.
Così la documentazione smette di essere un gioco di indovinelli e diventa un ciclo di feedback: controlla le lacune ogni settimana, scrivi una volta la risposta mancante e guarda quella domanda sparire dalla tua casella. Venti minuti a settimana bastano per far salire costantemente il tasso di risoluzione dell'IA.
Niente di tutto questo richiede un technical writer. Sezioni brevi, domande reali come titoli, il vocabolario dei tuoi utenti e uno sguardo settimanale alle lacune: questo è tutto il metodo.