Vai al contenuto
AI-SNS.IO — CHAT SUPPORTAI-SNS.IO — CHAT SUPPORT
Base di conoscenza

Scrivere contenuti che l'AI sa ritrovare: guida pratica

Redazione AI SNS CHATPubblicato il 7 min di lettura

Come strutturare la knowledge base perché un agente AI trovi la risposta giusta: titoli, sinonimi, dati espliciti e test con domande reali dei clienti.

Avete caricato il regolamento resi, le condizioni di spedizione e il listino, eppure l'agente risponde in modo vago o sbagliato. Nella maggior parte dei casi il problema non è il modello: è il modo in cui i contenuti sono scritti e organizzati. In questa guida trovate regole concrete per rendere i vostri testi facili da ritrovare, con esempi tratti dalle chat su WhatsApp, Messenger e sito web delle PMI italiane.

Come un agente AI trova davvero i vostri contenuti

Un agente non "legge" la vostra knowledge base come farebbe un nuovo collaboratore, dall'inizio alla fine. Quando arriva una domanda, cerca tra i contenuti i passaggi più vicini a quella domanda e li usa per costruire la risposta. Tutto il resto resta fuori.

Questo ha tre conseguenze pratiche:

  • Il passaggio deve reggersi da solo. Se una frase dice "come indicato sopra" o "vedi tabella precedente", l'agente potrebbe ricevere solo quella frase, senza il contesto.
  • Le parole contano. Se il cliente scrive "posso rimandare indietro la scarpa?" e il vostro testo parla solo di "recesso ai sensi del Codice del Consumo", il collegamento è debole.
  • Le informazioni sparse si perdono. Se il termine di reso è in un paragrafo, le eccezioni in un altro e le spese in un terzo, la risposta rischia di essere incompleta.

Scrivere per il reperimento significa dunque lavorare su blocchi autonomi, titoli chiari e un linguaggio vicino a quello dei clienti. Non serve scrivere in modo "robotico": un testo chiaro per una persona è, quasi sempre, chiaro anche per l'agente.

Un argomento per sezione, con il nome che gli darebbe il cliente

Il difetto più comune è il documento "tuttofare": un PDF di venti pagine intitolato "Condizioni generali" in cui trovano posto resi, garanzia, spedizioni e pagamenti. Meglio dividere in sezioni, ciascuna dedicata a una sola domanda.

Il titolo della sezione dovrebbe somigliare alla domanda che il cliente scrive in chat:

  • Invece di "Art. 7 – Diritto di recesso": "Posso restituire un prodotto e ottenere il rimborso?"
  • Invece di "Modalità di consegna": "Quanto tempo ci vuole perché arrivi il mio ordine?"
  • Invece di "Disposizioni varie": spezzate il contenuto in sezioni che abbiano un titolo proprio.

Se una sezione risponde a due domande diverse, dividetela. Se due sezioni dicono la stessa cosa con parole diverse, unitele e tenete una sola versione: contenuti duplicati e contraddittori sono una delle cause principali di risposte incoerenti.

Prima la risposta, poi le condizioni

Chi scrive in chat vuole sapere subito se la risposta è sì o no. Aprite quindi ogni sezione con la risposta diretta, in una frase, e subito dopo elencate condizioni, eccezioni e passaggi.

Un esempio per un negozio online di abbigliamento:

In questo modo, anche se l'agente recupera solo l'inizio del passaggio, la risposta essenziale è già corretta. Le condizioni arrivano dopo, in ordine di importanza.

Versione difficile da ritrovare
Versione facile da ritrovare
Titolo: "Art. 7 – Recesso"
Titolo: "Posso restituire un prodotto e avere il rimborso?"
Risposta nascosta dopo tre paragrafi di premesse
Prima riga: "Sì, entro 14 giorni dal ricevimento."
"Come sopra indicato, entro i termini di legge"
"Entro 14 giorni dalla data di consegna"
Eccezioni sparse in altre pagine
Eccezioni elencate nella stessa sezione
Stessa politica di reso, scritta in due modiEsempio illustrativo

Usate le parole dei clienti e aggiungete i sinonimi

I clienti non usano il vostro gergo interno. Chi scrive su Messenger non dice "reso merce non conforme": dice "voglio rimandare indietro", "mi è arrivato rotto", "vorrei i soldi indietro". Se nella knowledge base compare solo un termine, le altre formulazioni hanno meno probabilità di agganciarsi.

