Impostazioni ed esportazione
Questa pagina descrive la scheda Impostazioni di una base di conoscenza e le azioni che riguardano la base di conoscenza nel suo insieme: reindicizzazione, esportazione ed eliminazione.
Prerequisiti
- Una base di conoscenza già creata.
- Per modificare le impostazioni, il diritto di modificare la base di conoscenza (vedere Condivisione).
La scheda Impostazioni
La scheda Impostazioni raccoglie cinque sezioni una sotto l'altra: Generali, Indicizzazione, Recupero, Accesso e condivisione e Zona di attenzione. A destra il pannello Navigazione elenca le stesse sezioni, evidenzia quella visualizzata e permette di raggiungerle con un clic.
Le modifiche ai campi delle sezioni Generali e Indicizzazione si confermano con la barra in fondo alla pagina: quando ci sono modifiche non salvate la barra lo segnala e i pulsanti Salva e Annulla diventano attivi; Annulla ripristina i valori salvati. Chi non ha il permesso di modifica vede i campi in sola lettura.
Generali
| Campo | Descrizione |
|---|---|
| Nome | Obbligatorio, fino a 100 caratteri |
| Conoscenza padre | Base di conoscenza a cui questa è subordinata, oppure Nessuna |
| Descrizione | Testo descrittivo mostrato nell'elenco |
| Lingue dei contenuti | Lingue dei contenuti; la prima è quella principale della base, usata per l'indice testuale, mentre la ricerca semantica trova i contenuti anche con domande in altre lingue |
| Modello per immagini e scansioni (OCR) | Modello usato per leggere scansioni e immagini, oppure Usa il modello predefinito di sistema |
Indicizzazione
L'intestazione della sezione riporta il modello di embedding e la dimensione dei vettori, scelti alla creazione e non modificabili.
| Campo | Descrizione |
|---|---|
| Strategia di suddivisione | Fissa, Ricorsiva, Semantica o Padre-figlio |
| Dimensione frammento | Da 100 a 4.000 token |
| Sovrapposizione | Da 0 a 1.000 token |
| Arricchimento contestuale | Interruttore Aggiungi titolo e contesto a ogni frammento, da lasciare nello stato proposto |
| Parent Chunk Size e Child Chunk Size | Solo con la strategia Padre-figlio: dimensione del frammento più ampio e di quello usato per la ricerca |
Le modifiche a questa sezione valgono per i contenuti elaborati dopo il salvataggio. Il significato dei parametri è descritto in Parametri avanzati del RAG.
Recupero
La sezione Recupero riporta, in sola lettura, i valori registrati alla creazione della base di conoscenza: Risultati, Soglia di somiglianza, Funzione di distanza, HyDE e Quantizzazione binaria con il relativo fattore di oversampling. Il recupero delle risposte degli agenti non li utilizza: segue il flusso comune descritto in Parametri avanzati del RAG, di cui ciascun agente regola soltanto i Passaggi nel contesto e la Ricerca autonoma nella conoscenza nella sezione Conoscenza (vedere Conoscenza dell'agente).
Accesso e condivisione
La sezione mostra l'interruttore Tutti gli utenti dell’organizzazione possono modificare, l'elenco degli accessi configurati e il pulsante Condividi. Il funzionamento è descritto in Condivisione.
Zona di attenzione
La sezione riporta quanti documenti, siti e FAQ verrebbero rimossi eliminando la base di conoscenza e, se la base è usata da agenti, ricorda che occorre scegliere che cosa farne. Il pulsante Elimina avvia l'eliminazione descritta più avanti.
Reindicizzare la base di conoscenza
La voce Reindicizza tutto del menu Azioni (icona con tre puntini nell'intestazione) avvia una reindicizzazione in background. Durante l'operazione la base di conoscenza è nello stato In costruzione e la voce non è selezionabile; al termine torna Pronta, oppure passa a Errore se l'operazione non riesce. Se una reindicizzazione è già in corso, un messaggio lo segnala.
Esportare la base di conoscenza
La voce Esporta KB del menu Azioni scarica un archivio ZIP con il nome della base di conoscenza. L'archivio contiene i file originali dei documenti caricati, il testo delle pagine web acquisite e un file di riepilogo con l'elenco dei contenuti esportati. I dati estratti dalle sorgenti dati e le FAQ non sono inclusi come file. L'esportazione è utile per conservare una copia dei contenuti.
Eliminare la base di conoscenza
L'eliminazione si avvia da tre punti: la voce Elimina del menu Azioni nell'intestazione, il pulsante Elimina della sezione Zona di attenzione e la voce Elimina del menu della riga nell'elenco Conoscenza. In tutti i casi si apre lo stesso dialog di conferma.
- Avviare l'eliminazione da uno dei tre punti.
- Leggere il riepilogo: l'operazione è irreversibile e rimuove documenti, siti, FAQ e frammenti indicati.
- Se la base di conoscenza è usata da agenti, controllare l'elenco degli agenti e scegliere in Cosa fare degli agenti una delle due opzioni.
- In Scrivi il nome per confermare, digitare il nome esatto della base di conoscenza.
- Fare clic su Elimina conoscenza.
| Opzione | Effetto sugli agenti |
|---|---|
| Scollega la conoscenza, gli agenti restano attivi | La base di conoscenza viene rimossa dalla configurazione degli agenti, che continuano a rispondere con le basi di conoscenza rimaste |
| Metti in pausa gli agenti collegati | Gli agenti attivi elencati vanno in pausa e smettono di rispondere finché non vengono riattivati; gli agenti non attivi restano invariati |
Se non è possibile aggiornare tutti gli agenti collegati, la base di conoscenza non viene eliminata e un messaggio lo segnala. Alcuni agenti potrebbero essere già stati aggiornati: ripetere l'operazione è sicuro, perché gli agenti già aggiornati non vengono modificati di nuovo.
Basi di conoscenza temporanee
Alcune funzionalità della piattaforma, ad esempio l'opzione Crea una conoscenza temporanea dell'analisi di un PDF, creano al volo una base di conoscenza temporanea legata a un singolo documento. Queste basi di conoscenza non compaiono nell'elenco Conoscenza e vengono rimosse automaticamente dopo un periodo di conservazione, senza richiedere intervento manuale. Vedere Analisi documentale.
Problemi comuni
| Problema | Causa | Soluzione |
|---|---|---|
| Il pulsante Salva restituisce un errore di autorizzazione | La modifica della base di conoscenza è riservata ad alcune persone | Chiedere un accesso Editor, vedere Condivisione |
| Il pulsante Elimina conoscenza non si attiva | Il nome digitato non coincide esattamente con quello della base di conoscenza | Digitare il nome esatto, rispettando maiuscole e spazi |
| L'eliminazione non va a buon fine e compare un messaggio sugli agenti collegati | Non è stato possibile aggiornare tutti gli agenti | Ripetere l'eliminazione |
| L'esportazione non si avvia | La base di conoscenza è molto grande e la generazione dell'archivio richiede tempo | Attendere il completamento; ripetere l'operazione se non si conclude dopo un tempo ragionevole |