Knowledge base
Crea un data store, carica i documenti, controlla l'indicizzazione e verifica la qualità del recupero.
Quinto passaggio della guida rapida. La knowledge base è ciò che distingue un agente utile da un generatore di frasi generiche: senza documenti, l'agente non ha nulla di aziendale da dire.
Prima di iniziare
- Ruolo Amministratore oppure Manager
- Documenti aziendali aggiornati e approvati per la pubblicazione
- Verifica che i documenti non contengano dati personali di terzi o informazioni riservate
- Un progetto già creato a cui collegare il data store
Crea il data store
Apri la knowledge base
Nel menu laterale seleziona Knowledge base, quindi Data store. L'elenco mostra nome, numero di documenti, dimensione indicizzata, stato e data dell'ultimo aggiornamento.
Definisci nome e ambito
Seleziona Nuovo data store e assegna un nome che descriva il contenuto, non il formato: Regolamento e listini 2026 è utile, PDF caricati no.
| Campo | Obbligatorio | Esempio |
|---|---|---|
| Nome | Sì | Regolamento e listini 2026 |
| Descrizione | No | Tariffario, condizioni generali e FAQ per il sito pubblico |
| Lingua prevalente | Sì | Italiano |
| Visibilità | Sì | Progetti selezionati |
Collega i progetti
Seleziona i progetti che potranno consultare il data store. Un data store può servire più progetti e un progetto può attingere a più data store: separa per argomento, non per progetto.
Salva
Il data store viene creato vuoto e pronto a ricevere documenti.
Carica i documenti
Trascina i file
Apri il data store e trascina i file nell'area di caricamento, oppure seleziona Carica e scegli i file dal disco. Puoi caricare fino a 25 file per operazione.
Compila i metadati
Per ogni documento imposta i metadati che l'agente potrà usare come filtro.
| Metadato | Uso |
|---|---|
| Titolo | Mostrato nelle citazioni delle risposte |
| Categoria | Filtro tematico durante il recupero |
| Data di validità | Esclude automaticamente i documenti scaduti |
| Lingua | Migliora il recupero nei data store multilingua |
| Riservatezza | Limita l'uso ai soli progetti autorizzati |
Avvia l'indicizzazione
Conferma il caricamento. L'indicizzazione parte automaticamente e prosegue in background: puoi chiudere la pagina.
Formati supportati
| Formato | Estensione | Note operative |
|---|---|---|
.pdf | OCR automatico sulle pagine senza testo selezionabile | |
| Word | .docx | Gli stili di titolo migliorano la suddivisione in frammenti |
| Excel | .xlsx | Un foglio per tabella, intestazioni sulla prima riga |
| Testo | .txt | Codifica UTF-8 |
| Markdown | .md | Formato consigliato: la struttura è già esplicita |
| CSV | .csv | Separatore virgola o punto e virgola, UTF-8 |
| HTML | .html | Script, stili e menu vengono rimossi automaticamente |
Limiti di riferimento: 50 MB per file, 1.500 pagine per documento, 10.000 documenti per data store. I valori effettivi dipendono dal piano: vedi Requisiti e compatibilità.
Stati dell'indicizzazione
| Stato | Significato | Cosa fare |
|---|---|---|
| In coda | Caricamento completato, elaborazione non ancora iniziata | Attendere |
| In elaborazione | Estrazione del testo e suddivisione in frammenti in corso | Attendere |
| OCR in corso | Documento scansionato, riconoscimento caratteri in corso | Attendere, tempi più lunghi |
| Indicizzato | Documento consultabile dall'agente | Verificare il recupero |
| Parziale | Alcune pagine non sono state elaborate | Aprire il dettaglio e correggere le pagine segnalate |
| Errore | Elaborazione fallita | Leggere il messaggio, correggere il file, ricaricare |
Il tempo tipico va da 30 secondi per un documento testuale breve a 10 minuti per un PDF scansionato di centinaia di pagine.
Un documento non indicizzato non esiste
Finché lo stato non è Indicizzato, l'agente non vede il contenuto. Prima di dichiarare pronta la knowledge base, filtra l'elenco per stato e verifica che non restino documenti in errore o parziali.
Collega una sorgente database
Oltre ai file, un data store può essere alimentato da una sorgente dati aziendale sincronizzata periodicamente.
Scegli il tipo di sorgente
Seleziona il connettore: base dati relazionale, endpoint HTTP che restituisce JSON, oppure acquisizione di pagine web da sitemap.
Inserisci i parametri di connessione
Le credenziali sono conservate cifrate e non sono più visibili dopo il salvataggio.
Parametri della sorgente
| Parametro | Tipo | Obblig. | Default | Descrizione |
|---|---|---|---|---|
nome | string | Sì | — | Nome descrittivo della sorgente, visibile nel registro delle sincronizzazioni. |
tipo | string | Sì | — | Tipo di connettore: database, endpoint HTTP oppure sitemap. |
endpoint | string | Sì | — | Host e porta della base dati oppure URL da interrogare. |
credenziali | string | Sì | — | Utenza dedicata in sola lettura. Conservata cifrata e non più visibile dopo il salvataggio. |
query | string | No | — | Interrogazione in sola lettura che seleziona i record da indicizzare. |
campoTitolo | string | Sì | — | Colonna o campo usato come titolo del frammento. |
campoContenuto | string | Sì | — | Colonna o campo che contiene il testo da indicizzare. |
frequenza | string | No | giornaliera | Cadenza di sincronizzazione: oraria, giornaliera oppure manuale. |
Prova la connessione
Seleziona Prova connessione: la Console mostra i primi cinque record recuperati. Verifica che titolo e contenuto siano quelli attesi prima di attivare la sincronizzazione.
Attiva la sincronizzazione
Salva e attiva. Ogni esecuzione è registrata con data, numero di record elaborati ed eventuali errori.
Usa sempre un'utenza in sola lettura
Il connettore non deve mai avere permessi di scrittura sulla base dati aziendale. Crea un'utenza dedicata, limitata alle sole tabelle o viste necessarie, e non riutilizzare le credenziali applicative esistenti.
Verifica la qualità del recupero
Prepara le domande reali
Raccogli almeno 15 domande realmente ricevute da clienti o pazienti. Non inventarle: le domande immaginate dal team sono sempre più ordinate di quelle reali.
Esegui la prova
Inserisci ogni domanda nella prova di recupero. La Console mostra i frammenti recuperati, il documento di origine e il punteggio di pertinenza.
Valuta i risultati
Per ogni domanda verifica che il primo frammento contenga effettivamente la risposta. Se il frammento corretto è oltre la terza posizione, il contenuto va riscritto o riorganizzato.
Correggi i contenuti
Interviene sui documenti, non sui parametri: aggiungi titoli espliciti, riformula i paragrafi ambigui, separa gli argomenti accorpati. Poi reindicizza e ripeti la prova.
| Sintomo | Causa probabile | Intervento |
|---|---|---|
| Nessun frammento recuperato | Argomento assente dai documenti | Aggiungere il contenuto mancante |
| Frammenti pertinenti ma incompleti | Frammenti troppo corti o testo spezzato | Riorganizzare il documento con titoli chiari |
| Frammenti di argomenti diversi | Documento troppo eterogeneo | Suddividerlo in più documenti tematici |
| Risposte basate su dati superati | Versioni vecchie ancora indicizzate | Rimuovere il documento obsoleto e reindicizzare |
Buone pratiche per i documenti
| Pratica | Perché |
|---|---|
| Un argomento per documento | Frammenti più coerenti e recupero più preciso |
| Titoli e sottotitoli espliciti | I titoli entrano nei frammenti e guidano la ricerca semantica |
| Paragrafi brevi, da 3 a 6 righe | La suddivisione produce unità di senso complete |
| Termini per esteso alla prima occorrenza | L'utente cerca "ricetta elettronica", non solo la sigla |
| Nessuna immagine con testo non trascritto | Diagrammi e tabelle in immagine non sono recuperabili |
| Nessuna scansione senza OCR verificato | L'OCR su documenti di bassa qualità produce testo inaffidabile |
| Date esplicite nel testo | Evita risposte basate su tariffe o regolamenti superati |
| Nessun dato personale di terzi | Obbligo di conformità: vedi Conformità |
# Prestazioni ambulatoriali 2026
## Prenotazione in regime SSN
Serve il numero di ricetta elettronica e il codice fiscale
dell'assistito. La prenotazione si effettua allo sportello,
per telefono o dal sito.
## Prenotazione in regime privato
Non serve la ricetta. Il costo è indicato nel tariffario
allegato ed è dovuto un acconto del 30% alla conferma.
## Disdetta
La disdetta è gratuita fino a 48 ore prima dell'appuntamento.
Oltre tale termine è dovuta la quota di mancata presentazione.Reindicizzazione
Reindicizza quando: sostituisci un documento con una versione aggiornata, modifichi i metadati, cambi la strategia di suddivisione o correggi documenti in stato parziale.
Sostituisci il documento
Usa Sostituisci anziché caricare un secondo file: mantiene identificativo, metadati e collegamenti, ed evita che due versioni convivano nella knowledge base.
Avvia la reindicizzazione
Puoi reindicizzare un singolo documento oppure l'intero data store. La reindicizzazione completa richiede più tempo ma è necessaria dopo un cambio di configurazione.
Verifica il risultato
Durante la reindicizzazione l'agente continua a usare l'indice precedente: non ci sono interruzioni di servizio. Al termine ripeti le prove di recupero.
Cadenza consigliata di revisione della knowledge base
Revisione contenuti: trimestrale — Verifica recupero: mensile — Controllo documenti in errore: settimanaleInserisci queste attività nel calendario del referente contenuti.
Passaggio 5 completato
La knowledge base è popolata, indicizzata e verificata. Continua con la pubblicazione del widget.