Come lavorare:

  1. Raccogliete le vere frasi dei clienti dalle conversazioni passate (WhatsApp, chat del sito, e-mail).
  2. Annotate le varianti per lo stesso concetto: "reso", "restituzione", "rimandare indietro", "rimborso", "cambio".
  3. Inserite le varianti in modo naturale nel titolo o nella prima frase, non come un elenco di parole chiave buttato in fondo.

Un esempio: "Reso e rimborso (restituire un articolo, rimandarlo indietro, riavere i soldi): entro 14 giorni dal ricevimento…". Vale lo stesso per sigle e nomi alternativi: se il cliente dice "IVA" e voi scrivete "imposta sul valore aggiunto", scrivete entrambi una volta.

Attenzione ai dati personali: nei testi di esempio e nelle risposte tipo non inserite nomi, indirizzi o numeri di ordine reali di clienti. Il GDPR è una buona cornice per decidere che cosa tenere nella knowledge base: ciò che non serve per rispondere, non va caricato.

Rendete espliciti date, unità, nomi e limiti

Un agente non può indovinare ciò che voi date per scontato. Frasi come "a breve", "in tempi ragionevoli", "il costo standard" o "sopra una certa soglia" producono risposte altrettanto vaghe.

Sostituite l'implicito con l'esplicito:

  • Tempi: non "consegna rapida", ma "consegna in 2–4 giorni lavorativi, esclusi sabato e festivi".
  • Unità e valute: "spedizione gratuita sopra 59 euro IVA inclusa", non "sopra 59".
  • Date: scrivete l'anno, e indicate quando il contenuto è stato aggiornato. "Dal 1° gennaio 2027" è meglio di "dal prossimo anno".
  • Nomi: il nome esatto del prodotto, del piano o del servizio, così come compare sul sito.
  • Limiti ed esclusioni: "Non spediamo in Sardegna con il corriere standard" è meglio di "con alcune eccezioni".

Se una cosa non è prevista, scrivetelo. Una riga come "Non effettuiamo ritiri a domicilio" evita che l'agente risponda con una supposizione.

Formattate per la lettura veloce: blocchi brevi, tabelle, elenchi

Paragrafi lunghi e fitti sono difficili da leggere per le persone e da isolare per il sistema di ricerca. Preferite:

  • Blocchi brevi, di poche frasi ciascuno.
  • Elenchi puntati per condizioni e requisiti.
  • Elenchi numerati per procedure (per esempio: "Come richiedere un reso" in quattro passaggi).
  • Tabelle per confronti, come tariffe di spedizione per fascia di peso, con intestazioni chiare.
Peso del paccoTempi di consegnaCosto (IVA inclusa)
Fino a 2 kg2–3 giorni lavorativi4,90 euro
Da 2 a 10 kg3–4 giorni lavorativi7,90 euro
Oltre 10 kg4–6 giorni lavorativisu preventivo

I valori sono puramente illustrativi. L'importante è che ogni riga abbia senso anche letta da sola, senza il resto della pagina.

Provate con domande vere e correggete ciò che non funziona

Nessuna knowledge base è giusta al primo tentativo. Il metodo più affidabile è un ciclo semplice e ripetuto nel tempo.

  1. 01Raccogliere domande reali
  2. 02Provarle con l'agente
  3. 03Riscrivere la sezione che fallisce
  4. 04Ripetere la prova
Ciclo di revisione dei contenutiEsempio illustrativo

In pratica:

  1. Raccogliete 20–30 domande reali dalle chat passate, comprese quelle scritte male, con errori o in forma abbreviata.
  2. Provatele una per una e annotate quali ricevono una risposta giusta, incompleta o sbagliata.
  3. Individuate la causa. Il contenuto manca? È nascosto in una sezione troppo lunga? Usa un termine che il cliente non usa? Contraddice un altro testo?
  4. Correggete e riprovate con la stessa domanda, e anche con una variante.
  5. Rifate il controllo periodicamente, soprattutto dopo cambi di prezzi, orari o politiche.

Conservate l'elenco delle domande di prova: diventa il vostro test di regressione ogni volta che modificate i contenuti.

Come farlo in AI SNS CHAT

