Creare una Knowledge Base
Questa pagina descrive il form di creazione di una nuova Knowledge Base e le scelte da compiere prima di iniziare a caricare contenuti.
Prerequisiti
- Permesso di gestione Knowledge Base.
- Un'idea chiara di quali contenuti confluiranno nella Knowledge Base e in quali lingue sono scritti: alcune scelte non sono modificabili dopo la creazione.
Informazioni generali
- Nome e descrizione — identificano la Knowledge Base nell'elenco.
- Knowledge Base padre (facoltativa) — per organizzare gerarchicamente contenuti correlati, vedi Le Knowledge Base.
- Tipo — manuale, web, database o API: indica la sorgente principale prevista, senza impedire di aggiungerne altre in seguito.
Le lingue della KB
È possibile dichiarare più lingue (fino a 12). La prima lingua indicata è la lingua canonica: quando la domanda di un utente è scritta in una lingua diversa da tutte quelle dichiarate, viene tradotta automaticamente in quella canonica prima della ricerca (approfondimento in Parametri avanzati del RAG).
Il modello di embedding
Il modello di embedding si sceglie in fase di creazione e non può essere cambiato in seguito: modificarlo richiederebbe ricostruire da zero l'indicizzazione di tutti i contenuti. Il modello di default è adatto alla maggior parte degli usi; valutare un modello alternativo solo se richiesto da esigenze specifiche di lingua o di provider.
I modelli con dimensionalità più elevata (ad esempio alcuni modelli Mistral a 1.024 dimensioni) richiedono l'uso di Qdrant come vector store, anziché quello interno.
Vector store
- Interno (pgvector) — nessuna configurazione aggiuntiva, adatto alla maggior parte dei casi.
- Qdrant — istanza esterna dedicata: richiede URL, chiave API e nome della collection. Necessaria per i modelli di embedding ad alta dimensionalità.
Strategia di chunking
Ogni documento viene suddiviso in blocchi di testo prima di essere indicizzato. Le strategie disponibili sono Fisso, Ricorsivo, Semantico e Parent-Child, con parametri di dimensione e sovrapposizione regolabili.
Questa pagina copre solo la scelta iniziale. Per il significato di ciascuna strategia, i valori consigliati e gli scenari tipici, vedi Parametri avanzati del RAG.
Risultato atteso
La Knowledge Base compare nell'elenco in stato In attesa; passa a Pronta non appena vengono aggiunte le prime sorgenti e completata la loro indicizzazione. Da questo momento è selezionabile nella configurazione RAG di un agente.
Problemi comuni
| Problema | Causa | Soluzione |
|---|---|---|
| Non è possibile selezionare Qdrant come vector store | Non è stata configurata alcuna istanza Qdrant per il tenant | Richiedere la configurazione al supporto tecnico |
| Le domande in una lingua non dichiarata ottengono risposte poco pertinenti | La traduzione automatica della query non copre bene quel caso specifico | Aggiungere la lingua mancante tra quelle dichiarate della Knowledge Base |
| Il modello di embedding scelto non è più disponibile per una nuova sorgente | Il modello richiede una configurazione (ad es. Qdrant) non attiva | Verificare la configurazione del vector store richiesta dal modello |