Conversation AI knowledge base: perché il bot ignora la fonte appena aggiunta
Il bot Conversation AI di GoHighLevel non risponde a memoria: ogni risposta parte da una ricerca nella knowledge base collegata. Se la fonte appena aggiunta viene ignorata, il problema è quasi sempre uno di tre: l’elaborazione non è finita, la knowledge base sbagliata è collegata al bot, oppure esistono versioni duplicate o contrastanti della stessa informazione.
Questo articolo copre come GoHighLevel gestisce le fonti, quale tipo di fonte usare per quale dato, i tre controlli da fare in ordine quando il bot risponde sbagliato o non trova l’informazione, e come usare gli strumenti di debug nativi — Retrieval Tester, Test your Bot e Response Info — per capire dove si rompe la catena. Vale sia per chi trova la scheda Bot Training dentro il bot, sia per chi lavora con la struttura AI Agents › Knowledge Base: l’interfaccia varia in base all’account, il funzionamento è lo stesso.
Come funziona la conversation AI knowledge base in GoHighLevel
Quando un utente manda un messaggio, il bot non attinge a un testo che ha «memorizzato»: interroga la knowledge base collegata, recupera i passaggi più pertinenti e costruisce la risposta su quelli. Se la knowledge base è vuota, collegata male o contiene informazioni in conflitto, il bot non ha materiale corretto da usare.
Il percorso per arrivarci dipende dall’account. In alcuni la scheda si chiama Bot Training e la trovi dentro il bot stesso. In altri devi andare su AI Agents › Knowledge Base, creare la base, e poi collegarla al bot dalla configurazione. Se non trovi una delle due, cerca l’altra: sono la stessa cosa con nomi diversi.
Le sei fonti disponibili e quando usarle
GoHighLevel permette di mischiare fonti diverse nella stessa knowledge base. Ogni fonte ha un caso d’uso preciso.
- Web Crawler — per pagine web già curate: sito aziendale, pagine servizi, pagine prodotto. Si inserisce l’URL con
https://, si sceglie tra Exact URL, All URLs with this Path o All URLs in this Domain, si clicca Get Data e si selezionano solo le pagine utili. - FAQ — per domande e risposte definite. La domanda va scritta come la direbbe un cliente, non come la scriverebbe il manuale interno. La risposta deve essere breve e completa.
- Rich Text — per policy, istruzioni operative, testi che non stanno bene in un formato domanda-risposta.
- File Upload — per documenti approvati in PDF o altri formati supportati.
- Tables — per listini prezzi, inventari, elenchi strutturati.
- Google Drive — per Google Doc pubblici via Web Crawler. Il documento deve avere condivisione impostata su Anyone with the link e va inserito come Exact URL.
- Web Search — per lasciare che il bot cerchi su web in tempo reale. Da usare con criterio: se la risposta sta già nella knowledge base, Web Search non serve e introduce variabilità.
Perché non conviene dare in pasto tutto il sito
Addestrare ogni pagina del sito è una delle trappole più comuni. Pagine obsolete, pagine di navigazione, disclaimer legali, pagine di ringraziamento dopo un form: nessuna di queste aggiunge informazioni utili al bot. Aggiungono rumore. Il bot recupera i passaggi più pertinenti alla domanda, ma se la knowledge base è piena di testo irrilevante, aumenta la probabilità che vengano recuperati passaggi sbagliati. Seleziona solo le pagine che contengono informazioni che un cliente potrebbe chiedere.
I tre controlli quando il bot ignora la knowledge base
Se aggiungi una fonte e il bot continua a rispondere come prima — o risponde sbagliato — fai questi tre controlli nell’ordine. Saltarne uno porta a diagnostiche sbagliate.
1. La fonte ha finito l’elaborazione?
Dopo aver aggiunto una fonte, GoHighLevel la elabora in background. Finché lo stato non è Trained (o equivalente secondo la versione dell’interfaccia), la fonte non è disponibile per il bot. Controlla la colonna di stato nella lista degli Uploaded Links. Se lo stato è ancora in elaborazione, aspetta. Se è fallito, rimuovi la fonte e riaggiungi: spesso basta.
2. La knowledge base giusta è collegata al bot?
Un bot usa una sola knowledge base alla volta. Se hai più knowledge base nell’account — situazione comune quando si gestiscono più clienti o più bot — è facile che il bot sia collegato a quella sbagliata. Vai nella configurazione del bot e verifica quale knowledge base è selezionata. Non dare per scontato che sia quella che pensi.
3. Ci sono fonti duplicate o in conflitto?
Hai aggiornato i prezzi sul sito ma la vecchia pagina prezzi è ancora nella knowledge base come fonte separata. Il bot recupera entrambe le versioni e risponde con la più vecchia, o con una sintesi incoerente. Rimuovi la fonte superata, aggiorna quella corrente e ritesta. Due versioni della stessa informazione nella stessa knowledge base è il modo più sicuro per avere risposte sbagliate in modo sistematico.
La regola
Un conflitto tra fonti produce errori silenziosi
Il bot non restituisce un errore quando trova due versioni della stessa informazione. Sceglie, o sintetizza. Il risultato è una risposta sbagliata che sembra corretta.
- Stato elaborazione — controlla che sia Trained prima di testare
- Collegamento — un bot usa una sola knowledge base, verifica quale è selezionata
- Duplicati — rimuovi la versione superata, non tenerle entrambe
Gli strumenti di debug: Retrieval Tester, Test your Bot e Response Info
GoHighLevel mette a disposizione tre strumenti per capire cosa sta succedendo. Usarli nell’ordine sbagliato porta a conclusioni false.
Knowledge Base Retrieval Tester
Il Retrieval Tester risponde a una domanda sola: la knowledge base contiene l’informazione e riesce a recuperarla? Inserisci una domanda realistica — scritta come la scriverebbe un cliente, non come la hai scritta nella fonte — e guarda quali passaggi vengono recuperati e da quale fonte provengono. Se il passaggio giusto non appare qui, il problema è nella knowledge base: fonte mancante, elaborazione non finita, o testo strutturato male. Se il passaggio appare, il problema è altrove.
Test your Bot
Il Test your Bot simula il comportamento completo: istruzioni del bot, obiettivi, azioni, tono. Usalo dopo il Retrieval Tester, non al posto suo. Se il Retrieval Tester trova l’informazione ma il bot la ignora o la trasforma in modo strano, il problema è nel prompt o nelle istruzioni del bot, non nella knowledge base. Testa con domande comuni, con parafrasi delle stesse domande, con almeno una domanda fuori argomento per verificare che il bot non alluci.
Response Info nelle conversazioni reali
Dopo che il bot è in produzione, ogni messaggio generato dall’AI ha un’icona Response Info accanto. Cliccandola vedi quali fonti della knowledge base hanno contribuito a quella risposta. È lo strumento più utile per diagnosticare problemi su conversazioni reali: se il bot ha risposto sbagliato a un cliente, Response Info ti dice da dove ha preso l’informazione.
Tenere la knowledge base aggiornata nel tempo
Una knowledge base non è una configurazione che si fa una volta. Prezzi, servizi, policy cambiano. Se la knowledge base non viene aggiornata, il bot risponde con informazioni vecchie — e lo fa con la stessa sicurezza con cui rispondeva quando erano corrette. Il silenzio del sistema non è salute: è il sintomo che nessuno sta controllando.
Per le URL web esiste Auto Refresh: si imposta un ricontrollo automatico giornaliero, settimanale o mensile. Attivalo sulle pagine che cambiano con una certa frequenza — pagina prezzi, pagina servizi — e lascia le pagine statiche senza refresh automatico per non sprecare elaborazioni inutili.
Per i file Google Drive la sincronizzazione va fatta manualmente: quando aggiorni il documento, devi rielaborare la fonte nella knowledge base. Per i file caricati direttamente, sostituisci il documento e ricontrolla lo stato di elaborazione prima di dichiarare l’aggiornamento fatto.
Una tecnica che funziona bene è usare la sezione Knowledge Gaps — disponibile per l’agente voce, ma il principio si applica a qualsiasi bot — per identificare le domande a cui il bot non ha saputo rispondere. Quelle domande dicono esattamente quale informazione manca nella knowledge base. Aggiungila con la fonte giusta: FAQ per domande dirette, Rich Text per politiche, Tables per dati strutturati.
| Tipo di fonte | Caso d’uso principale | Aggiornamento | Rischio principale |
|---|---|---|---|
| Web Crawler | Pagine sito curate | Auto Refresh disponibile | Pagine obsolete incluse |
| FAQ | Domande e risposte definite | Manuale | Domande scritte in gergo interno |
| Rich Text | Policy e istruzioni | Manuale | Versioni duplicate |
| File Upload | Documenti approvati | Sostituzione manuale | File vecchio non rimosso |
| Tables | Listini, inventari | Manuale | Dati non aggiornati |
| Google Drive | Doc condivisi | Risincronizzazione manuale | Permessi revocati |
Make e agenti AI
Make è il layer che dà le braccia all’agente
Un agente AI decide, Make esegue: aggiorna una riga, manda una notifica, scrive su un CRM. Il piano gratuito parte da 1.000 operazioni al mese.
- Primo giorno — crea uno scenario che parte da un webhook e scrive su un foglio Google: impari la struttura base in un’ora
- Seconda fase — collega l’uscita di un bot GoHighLevel a uno scenario Make: da qui in poi il bot non solo risponde, ma muove dati
- Terza fase — aggiungi un filtro che intercetta le risposte fuori schema e le manda in una coda di revisione prima che arrivino al cliente
Apri il piano gratuito di Make →
Link di affiliazione: se ti iscrivi da qui io prendo una commissione, tu paghi uguale. Lo linko perché ci lavoro dentro ogni giorno.
Configurazione e ghl bot training: errori di setup che nessuno documenta
La documentazione ufficiale di GoHighLevel copre i passaggi corretti. Quello che non copre sono gli errori di setup che si fanno nella pratica.
Il primo è aggiungere la knowledge base dopo aver configurato il bot e dimenticarsi di collegare le due cose. Il bot esiste, la knowledge base esiste, non parlano tra loro. Controlla sempre la sezione di collegamento nella configurazione del bot.
Il secondo è usare il Web Crawler su un sito con redirect complessi o protezioni anti-bot. L’elaborazione appare come riuscita ma il contenuto recuperato è minimo o sbagliato. Controlla cosa ha effettivamente recuperato prima di dichiarare la fonte pronta.
Il terzo riguarda la struttura delle FAQ. Se scrivi la domanda come la scriverebbe il manuale interno («Qual è la politica di rimborso secondo i termini di servizio?») invece di come la scriverebbe un cliente («Posso avere i soldi indietro?»), il Retrieval Tester la troverà difficilmente su domande reali. Il matching non è esatto: è semantico, ma la distanza tra il linguaggio formale e quello del cliente può essere abbastanza grande da far fallire il recupero.
Se stai costruendo il bot da zero e vuoi capire le parti che servono prima ancora di toccare la knowledge base, l’articolo su come creare agenti AI e in che ordine montare le quattro parti spiega la sequenza logica. Per il setup completo del bot invece, la guida passo passo alla configurazione di Conversation AI su GoHighLevel copre l’intera procedura dall’inizio. E se il bot si blocca del tutto invece di rispondere sbagliato, il pezzo su cosa fare quando la Conversation AI smette di rispondere copre quel caso separato.
La knowledge base è solo una delle variabili. Un bot mal configurato risponde sbagliato anche con una knowledge base perfetta. Un bot ben configurato con una knowledge base piena di duplicati risponde sbagliato in modo sistematico e difficile da diagnosticare. Le due cose vanno verificate insieme, con strumenti separati — Retrieval Tester per la knowledge base, Test your Bot per il comportamento — e in quest’ordine.
La documentazione ufficiale di GoHighLevel sulla formazione del bot è disponibile su help.gohighlevel.com ed è il riferimento più aggiornato su nomi di menu e funzioni che cambiano con ogni release.
Domande frequenti
Una knowledge base può mischiare fonti diverse?
Sì. Puoi avere nella stessa knowledge base pagine web recuperate con il Web Crawler, domande FAQ scritte a mano e un file caricato. L’importante è che le informazioni non si contraddicano tra loro: due fonti che dicono cose diverse sullo stesso argomento producono risposte incoerenti.
Quanto tempo ci vuole perché una fonte appena aggiunta sia disponibile?
Dipende dalla dimensione della fonte. Una singola pagina web o una FAQ si elabora in pochi minuti. Un sito con molte pagine o un documento lungo può richiedere più tempo. Controlla lo stato nella lista delle fonti: finché non è Trained, il bot non la usa.
Il Retrieval Tester trova l’informazione ma il bot non la usa: cosa significa?
Significa che il problema non è nella knowledge base ma nel prompt o nelle istruzioni del bot. Il Retrieval Tester verifica solo il recupero dell’informazione. Il comportamento del bot — come usa quell’informazione, con quale tono, in quale contesto — dipende dalla configurazione del bot stesso.
Con quale frequenza aggiornare la knowledge base?
Ogni volta che cambiano prezzi, servizi o policy. Per le pagine web che cambiano spesso, usa Auto Refresh. Per il resto, aggiorna manualmente a ogni modifica rilevante. Non esiste una cadenza fissa: esiste il momento in cui un’informazione nella knowledge base non corrisponde più alla realtà.
Trasparenza: in questo articolo c’è un link di affiliazione. Se ti iscrivi da lì io ricevo una commissione, per te non cambia niente. Linko solo strumenti che uso in produzione.