In AI SNS CHAT i contenuti arrivano all'agente dal menu Data sources, che comprende File, Text snippets, Website, Q&A, Notion, Social, Tickets e Suggestions. Per applicare le regole di questa guida:

  • Q&A e Text snippets sono adatti a blocchi brevi, con un solo argomento e un titolo scritto come la domanda del cliente. Sono il punto di partenza ideale per resi, orari, tempi di consegna e simili.
  • Files e Website servono per materiale già esistente, ma se un PDF è lungo e confuso conviene prima riordinarlo.
  • Connettori sotto Channels, tra cui Confluence, GitBook, Zendesk Guide, Google Drive, OneDrive, Dropbox, Box e SharePoint, permettono di collegare documentazione già presente. Per i connettori wiki esiste un limite per sincronizzazione di 1,5 milioni di caratteri e 400 pagine, e l'eventuale troncamento viene segnalato: se il vostro spazio è molto grande, selezionate le sezioni che contano davvero.
  • Playground è il luogo dove fare il ciclo di prova: ponete le domande reali e verificate le risposte prima di pubblicare. Il confronto A/B tra modelli aiuta a capire se il problema è nel contenuto o nel modello.
  • Chat logs (sezione Activity) mostrano le conversazioni reali sugli altri canali, con valutazioni positive e negative: sono la miniera delle domande da testare. Nelle conversazioni potete anche modificare una risposta trasformandola nella risposta ideale per addestrare l'agente.
  • Analytics (Chats, Topics, Question history, Sentiment) aiutano a vedere quali argomenti ricorrono; le analisi avanzate richiedono il piano Pro.
  • Activity log nelle impostazioni del workspace, riservato a proprietari e amministratori, registra chi ha creato, modificato o caricato un contenuto. Ogni fonte mostra anche chi l'ha aggiunta e chi l'ha modificata per ultimo, utile per mantenere ordine quando più persone lavorano alla knowledge base.

I limiti di archiviazione dipendono dal piano; trovate il confronto aggiornato in /pricing e il dettaglio delle funzionalità in /features. Sul trattamento dei dati, le pratiche sono progettate con riferimento a GDPR e APPI: maggiori informazioni in /security.

Conclusione

Scrivere per il reperimento non richiede un linguaggio speciale, ma disciplina: un argomento per sezione, titoli che somigliano alle domande reali, la risposta in apertura, le parole dei clienti, dati precisi e formati leggibili. Poi viene la parte che fa la differenza nel tempo: provare, correggere e riprovare con domande vere. Partite da cinque argomenti che generano più messaggi, riscriveteli con questo metodo e misurate la differenza nelle conversazioni successive.

Domande frequenti

Quanto deve essere lunga ogni sezione della knowledge base?

Abbastanza da rispondere a una sola domanda per intero, quindi in genere un breve paragrafo più eventuali elenchi o una piccola tabella. Se una sezione tocca più argomenti, dividetela; se è fatta di una sola frase priva di condizioni, valutate di accorparla con una sezione affine.

Devo scrivere lo stesso contenuto in più lingue?

Dipende dalle lingue dei vostri clienti. Se ricevete richieste in più lingue, è prudente avere i contenuti essenziali anche in quelle, scritti da una persona che le conosca e non tradotti parola per parola. In ogni caso verificate con domande di prova nelle diverse lingue che le risposte siano corrette.

E se l'agente sbaglia ancora dopo che ho riscritto il contenuto?

Controllate prima che non esistano versioni contraddittorie dello stesso argomento in altre fonti. Poi provate la domanda nel Playground con formulazioni diverse, aggiungete i termini usati dal cliente e rendete più espliciti numeri e limiti. Se serve, correggete la risposta direttamente dalla conversazione, trasformandola nella risposta ideale.

L'agente può rispondere dal web se la mia knowledge base non ha la risposta?

Non in modo generale. La ricerca sul web come ripiego è prevista solo sul canale LINE WORKS, dove cita la pagina usata. Per gli altri agenti esiste l'azione Tavily, che aggiunge la ricerca web in tempo reale. In tutti gli altri casi, la strada più sicura è completare la knowledge base.

#knowledge base#agente AI#scrittura#assistenza clienti#WhatsApp

Mettilo in pratica con AI SNS CHAT

Crea un agente IA addestrato sui tuoi contenuti e collegalo al sito, a WhatsApp, Messenger e altro. Gratis per iniziare, senza carta di credito.