Conoscenza dell'agente (RAG)
Un agente può rispondere basandosi sui contenuti di una o più basi di conoscenza tramite RAG (recupero e generazione). Questa pagina descrive come collegare le basi all'agente, come orientare la riformulazione della domanda prima della ricerca, quanti passaggi delle basi entrano nella risposta e come consentire all'agente di cercare di nuovo nella conoscenza mentre risponde. Per una spiegazione generale del funzionamento vedere Come funziona il RAG.
Prerequisiti
- Un agente esistente e il permesso di modificarlo (vedere Creare e configurare un agente).
- Almeno una base di conoscenza creata e popolata (vedere Le basi di conoscenza).
Collegare le basi di conoscenza
Nella sezione Conoscenza della pagina dell'agente, l'area Basi di conoscenza elenca tutte le basi dell'organizzazione, ciascuna con una casella di selezione; il campo Cerca fra le basi di conoscenza restringe l'elenco. Un agente può attingere a più basi nella stessa risposta. Le basi selezionate compaiono anche come pulsanti sotto l'elenco, che aprono la pagina della base.
Il recupero dei contenuti segue la selezione: si attiva da solo quando si collega la prima base e si disattiva quando si rimuove l'ultima, senza un interruttore separato. Finché non è collegata alcuna base, la sezione mostra l'indicazione «Collega una base di conoscenza per configurare il recupero.». L'intestazione della sezione riporta il numero di basi collegate.
Istruzioni di riscrittura
Nelle conversazioni già avviate, la domanda dell'utente viene riformulata prima della ricerca in modo da risultare comprensibile da sola: un seguito come «e per il secondo modello?» diventa una richiesta completa. Il campo Istruzioni di riscrittura (opzionali), fino a 1000 caratteri, suggerisce come orientare questa riformulazione con indicazioni sul dominio, ad esempio cercando anche i sinonimi di un termine ricorrente («se l'utente chiede "prezzo" cerca anche "tariffa", "costo", "listino"»).
La riformulazione con il modello richiede che per l'organizzazione sia attiva la capacità Riscrittura Query RAG (vedere Capacità); senza questa capacità la domanda viene soltanto affiancata al messaggio precedente dell'utente.
Passaggi nel contesto
Il campo Passaggi nel contesto indica quanti passaggi della base di conoscenza entrano nel contesto di ogni risposta, con un valore da 1 a 20. Lasciando il campo vuoto vale l'impostazione dell'organizzazione.
Ricerca autonoma nella conoscenza
La ricerca nelle basi collegate avviene sempre prima della risposta. Con l'interruttore Ricerca autonoma nella conoscenza attivo, mentre risponde l'agente può inoltre cercare di nuovo nella conoscenza quando lo ritiene necessario: per verificare un dato prima di confermarlo, per le domande in più parti o per un riferimento preciso, come un numero, un codice o un nome. Queste ricerche seguono lo stesso percorso di quella iniziale, con il controllo di pertinenza, e i contenuti trovati si aggiungono alle fonti della risposta. Tempi e costi aumentano solo nelle risposte in cui l'agente cerca.
Con l'interruttore attivo compare Ricerche massime per risposta, da 1 a 5, che limita il numero di ricerche aggiuntive in una singola risposta; il valore proposto è 3.
Parametri di recupero
La soglia di pertinenza, il riordino dei risultati e il numero di contenuti recuperati da ciascuna ricerca non si impostano sull'agente: sono comuni a tutti gli agenti e descritti in Parametri avanzati del RAG. Sull'agente si regolano soltanto i Passaggi nel contesto e la Ricerca autonoma nella conoscenza; sulla qualità del recupero si interviene inoltre tramite la suddivisione in frammenti della base di conoscenza, le lingue dichiarate e i contenuti stessi.
Domande a cui le fonti non rispondono
Quando i contenuti trovati non sono pertinenti alla domanda, all'agente non viene fornito alcun contenuto della base di conoscenza e l'agente risponde seguendo le proprie istruzioni: conviene quindi indicare nelle istruzioni dell'agente come gestire le domande estranee al suo ambito. Se per l'organizzazione è attivo il controllo di ambito, con il passaggio a operatore acceso e la condizione Domanda fuori ambito abilitata l'agente risponde invece con il messaggio impostato nel blocco Messaggi di rifiuto (vedere Passaggio a operatore).
Risultato atteso
Le risposte generate a partire dalle basi collegate mostrano le fonti citate, verificabili anche nell'anteprima della pagina dell'agente (vedere Anteprima chat).
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| L'agente non cita mai fonti | Nessuna base collegata, oppure documenti non ancora indicizzati | Selezionare almeno una base nella sezione Conoscenza e verificare lo stato dei documenti |
| Le risposte non trovano fonti pertinenti pur avendo contenuti nelle basi | I contenuti recuperati non superano il controllo di pertinenza, ad esempio perché la prima lingua dichiarata dalla base, usata per l'indice testuale, non è quella dei contenuti | Verificare le lingue della base (vedere Parametri avanzati del RAG); provare la domanda nell'anteprima dell'agente e controllare le fonti restituite |
| L'agente risponde «non ho informazioni sufficienti» a domande coperte dalle basi | È attivo il controllo di ambito con la condizione Domanda fuori ambito | Verificare la condizione nella sezione Passaggio a operatore (vedere Passaggio a operatore) |
| Le domande di seguito («e per il secondo?») non trovano contenuti | Riformulazione con il modello non disponibile per l'organizzazione | Verificare la capacità Riscrittura Query RAG con l'amministratore |