Knowledge Base

La Knowledge Base è dove memorizzi tutto ciò che il tuo Finn deve sapere sulla tua attività. Menu, prezzi, orari, politiche, FAQ — qualsiasi cosa i chiamanti possano chiedere. Quando il chiamante fa una domanda, il Finn recupera la risposta da qui.

Non complicarti la vita. La maggior parte degli utenti inizia caricando un PDF (le proprie FAQ o una brochure di prodotto) e questo basta al Finn per gestire l'80% delle domande dei chiamanti. Puoi sempre aggiungere altro in seguito.

Privacy: tutto ciò che inserisci nella Knowledge Base è ricercabile in ogni chiamata gestita da questo Finn. Non inserire qui dati specifici del singolo chiamante (come saldi dei conti o stato degli ordini) — per questo usa invece un webhook di consultazione dati in tempo reale.

Dove configurarla

Create New Finn → scheda Knowledge Base. Modificabile anche in seguito da View All Finn → [Finn] → Edit → Knowledge Base.

Tre fonti, un unico indice

Puoi combinare tre tipi di materiale di origine:

1. File caricati — PDF, DOCX, Markdown, testo semplice.
2. Testo incollato — copia e incolla i contenuti direttamente nell'editor.
3. Importazioni da sito web — fornisci un URL e la piattaforma esegue la scansione e l'indicizzazione delle pagine.

Tutte e tre confluiscono in un unico indice ricercabile per ciascun Finn. Al momento della chiamata il Finn non sa (né gli serve sapere) da dove provenga uno snippet.

File caricati

Formati supportati

Limiti

• Dimensione massima file: 25 MB per file.
• Numero massimo di file per Finn: 100.
• Dimensione totale indicizzata: 500 MB per Finn (varia in base al piano).

Cosa viene indicizzato

La piattaforma estrae testo, tabelle e intestazioni. Le immagini e i PDF solo scansionati (senza livello di testo incorporato) vengono ignorati — eseguine prima l'OCR esternamente.

Best practice

• File più piccoli, ma più numerosi > un unico PDF enorme. Il sistema di recupero funziona meglio con documenti mirati.
• Elimina il boilerplate — intestazioni, piè di pagina e numeri di pagina aggiungono rumore.
• Un solo argomento per file — più facile da aggiornare senza reindicizzare tutto.

Testo incollato

Per contenuti rapidi e informali che non meritano un file. Limiti: 100.000 caratteri per incollaggio, 10 incollaggi per Finn.

Usalo per:

• Estratti di FAQ.
• Brevi descrizioni di prodotto.
• Dati che cambiano ogni giorno (il codice promo di oggi, i tempi di attesa attuali) — anche se per dati realmente in tempo reale è meglio usare un task Webhook.

Importazioni da sito web

Fornisci un URL. La piattaforma esegue la scansione del sito e indicizza le pagine.

Configurazione

Cosa funziona bene

• Centri assistenza pubblici e pagine FAQ.
• Cataloghi prodotti con HTML pulito.
• Pagine di marketing con rendering statico.

Cosa non funziona

• Siti che richiedono l'accesso.
• Single-page app complesse in cui il contenuto viene generato via JS dopo il caricamento della pagina (usa invece il caricamento di file).
• Siti che bloccano i crawler tramite robots.txt (la piattaforma lo rispetta).

Come funziona il recupero durante la chiamata

Quando il chiamante pone una domanda:

1. Il Finn formula una query a partire dall'enunciato del chiamante.
2. La piattaforma cerca nell'indice (ibrido vettoriale + parole chiave).
3. Gli N snippet più pertinenti vengono inseriti nel prompt dell'LLM.
4. Il Finn genera una risposta basata su quegli snippet.

Puoi verificare cosa è stato recuperato per ogni chiamata nella scheda Data Extractor Sidebar → Knowledge. Utile per capire "perché il Finn ha detto questo?"

Ottimizzare il recupero

Se il Finn dà risposte errate o fuori tema:

• Aggiungi contenuti più specifici. Se "qual è la vostra politica di rimborso?" restituisce risposte vaghe, aggiungi un file dedicato alla politica di rimborso.
• Elimina le contraddizioni. Due file che dicono cose diverse confondono il recupero. Verifica e uniforma.
• Rafforza i vincoli del messaggio di benvenuto. Indica esplicitamente al Finn cosa rientra nell'ambito. "Rispondi solo a domande sulla pianificazione degli appuntamenti. Per qualsiasi altra cosa, trasferisci a un operatore."
• Riordina. I piani premium consentono di impostare una priorità per fonte: i file più recenti prevalgono su quelli più vecchi.

Quando non usare la knowledge base

Alcuni dati non dovrebbero risiedere qui:

• Dati per chiamante (saldi dei conti, stato degli ordini): usa un task Webhook per recuperarli in tempo reale.
• Dati sensibili (codici fiscali, numeri di carta di credito completi): non inserirli mai. La KB è consultabile in tutte le chiamate.
• Contenuti molto dinamici (prezzi che cambiano ogni ora): anche in questo caso, un webhook.

La KB serve per il contesto di base uguale per ogni chiamante. Tutto ciò che è specifico del chiamante o sensibile al tempo dovrebbe essere un recupero in tempo reale.

Reindicizzazione

La piattaforma reindicizza:

• Automaticamente: quando aggiungi, rimuovi o modifichi una fonte.
• Su pianificazione: per le importazioni da sito web, in base alla frequenza di ri-scansione.
• Manualmente: Knowledge Base → Reindicizza ora. Forza una ricostruzione completa.

La reindicizzazione richiede in genere pochi secondi (KB piccole) o qualche minuto (500 MB).

Costi

L'archiviazione e le query della Knowledge Base sono incluse nel piano fino ai limiti di dimensione indicati sopra. Il superamento dei limiti richiede un upgrade del piano: vedi Fatturazione →.

Avanti

• Workflow → — quando il recupero libero non è abbastanza strutturato.
• Integrazioni → — recupero di dati in tempo reale tramite webhook.