Knowledge Base

La Knowledge Base è dove il suo chatbot apprende. Aggiunga contenuti da varie fonti per rendere la sua AI più intelligente e precisa.

Content Sources

ChatReact supporta più modalità per aggiungere conoscenza:

Knowledge Setup Wizard

Subito dopo aver creato un chatbot, ChatReact apre una guidata per la configurazione della knowledge con tre passaggi: Scan website, Upload documents, e Done. Utilizza gli stessi flussi di scansione del sito e di caricamento documenti descritti in questa pagina.

Può saltare uno dei passaggi di contenuto con Skip for now — ma senza contenuti il suo chatbot fornirà solo risposte generiche, quindi consigliamo di aggiungere almeno una fonte. Potrà sempre tornare e aggiungere ulteriori contenuti dalla Knowledge Base più tardi.

Overview Tab

La pagina della Knowledge Base ha quattro schede: Overview, Instructions, Websites, e Documents. Overview è la scheda di atterraggio predefinita e le offre una panoramica a colpo d'occhio:

• Knowledge Base Status — conteggi di Core Instructions, Improvement Instructions, pagine scansionate e documenti. Clicchi su una qualsiasi scheda per andare direttamente a quella sezione.
• Vector Store — mostra se il vector store è Active o Not initialized, oltre alla dimensione totale di archiviazione attualmente utilizzata.
• How Knowledge Base Works — una breve spiegazione su come Core Instructions e Documents vengono utilizzati insieme per rispondere alle domande.

Website Crawler

Importing Your Website

L'importazione del sito web è un flusso in tre passaggi nella scheda Websites: anteprima della struttura del sito, selezione delle pagine, quindi importazione del contenuto.

