Le basi di conoscenza
Una base di conoscenza è la raccolta organizzata di contenuti (documenti, pagine web, domande frequenti, dati estratti da database esterni) che un agente conversazionale consulta prima di rispondere. Una stessa base di conoscenza può essere collegata a più agenti, e un agente può avere più basi di conoscenza collegate contemporaneamente.
Nella console le basi di conoscenza si trovano nella voce di menu Conoscenza. Per una spiegazione di come i contenuti vengono effettivamente usati dall'agente, vedere Come funziona il RAG.
L'elenco delle basi di conoscenza
La pagina Conoscenza elenca le basi di conoscenza dell'organizzazione in una tabella con le colonne Nome (con la descrizione sotto il nome), Fonti, Stato e Ultima modifica. La colonna Fonti riporta il totale di documenti, siti web e FAQ; passando il puntatore sul numero compare il dettaglio per tipo. I dati estratti dalle sorgenti database non rientrano in questo totale.
La tabella si può cercare per nome e filtrare per Nome e Stato. Il pulsante Nuova base di conoscenza apre il form di creazione, descritto in Creare una base di conoscenza. Un clic sulla riga apre la base di conoscenza; il menu Azioni di ogni riga offre Modifica (apre la base di conoscenza), Carica documenti (apre la scheda Documenti) ed Elimina.
| Stato | Significato |
|---|---|
| Pronta | La base di conoscenza è disponibile e può essere collegata a un agente |
| In costruzione | È in corso una reindicizzazione avviata con Reindicizza tutto |
| Inattiva | La base di conoscenza è disattivata |
| Errore | Si è verificato un errore, ad esempio durante una reindicizzazione |
Una base di conoscenza può avere una Conoscenza padre, utile per organizzare in modo gerarchico contenuti correlati: ad esempio una base generale di prodotto con basi figlie dedicate alle singole linee di prodotto.
I tipi di fonte
Ogni base di conoscenza può contenere fonti di tipo diverso, anche combinate tra loro:
| Tipo di fonte | Descrizione | Pagina dedicata |
|---|---|---|
| Documenti | File caricati (PDF, Word, Excel, testo, CSV, HTML, Markdown) | Documenti |
| Siti web | Pagine acquisite automaticamente da un sito | Siti web |
| FAQ | Domande e risposte redatte e verificate in console | FAQ |
| Sorgenti dati | Righe restituite da una query su un database esterno | Sorgenti dati |
Il dettaglio di una base di conoscenza
Aprendo una base di conoscenza si accede alla sua pagina di dettaglio. In alto compaiono il nome, lo stato, l'identificativo numerico (con il pulsante per copiarlo) e le lingue dei contenuti, indicate con il codice della lingua; passando il puntatore sulle lingue compare il nome completo. Se la base ha una descrizione, questa compare sotto lo stato e le lingue.
Accanto al titolo si trovano due comandi. Il pulsante Aggiungi fonte apre un menu con le voci Documenti, Siti web, FAQ e Sorgenti dati, ciascuna con una breve indicazione di ciò che accetta; ogni voce apre il relativo dialog e, al termine, porta alla scheda corrispondente. Il menu Azioni (icona con tre puntini) contiene Reindicizza tutto, Condividi, Esporta KB ed Elimina, descritti in Impostazioni ed esportazione e in Condivisione.
Le informazioni in cima alla pagina
Sotto l'intestazione una riga di metriche riassume lo stato della base di conoscenza:
| Metrica | Che cosa indica |
|---|---|
| documenti | Numero di documenti caricati, esclusi pagine web, FAQ e dati da database |
| in attesa | Documenti ancora da elaborare |
| frammenti | Numero di blocchi di testo indicizzati |
| spazio | Spazio occupato dai contenuti |
| agenti la usano | Numero di agenti che hanno collegato la base di conoscenza; un clic apre l'elenco Agenti filtrato su quegli agenti. Se il numero non è disponibile compare un trattino |
| ultimo aggiornamento | Data e ora dell'ultima modifica della base di conoscenza |
Le schede delle fonti
Sotto le metriche cinque schede portano alle sottopagine della base di conoscenza. Ogni scheda riporta un breve riepilogo di ciò che contiene:
| Scheda | Riepilogo mostrato | Contenuto |
|---|---|---|
| Documenti | numero di documenti ed eventuali documenti in coda | Elenco dei file caricati, con l'anteprima del testo estratto |
| Siti web | numero di siti collegati e pagine acquisite | Siti collegati, pagine scoperte e loro anteprima |
| FAQ | numero di FAQ ed eventuali bozze | Elenco delle FAQ e importazione in blocco |
| Sorgenti dati | numero di connessioni e frequenza di aggiornamento, se impostata | Connessione al database, query, anteprima e cronologia delle estrazioni |
| Impostazioni | chunk, lingue, accesso | Impostazioni generali, indicizzazione, valori di recupero, accesso e condivisione, eliminazione |
All'apertura della base di conoscenza viene mostrata la scheda Documenti. Mentre è in corso l'acquisizione di un sito, metriche e riepiloghi si aggiornano automaticamente.
Chi può gestire le basi di conoscenza
I ruoli predefiniti operatore e amministratore dispongono di tutti i permessi sulle basi di conoscenza: consultazione, creazione, modifica, caricamento, reindicizzazione ed eliminazione. La lettura di una base di conoscenza è sempre aperta a tutta l'organizzazione; la modifica può essere riservata ad alcune persone, come descritto in Condivisione.