Knowledge Base

La Knowledge Base (KB) e il patrimonio di conoscenza permanente e curato della tua organizzazione all'interno di Queria. A differenza dei documenti caricati in modo temporaneo nelle conversazioni, i documenti nella Knowledge Base sono sempre disponibili, prioritari nelle ricerche e condivisi con tutti gli utenti autorizzati.

Cos'e la Knowledge Base

La Knowledge Base rappresenta l'insieme dei documenti autorevoli e di riferimento della tua azienda: manuali operativi, procedure interne, policy, specifiche tecniche, contratti quadro e qualsiasi altro documento che debba essere sempre consultabile dall'assistente AI.

I documenti nella KB hanno caratteristiche distintive:

• Persistenza: restano disponibili finche non vengono esplicitamente rimossi.
• Priorita: nelle ricerche, i risultati dalla KB hanno un peso maggiore rispetto ai documenti standard.
• Condivisione: sono accessibili a tutti gli utenti dell'organizzazione (nel rispetto dei permessi configurati).
• Cura: richiedono un'attenzione particolare in termini di qualita, aggiornamento e pertinenza.

Dual Cog-RAG: Knowledge Base vs Documenti Utente

L'architettura Cog-RAG di Queria opera con un sistema denominato Dual Cog-RAG, che distingue due collezioni di documenti:

Knowledge Base (Permanente)

• Collezione condivisa a livello aziendale.
• Documenti curati e validati.
• Sempre disponibile in tutte le conversazioni.
• Rappresenta la "verita aziendale" di riferimento.
• Gestita dall'amministratore o dagli utenti autorizzati.

Documenti Utente (Temporanei)

• Allegati caricati dall'utente durante una conversazione specifica.
• Disponibili solo nella conversazione in cui sono stati caricati.
• Rimossi automaticamente alla chiusura della conversazione (cleanup automatico).
• Ideali per analisi estemporanee e confronti rapidi.

Come Interagiscono

Quando poni una domanda nella chat, l'assistente interroga entrambe le collezioni:

1. Cerca nella Knowledge Base per trovare informazioni autorevoli e consolidate.
2. Cerca nei documenti utente della conversazione corrente per integrare con materiale specifico.
3. Se abilitate, consulta anche le sorgenti esterne certificate.
4. Combina tutti i risultati, dando priorita alla KB, e genera una risposta coerente con citazioni tracciabili.

Questo approccio ti permette di avere sempre accesso alla conoscenza aziendale consolidata, arricchita all'occorrenza dai documenti che alleghi in conversazione.

Come Aggiungere Documenti alla KB

Esistono diversi percorsi per aggiungere documenti alla Knowledge Base:

Dalla Sezione Documenti

1. Vai alla pagina Documenti dal menu di navigazione.
2. Carica il file attraverso una qualsiasi delle modalita disponibili (upload, cloud, rete, URL).
3. Durante o dopo il caricamento, seleziona l'opzione "Aggiungi alla Knowledge Base".
4. Il documento verra elaborato e inserito nella collezione KB.

Da un Documento Esistente

1. Nella lista documenti, individua il documento che desideri promuovere a Knowledge Base.
2. Apri il menu azioni del documento.
3. Seleziona "Sposta in Knowledge Base".
4. Conferma l'operazione. Il documento verra rielaborato e inserito nella collezione KB.

Importazione Massiva

Per aggiungere molti documenti contemporaneamente alla KB, utilizza la modalita JSONL specificando il flag Knowledge Base per ogni record, oppure carica i file tramite la sincronizzazione cloud/rete con la destinazione KB abilitata.

Quando Usare la KB vs i Documenti Standard

Scenario	Dove caricare
Manuale operativo aziendale	Knowledge Base
Policy e procedure interne	Knowledge Base
Contratto quadro di riferimento	Knowledge Base
Scheda tecnica di un prodotto chiave	Knowledge Base
FAQ aziendali	Knowledge Base
Bozza di contratto da analizzare	Documento standard o temporaneo
Report mensile da consultare	Documento standard
File ricevuto via email da verificare al volo	Documento temporaneo (allegato in chat)
Documento di progetto attivo	Documento standard
Normativa interna consolidata	Knowledge Base

La regola generale e semplice: se un documento rappresenta una fonte autorevole e duratura per l'organizzazione, appartiene alla Knowledge Base. Se e un documento operativo o temporaneo, basta lo standard.

Gestione della Knowledge Base

Aggiornamento dei Documenti

Quando un documento nella KB viene aggiornato (ad esempio una nuova versione di una procedura):

1. Carica la nuova versione del file.
2. Il sistema rileva la sostituzione e rielabora il documento.
3. I segmenti vettoriali vengono aggiornati automaticamente.
4. Le ricerche successive restituiranno le informazioni aggiornate.

Rimozione dalla KB

Se un documento non e piu pertinente o autorevole:

1. Individua il documento nella sezione Knowledge Base.
2. Seleziona "Rimuovi dalla Knowledge Base".
3. Puoi scegliere se mantenerlo come documento standard o eliminarlo completamente.

Monitoraggio

La dashboard della Knowledge Base mostra:

• Numero totale di documenti nella KB.
• Stato di elaborazione di ciascun documento.
• Data dell'ultimo aggiornamento.
• Copertura per topic (quanti documenti KB per ogni categoria).

Come il Sistema Cerca nella KB

Quando l'assistente riceve una domanda, il processo di ricerca nella KB segue questi passaggi:

1. Analisi semantica: la domanda viene trasformata in un vettore semantico.
2. Ricerca ibrida: il sistema esegue sia una ricerca vettoriale (per significato) sia una ricerca testuale (per parole chiave esatte) sulla collezione KB.
3. Rilevanza e riordino: i risultati vengono valutati e riordinati in base alla pertinenza.
4. Integrazione: i risultati dalla KB vengono combinati con quelli dagli altri canali (documenti standard, documenti temporanei, sorgenti esterne).
5. Priorita KB: in caso di informazioni contrastanti, i dati dalla KB ricevono maggiore peso.

I badge verdi nelle risposte indicano che l'informazione proviene dalla Knowledge Base.

Best Practice

1. Seleziona con cura: non inserire nella KB tutto cio che viene caricato. La qualita della KB dipende dalla selezione attenta dei documenti autorevoli.
2. Mantieni aggiornata la KB: un documento obsoleto nella Knowledge Base e peggiore di un documento assente. Rivedi periodicamente i contenuti.
3. Organizza per topic: assegna i documenti KB ai topic pertinenti per facilitare ricerche mirate.
4. Usa fonti autorevoli: la KB dovrebbe contenere versioni definitive e approvate dei documenti, non bozze o documenti provvisori.
5. Verifica l'elaborazione: dopo l'inserimento, controlla che il documento sia nello stato "Pronto" e che i segmenti siano corretti.
6. Documenta le modifiche: quando sostituisci un documento nella KB, informa gli utenti interessati per evitare confusione su quale versione sia in vigore.
7. Non sovraccaricare: una KB con migliaia di documenti non curati perde efficacia. Meglio pochi documenti di qualita che molti documenti approssimativi.

---

Queria v3.1.0 -- Piattaforma di Document Intelligence