Collegare le Knowledge Base (RAG)
Un agente può rispondere basandosi sui contenuti di una o più Knowledge Base tramite RAG (recupero e generazione): questa pagina descrive come collegarle e come impostare i preset di recupero. Per una spiegazione di come funziona il RAG in generale vedere Come funziona il RAG.
Prerequisiti
- Un agente esistente (vedere Creare un agente).
- Almeno una Knowledge Base già creata e popolata (vedere Le Knowledge Base).
Collegare le Knowledge Base
Nella sezione Knowledge Base e RAG del dettaglio agente:
- Knowledge Base associate — selezione multipla; un agente può attingere a più KB contemporaneamente nella stessa risposta;
- Abilita RAG — toggle che attiva il recupero dei contenuti; se disattivato, l'agente risponde solo in base al system prompt, senza consultare le KB collegate.
I preset di comprensione della query
Il preset Comprensione della query determina quanto lavoro extra viene svolto per interpretare la domanda dell'utente prima di interrogare le KB:
| Preset | Comportamento |
|---|---|
| Veloce | Nessuna riscrittura della query; ricerca diretta, latenza minima |
| Bilanciata | Riscrittura semplice della query per migliorare il recupero |
| Approfondita | Espansione multi-query con fusione dei risultati, correzione automatica in caso di primo recupero poco pertinente |
| Personalizzata | Consente di impostare manualmente ciascuna opzione avanzata |
Parametri di recupero
I parametri principali visibili in questa sezione sono Top-K, soglia di score minimo, ricerca ibrida e reranking. I valori di default, gli esempi numerici e i casi d'uso per ciascun parametro sono descritti in Parametri avanzati del RAG.
Il reranking è disponibile solo se il feature flag "RAG avanzato" è attivo per il tenant.
Messaggio in assenza di fonti pertinenti
È possibile impostare un testo fisso da mostrare quando nessuna fonte supera la soglia di pertinenza configurata, invece di lasciare che il modello generi una risposta senza fonti. Lasciare il campo vuoto se si preferisce una risposta generata liberamente dal modello anche in assenza di fonti.
Risultato atteso
Nelle conversazioni con l'agente, le risposte generate a partire dai contenuti delle KB collegate mostrano le fonti citate (vedere La console Chat).
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| L'agente non cita mai fonti | RAG disattivato, oppure nessuna KB collegata | Verificare il toggle Abilita RAG e la selezione delle KB |
| Le risposte non trovano fonti pertinenti pur avendo contenuti in KB | Soglia di score troppo alta, oppure lingua della query non allineata alla KB | Abbassare la soglia in Parametri avanzati del RAG, verificare le lingue configurate sulla KB |
| Risposte lente | Preset "Approfondita" su una KB molto grande | Passare a "Bilanciata" se la latenza è prioritaria rispetto alla profondità del recupero |