1. Navigare su Knowledge Base nella barra laterale e aprire la scheda Websites
2. Inserire l'URL del suo sito web (es., example.com)
3. Facoltativamente aggiungere Exclude URL patterns — un pattern per riga, usando * come wildcard (es., /gallery/*)
4. Cliccare Preview Pages — ChatReact scansiona il sito e elenca le pagine trovate
5. Selezionare le pagine da importare. Le pagine consigliate dall'AI sono preselezionate e contrassegnate con una stella — clicchi AI Selection in qualsiasi momento per ripristinare quella raccomandazione. Il suo piano determina quante pagine può selezionare.
6. Clicchi Import Pages (il pulsante mostra quante pagine ha selezionato) per avviare l'importazione

Crawl Limits

Il numero di pagine che può eseguire la scansione e le scansioni mensili dipendono dal suo piano. Veda la nostra Pricing page per i dettagli.

Crawl Status

Monitori l'avanzamento della scansione:

• Pending: In attesa di avvio
• Running: In corso di scansione delle pagine
• Completed: Tutte le pagine elaborate
• Failed: Si è verificato un errore (controlli i dettagli)
• Cancelled: La scansione è stata interrotta prima del completamento

La scansione viene eseguita in background — può lasciare la pagina e tornare più tardi per controllare l'avanzamento. L'indicatore di progresso si aggiorna in tempo reale.

Cancel a Crawl

Può annullare una scansione in esecuzione o in attesa in qualsiasi momento:

• Clicchi il pulsante Cancel nella barra di avanzamento durante una scansione attiva
• In Recent Crawls, ogni lavoro in esecuzione/in attesa ha anche un pulsante Cancel
• Se lascia la pagina durante una scansione, il pulsante Cancel è ancora disponibile quando ritorna

Viewing Crawl Results

Dopo il completamento di un'importazione, le sue pagine appaiono sotto Crawled Websites:

1. Visualizzi tutte le pagine importate con i loro titoli
2. Clicchi l'icona dell'occhio (View indexed content) per vedere il contenuto estratto visualizzato come Markdown formattato
3. Cerchi pagine per URL o titolo per trovare rapidamente una pagina specifica
4. Usi le caselle di controllo per selezionare più pagine ed eliminarle in un'unica operazione
5. Riesegua la scansione di singole pagine o dell'intero sito

Le pagine che non sono state aggiornate da oltre 30 giorni mostrano un badge di età (es., "45d old") in modo da poter vedere a colpo d'occhio quando il contenuto necessita di una nuova scansione.

Re-Crawling

Per aggiornare la sua knowledge base con contenuti freschi:

• Single page: Clicchi il pulsante di aggiornamento accanto a qualsiasi pagina scansionata
• Entire website: Utilizzi il pulsante di aggiornamento per l'intero dominio

Le riesecuzioni della scansione aggiornano i contenuti e rinfrescano il timestamp "last crawled". Riceverà una notifica al completamento. Può anche annullare una riesecuzione in corso.

Adding a Single URL

Non è necessaria una scansione completa per aggiungere una singola pagina. Clicchi Add URL nella barra degli strumenti di Crawled Websites, incolli l'indirizzo della pagina e ChatReact importerà solo quella pagina.

CMS Integrations

Se il suo sito utilizza WordPress, connetta il plugin ChatReact per scansioni più intelligenti e veloci arricchite con informazioni sul tipo di contenuto:

1. Nella scheda Websites, trovi la scheda CMS Integrations
2. Clicchi Generate Integration Key e copi la chiave (viene mostrata una sola volta)
3. Incolli la chiave nella scheda Integration del plugin in WordPress
4. Utilizzi Scan Website per importare i suoi contenuti

Veda la WordPress guide per l'installazione completa del plugin.

Documents

Carichi i suoi file nella scheda Documents:

1. Trascini i file nell'area di caricamento, oppure clicchi per selezionarli
2. Formati supportati: PDF, TXT, Markdown, CSV, JSON, DOCX (max 10 MB per file)
3. Ogni file mostra il proprio stato di elaborazione mentre viene aggiunto alla knowledge base
4. Apra o elimini i documenti caricati in qualsiasi momento

Oltre al limite di 10 MB per file, lo spazio totale per i documenti è limitato dal suo piano (per esempio 10 MB totali sul piano Free, di più sui piani a pagamento — veda la nostra Pricing page). Una volta raggiunta quella quota, i nuovi caricamenti vengono bloccati fino a quando non elimina alcuni documenti o non effettua l'upgrade.

Buoni candidati: descrizioni dei prodotti, elenchi di FAQ, tabelle dei prezzi, termini di servizio, guide di supporto e altra documentazione basata su testo.

FAQs

Le FAQ sono il modo più diretto per insegnare al suo chatbot:

Adding FAQs

1. Vada su FAQs nella barra laterale
2. Clicchi Add FAQ
3. Inserisca la domanda (come la farebbe un cliente)
4. Inserisca la risposta — l'editor rich-text supporta la formattazione
5. Facoltativamente assegni una categoria
6. Clicchi Create FAQ

FAQ Categories

Organizzi le FAQ in categorie:

• Pricing
• Technical Support
• Account Management
• Shipping & Returns

FAQ Suggestions

Generi suggerimenti per le FAQ su richiesta:

• Generate from Knowledge Base — utilizzi il pulsante nella scheda Suggestions della pagina delle FAQ
• Improvement Agent — l'agente può suggerire FAQ come parte delle sue proposte di miglioramento
• Manual — crei le FAQ manualmente in qualsiasi momento

Riveda i suggerimenti e approvi o scarti quelli non rilevanti. I suggerimenti per le FAQ sono disponibili sui piani a pagamento — veda la nostra Pricing page. Veda la FAQ Management guide per i dettagli.

Core Instructions

Le Core Instructions sono regole specifiche che il suo chatbot deve seguire:

Adding Instructions

1. Navigare su Knowledge Base nella barra laterale
2. Aprire la scheda Instructions
3. Cliccare Add Core Instruction
4. Scriva la sua istruzione chiaramente nell'editor (supporta formattazione e link)
5. Se il suo piano include l'Email Assistant (Professional e superiori), scelga Applies to: Chat only o Chat + Email. Le istruzioni "Chat + Email" si applicano anche come regole generali a ogni bozza di risposta email; come viene risposto un tipo specifico di email è impostato per categoria nell'Email Assistant. Sugli altri piani questa scelta non viene mostrata e le istruzioni si applicano alla chat.
6. Attivi/disattivi secondo necessità

Improvement Instructions

La scheda Instructions include anche una sezione separata e in sola lettura denominata Improvement Instructions. Queste vengono create automaticamente dall'Improvement Agent in base al feedback delle chat — non è possibile modificarle direttamente, ma ognuna collega alla sessione di miglioramento che l'ha generata. Veda la Improvement Agent guide per i dettagli.

Effective Instructions

Buoni esempi:

• "If a customer asks about pricing, direct them to our pricing page at /pricing"
• "Never disclose internal metrics or customer data"
• "For technical issues, always ask for the error message first"

Evitare:

• Istruzioni vaghe: "Be helpful"
• Regole contraddittorie
• Logiche eccessivamente complesse

Smart Content Search

ChatReact cerca nella sua knowledge base per significato, non solo per parole chiave. Il suo chatbot trova e fa riferimento alle informazioni giuste anche quando i clienti formulano le domande in modo diverso rispetto a come i contenuti sono scritti.

Best Practices

1. Start with FAQs: Aggiunga le sue 20 domande più comuni
2. Crawl strategically: Mirare alle pagine di documentazione, non al contenuto di marketing
3. Review regularly: Controlli quali domande il suo bot non riesce a rispondere
4. Iterate: Utilizzi l'Improvement Agent per perfezionare in base al feedback

API Access

Documenti (caricamento, elenco, eliminazione), scansione del sito web (anteprima, avvio, controllo stato, annullamento), pagine scansionate e Core Instructions possono essere gestiti programmaticamente tramite la REST API o il MCP Server — utile per sincronizzare contenuti da un CMS esterno o automatizzare gli aggiornamenti della knowledge base.

Next Steps

• FAQs Management →
• Improvement Agent →
• Analytics →