Knowledge Base
La knowledge base è il cervello del tuo worker: contiene tutte le informazioni che usa per rispondere ai clienti in modo preciso e contestuale.
Formati supportati
Puoi caricare documenti in diversi formati. Ogni file viene elaborato, segmentato e indicizzato automaticamente.
| Formato | Estensioni | Note |
|---|---|---|
.pdf | Cataloghi, manuali, listini prezzi. Il testo viene estratto automaticamente. | |
| Word | .docx | Documenti strutturati con titoli, paragrafi e tabelle. |
| Testo | .txt | File di testo semplice, FAQ, note interne. |
| URL | https://... | Pagine web indicizzate tramite Brave Search. Il contenuto viene scaricato e processato. |
Processo di caricamento
- Vai nella sezione Knowledge Base della dashboard.
- Clicca su “Aggiungi documento” e seleziona il file dal tuo computer oppure incolla un URL.
- Il sistema estrae il testo, lo suddivide in sezioni (chunk) e genera un embedding vettoriale per ciascuna sezione.
- Il documento appare nella lista con stato “Pronto” quando l'elaborazione è completa.
Come funziona la ricerca (RAG)
Hello Worker utilizza la tecnica RAG (Retrieval-Augmented Generation) per rispondere ai clienti. Ecco come funziona in sintesi:
- Quando un cliente fa una domanda, il sistema la converte in un vettore numerico (embedding).
- Cerca nella knowledge base le sezioni più simili alla domanda, usando la ricerca vettoriale su Supabase (pgvector).
- Le sezioni più rilevanti vengono passate al modello AI (Claude) come contesto, insieme alla domanda del cliente.
- Il modello genera una risposta basata esclusivamente sulle informazioni trovate nella knowledge base, riducendo al minimo le risposte inventate.
Nota: Se la knowledge base non contiene informazioni sufficienti per rispondere, il worker lo comunicherà al cliente in modo trasparente, piuttosto che inventare una risposta.
Sistema di correzioni
Se il worker fornisce una risposta imprecisa o incompleta, puoi correggerlo direttamente dalla cronologia delle conversazioni. Le correzioni vengono memorizzate e usate come riferimento per le risposte future.
Questo sistema di apprendimento continuo migliora progressivamente la qualità delle risposte senza richiedere interventi tecnici.
Best practice per i documenti
- Usa titoli chiari: Documenti ben strutturati con titoli e sottotitoli producono risultati migliori.
- Evita scansioni di bassa qualità: I PDF creati da scansioni con OCR scarso possono contenere errori che confondono il worker.
- Aggiorna regolarmente: Rimuovi documenti obsoleti e carica le versioni aggiornate per mantenere la knowledge base accurata.
- Un documento per argomento: Preferisci documenti focalizzati su un singolo argomento piuttosto che un unico file enorme con tutto.
- Includi le FAQ: Le domande frequenti in formato domanda/risposta sono il tipo di contenuto più efficace per la knowledge base.