Gestire le fonti: anteprima, modifica e addestramento
Gestisci la conoscenza di un agente intoCHAT: stato, anteprima, modifica, riaddestramento, eliminazione, priorità, utilizzo, informazioni contraddittorie, gruppi per sito e cartella, export ZIP e auto-resync.
Tutto ciò che il tuo agente sa è elencato nella scheda Knowledge (conoscenza), sotto Knowledge sources: una riga per ogni pagina, file, testo, coppia di Q&A, pagina Notion, file di Google Drive o articolo Intercom. Fanno eccezione i ticket helpdesk importati: compaiono come una sola riga con un conteggio nel riquadro Helpdesk tickets sotto l'elenco (vedi Ticket helpdesk e Intercom). Questa pagina spiega cosa puoi fare con ogni fonte e quando le modifiche hanno effetto.
Stato dell'addestramento
Ogni fonte mostra uno stato:
| Stato | Significato |
|---|---|
| Pending | Salvata, ma non ancora addestrata. L'agente non la usa. |
| Training | In corso di suddivisione e indicizzazione. |
| Trained | Usata per le risposte. |
| Failed | Non è stato possibile addestrarla. Passa con il mouse sul badge per vedere il motivo. |
La barra in alto nella scheda riassume la situazione, per esempio "3 sources waiting to be trained", e mostra quanti caratteri del tuo piano usa l'agente. Clicca su Train agent per addestrare tutto ciò che è in attesa, oppure su Retry failed quando restano solo fonti non riuscite.
L'addestramento avviene sui server di intoCHAT. Dopo aver cliccato su Train agent puoi cambiare scheda o chiudere la pagina, e l'addestramento continua. Quando torni, la scheda Knowledge ne mostra l'avanzamento. Se un addestramento si interrompe, riprende quando apri la scheda Knowledge, e un controllo giornaliero riavvia anch'esso gli addestramenti interrotti. Le fonti completate restano addestrate. Se l'addestramento si ferma dopo errori ripetuti, clicca di nuovo su Train agent.
Solo l'aggiunta di conoscenza richiede la pagina aperta: aspetta che i nuovi file e le nuove pagine risultino aggiunti prima di uscire.
Trovare le fonti
Usa Search sources… per cercare per nome, indirizzo o altre formulazioni di una coppia di Q&A, il menu dei tipi (All types, Website, Files, Text, Q&A, e Notion, Google Drive o Intercom quando hai fonti di questo tipo) e i pulsanti di stato come Pending (3) o Failed (1).
Raggruppare le fonti per sito e cartella
Nel menu Arrange sources, accanto al menu dei tipi, scegli Group by site and folder (raggruppa per sito e cartella). Con List torni all'elenco.
- Le pagine web sono raggruppate per sito, poi per cartella di primo livello del sito, come
/blogo/docs. Le pagine al primo livello del sito stanno sotto/. Un sito con una sola cartella mostra le sue pagine direttamente sotto il sito. - Tutte le altre fonti sono raggruppate per tipo: Files, Text, Q&A, Notion, Google Drive e articoli Intercom.
- Ogni intestazione mostra quante fonti contiene il gruppo e i loro caratteri, per esempio "24 sources · 81.2K chars". Clicca sulla freccia per comprimerla o espanderla.
- La ricerca, i filtri e Least used valgono anche all'interno di ogni gruppo.
Ogni intestazione di gruppo ha questi comandi:
- Casella di spunta: seleziona tutte le fonti del gruppo. Mostra uno stato parzialmente selezionato quando solo alcune sono selezionate. Poi usa Export, Re-index o Delete per la selezione.
- Nuvola (aggiorna dal sito): solo per i gruppi di sito e di cartella. Dopo la conferma con Refresh pages, ogni pagina del gruppo viene riletta e quelle con il testo cambiato vengono riaddestrate. Consuma una scansione del tuo piano, e una scansione legge fino a 600 pagine. Un gruppo più grande non si può aggiornare in una volta: aggiorna le sue cartelle una alla volta. Una pagina letta nell'ultima ora può provenire da una copia in cache. L'aggiornamento si ferma al limite di scansioni o di caratteri, e un messaggio riassume quante pagine sono cambiate, sono rimaste uguali o non si sono potute leggere.
- Cestino: elimina tutte le fonti del gruppo dopo la conferma con Delete … sources. L'operazione non si può annullare.
Quanto viene usata una fonte
Ogni riga mostra quante risposte dell'agente hanno usato la fonte negli ultimi 30 giorni:
- "Used in 12 replies (30 days)": tante risposte avevano almeno un estratto di questa fonte tra la conoscenza data all'agente.
- "Not used in 30 days": nessuna risposta in quel periodo aveva un estratto di questa fonte.
Le coppie di Q&A vengono contate come qualsiasi altra fonte. Contano anche le chat salvate del Playground; le chat temporanee non vengono salvate e quindi non contano. I numeri partono da quando intoCHAT ha iniziato a registrare quale conoscenza usa ogni risposta. Finché l'agente non ha risposte di questo tipo, l'elenco mostra invece "How often each source is used appears here as new replies are recorded."
Quando ci sono numeri, un menu di ordinamento accanto a quello dei tipi offre Default order e Least used. Least used mostra prima le fonti non usate, poi quelle usate nel minor numero di risposte, poi quelle usate meno di recente.
"Usata" significa che il testo della fonte è stato dato all'agente per quella risposta, non che la risposta lo abbia citato. Una fonte mai usata forse tratta argomenti che i visitatori non chiedono, oppure è difficile da trovare per la ricerca. Guardane l'anteprima prima di eliminarla, nel caso contenga informazioni che ti servono ancora. Per vedere a quali domande la tua conoscenza non risponde ancora, usa Questions to improve; vedi Testo e Q&A.
Informazioni contraddittorie
Con Pro ed Enterprise, il riquadro Conflicts nella scheda Knowledge elenca le informazioni su cui due delle tue fonti non concordano, come un vecchio prezzo in una pagina e uno nuovo in una coppia di Q&A. Open source A o Open source B apre la fonte in questo elenco: testi e coppie di Q&A per la modifica, le altre fonti nella loro anteprima. Una volta addestrata la fonte corretta, il risultato si risolve da solo. Vedi Conflitti.
Cosa puoi fare con una fonte
Ogni riga ha queste icone:
- Stella (Mark as priority): la fonte viene prima delle altre conoscenze pertinenti e prevale quando le fonti si contraddicono. Vale dalla risposta successiva, senza addestramento. Le coppie di Q&A non hanno la stella perché vengono già prima. Le fonti contrassegnate mostrano Priority.
- Occhio (Preview the text): mostra esattamente il testo che l'agente impara dalla fonte, Formatted (formattato) o come Plain text (testo semplice). Puoi cercarci dentro, copiarlo con Copy o scaricarlo con Download come file Markdown (
.md). Per una pagina web, Open page apre l'originale. - Matita (Edit): solo per testi e coppie di Q&A. Modifica titolo, contenuto, domanda, altre formulazioni o risposta e clicca su Save. La fonte torna su Pending; addestra per applicare la modifica. Una domanda che un'altra coppia ha già viene rifiutata.
- Nuvola (Refresh from website, aggiorna dal sito): solo per le pagine web. Rilegge la pagina e, se il testo è cambiato, lo salva e la riaddestra subito. Consuma una scansione del sito, come l'aggiunta di una pagina.
- Frecce (Re-index saved text, reindicizza il testo salvato): addestra di nuovo la fonte dal testo che intoCHAT ha già, senza scaricare nulla.
- Cestino (Delete this source): elimina la fonte e i suoi passaggi.
Le pagine Notion e i file di Google Drive non hanno l'icona a matita né quella a nuvola. Per aggiornarne uno, importalo di nuovo o lascia che lo controlli l'Auto-resync; vedi Notion e Google Drive, dove Sync now controlla tutti insieme i file Drive di un agente.
Spunta più righe per esportarle con Export, reindicizzarle con Re-index o eliminarle con Delete tutte insieme. Per aggiungere, aggiornare o scaricare molte coppie di Q&A in una volta, usa l'importazione e l'esportazione in Q&A; vedi Testo e Q&A. Delete all, in alto, elimina tutte le fonti dopo la conferma con Delete everything. L'operazione non si può annullare.
Quando hanno effetto le modifiche
| Modifica | Effetto |
|---|---|
| Aggiungere o togliere la priorità | dalla risposta successiva |
| Eliminare una fonte | subito |
| Modificare un testo o una coppia di Q&A | dopo l'addestramento; fino ad allora l'agente usa la versione precedente |
| Aggiornare dal sito una pagina web cambiata | al termine del riaddestramento automatico |
| L'Auto-resync trova una pagina cambiata | al termine del riaddestramento automatico |
| Caricare una nuova versione di un file | dopo l'addestramento; fino ad allora l'agente usa la versione precedente |
| Aggiungere una fonte | dopo l'addestramento |
Eliminare fonti libera anche caratteri per quelle nuove.
Aggiornare pagine web e file
Re-index saved text non scarica nulla di nuovo, e pagine web e file non si modificano direttamente. Le pagine web, le pagine Notion e i file di Google Drive può controllarli per te l'Auto-resync, secondo un calendario, e i ticket helpdesk e gli articoli Intercom la loro impostazione Sync automatically (vedi Ticket helpdesk e Intercom). Altrimenti, quando cambiano prezzi o condizioni, aggiorni tu le fonti:
- Una pagina web è cambiata: clicca su Refresh from website nella sua fonte. Una pagina letta nell'ultima ora può provenire da una copia in cache. Per aggiornare molte pagine insieme, usa l'icona a nuvola di un gruppo in Group by site and folder, oppure aggiungi di nuovo le pagine dopo Find pages e addestra. Vedi Scansione del sito.
- Una pagina Notion è cambiata: importala di nuovo. Vedi Notion.
- Un file di Google Drive è cambiato: clicca su Sync now nell'opzione Drive, oppure scegli di nuovo il file. Vedi Google Drive.
- Un file è cambiato: carica la nuova versione con lo stesso nome di file, poi addestra. Sostituisce il testo precedente; un file identico viene saltato. Vedi File.
- Un testo o una coppia di Q&A è cambiato: modificalo con l'icona a matita e addestra.
Auto-resync
Il riquadro Auto-resync nella scheda Knowledge rilegge le tue pagine web, le pagine Notion e i file di Google Drive secondo un calendario e riaddestra solo le pagine il cui testo è cambiato. Di base è disattivato.
- Attiva Check pages automatically (controlla le pagine automaticamente).
- In How often (ogni quanto) scegli Daily (ogni giorno) o Weekly (ogni settimana). Ogni modifica viene salvata subito.
Cosa fa un giro:
- Rilegge le fonti di tipo sito web, Notion e Google Drive. File caricati, testi e coppie di Q&A non vengono mai toccati.
- Un file di Google Drive viene riletto solo se è stato modificato in Drive dopo l'ultimo controllo. Un file eliminato, spostato nel cestino o che intoCHAT non ha più il permesso di aprire mostra il motivo, e il suo testo salvato resta.
- Confronta ogni pagina con il testo salvato. Il testo che si ripete su tutto il sito, come menu e piè di pagina, viene ignorato nel confronto, quindi non conta come modifica.
- Salva il nuovo testo delle pagine cambiate e le riaddestra da solo. Le pagine invariate vengono solo segnate come controllate.
- Non elimina mai una fonte. Se una pagina non si può leggere, per esempio perché è stata tolta dal sito, il testo salvato resta e la fonte mostra il motivo.
- Se il nuovo testo di una pagina facesse superare all'agente il limite di caratteri, la pagina mantiene il testo salvato e mostra "The new text would go over your plan's character limit, so the saved text was kept."
- Le pagine controllate meno di recente vengono prima. Una pagina web letta nell'ultima ora può provenire da una copia in cache.
- Le pagine web vengono lette con le impostazioni di scansione dell'agente: il suo paese di scansione e, in modalità lenta, 5 pagine alla volta, 2 contemporaneamente, con una pausa tra una richiesta e l'altra. In modalità lenta un giro può leggere meno di 30 pagine nel tempo a disposizione; le altre vengono controllate al giro successivo.
Scansioni del sito
- Ogni giro che legge pagine web consuma 1 scansione del tuo piano e copre fino a 30 pagine.
- Un sito più grande viene coperto in più giri, uno al giorno, e ognuno consuma una scansione. Con 90 pagine, un ciclo completo richiede tre giri e tre scansioni.
- Fino a 30 pagine, il controllo giornaliero consuma circa 30 scansioni al mese e quello settimanale circa 4 o 5. Free, Starter e Pro includono 1, 9 e 20 scansioni al mese, condivise con l'aggiunta di pagine, quindi un controllo giornaliero di un sito esaurisce le scansioni di questi piani.
- Senza scansioni rimaste, le pagine web non vengono lette e aspettano che le scansioni ripartano da capo. Il riquadro indica quante pagine non sono state controllate, e quelle fonti mostrano "Not checked: Out of website crawls for this period (saved text kept)".
- Le pagine Notion e i file di Google Drive non consumano scansioni. Un giro legge fino a 30 pagine Notion e fino a 30 file Drive.
Quando avvengono i giri
- I giri avvengono al massimo una volta al giorno. Il processo giornaliero parte verso le 05:00 UTC; il riquadro mostra quell'orario nel tuo fuso orario. Quando molti agenti sono in coda, il processo continua in altri passaggi, quindi nei giorni più pieni un giro può iniziare più tardi.
- Con Daily, una pagina va controllata quando l'ultimo controllo risale a circa 20 ore prima. Con Weekly, a circa sei giorni e mezzo.
- Il riquadro mostra Last run (ultimo giro), Next run (prossimo giro, stimato) e Last run found (esito dell'ultimo giro), per esempio "12 checked · 2 changed · 0 failed".
Check now
Check now (controlla ora) avvia subito un controllo e ne attende l'esito, che può richiedere fino a un minuto. Controlla tutte le pagine, non solo quelle in scadenza, con gli stessi limiti: fino a 30 pagine web, consumando 1 scansione se ci sono pagine web, e fino a 30 pagine Notion e 30 file di Google Drive, partendo da quelli controllati meno di recente. Le pagine che non riesce a raggiungere vengono controllate al giro successivo. Funziona anche quando l'Auto-resync è disattivato.
Puoi usare Check now una volta ogni 10 minuti per agente; fino ad allora il riquadro mostra "Available again at …". Dopo un controllo, il prossimo giro programmato aspetta almeno 20 ore.
Stato di ogni fonte
Le fonti di sito web, Notion e Google Drive già controllate mostrano una riga "Checked … · changed …": la data dell'ultimo controllo e quella dell'ultima modifica del testo. Passa il mouse su una data per vedere l'ora esatta. Se l'ultimo controllo non è riuscito, la riga mostra "Check on … failed:", seguito dal motivo e da "(saved text kept)". Quando il motivo fa pensare che il sito abbia respinto il crawler, per esempio un 403 o un controllo anti-bot, una seconda riga porta a Siti che bloccano i crawler.
Esportare le fonti
Puoi scaricare il testo delle tue fonti in un file .zip:
- Clicca su Export all sopra l'elenco per esportare tutte le fonti.
- Oppure spunta delle fonti, o la casella di un gruppo, e clicca su Export nella barra che compare.
Il file si chiama per esempio knowledge-sources-2026-10-07.zip. Contiene un file per fonte, in una cartella per tipo: website/, files/, text/, qa/, notion/ e google-drive/.
- Ogni file contiene, come
.txt, il testo salvato da cui l'agente impara. Per un file caricato è il testo estratto, non il documento originale. - Le coppie di Q&A sono file
.mdnella formaQ: …eA: …, con ogni altra formulazione su una rigaQ:a sé. manifest.csvelenca tutte le fonti con le colonne Name, Type, URL, Characters, Status e File.
Un'esportazione contiene fino a 50 milioni di caratteri di testo, circa 50 MB. Per averne di più, seleziona meno fonti ed esportale in più parti.
Quando usare Re-index
Usa Re-index saved text su una fonte non riuscita, per esempio dopo un errore temporaneo, oppure seleziona più fonti e clicca su Re-index per addestrarle di nuovo. Per cambiare i contenuti, aggiorna dal sito, ricarica o modifica la fonte come descritto sopra.
Buone abitudini
- Guarda l'anteprima delle nuove fonti prima di addestrarle. Una pagina di cui è stato letto solo il menu, o una tabella PDF uscita male, si nota subito.
- Elimina le fonti superate o doppie invece di sperare che l'agente scelga quella giusta.
- Se l'agente continua a citare la fonte sbagliata, contrassegna come prioritaria quella giusta o aggiungi una coppia di Q&A.