Sorgente database
La sorgente database collega una Knowledge Base a una tabella o a una query su un database esterno, trasformando ogni riga restituita in un contenuto consultabile dall'agente.
Prerequisiti
- Una Knowledge Base già creata.
- Credenziali di accesso (host, porta, database, utente, password) a un database PostgreSQL, MySQL o SQL Server raggiungibile dalla piattaforma.
La configurazione richiede credenziali di accesso al database del cliente; è consigliato l'uso di un'utenza tecnica dedicata e in sola lettura, non un account applicativo condiviso.
Configurare la connessione
Nella scheda Database della Knowledge Base, inserire i parametri di connessione: tipo di database, host, porta, nome del database, utente e password.
Le credenziali sono cifrate a riposo nel database della piattaforma e non vengono mai mostrate in chiaro dopo il salvataggio.
Usare Test connessione per verificare che i parametri inseriti siano corretti prima di procedere.
Scrivere e verificare la query
Specificare una tabella o una query SQL personalizzata che definisce quali righe diventano contenuto della Knowledge Base. Il pulsante Anteprima mostra le prime 20 righe restituite, utile per verificare che la query produca il risultato atteso prima di eseguire la sincronizzazione completa.
Sincronizzazione manuale e pianificata
La prima sincronizzazione va avviata manualmente; le successive possono essere pianificate con una frequenza ricorrente, oppure eseguite di nuovo manualmente in qualsiasi momento. La cronologia delle sincronizzazioni resta consultabile nella scheda Database.
Come i dati diventano conoscenza
Ogni riga restituita dalla query viene convertita in un documento in formato tabellare, indicizzato come le altre sorgenti della Knowledge Base. Una modifica della query non aggiorna automaticamente i contenuti già indicizzati: è necessaria una nuova sincronizzazione.
Problemi comuni
| Problema | Causa | Soluzione |
|---|---|---|
| Il test di connessione non riesce | Credenziali errate o database non raggiungibile dalla rete della piattaforma | Verificare i parametri e l'eventuale necessità di autorizzare l'indirizzo della piattaforma sul firewall del database |
| L'anteprima non mostra righe | La query non restituisce risultati con i permessi dell'utenza configurata | Verificare i permessi dell'utenza tecnica sulla tabella o vista interrogata |
| I contenuti in Knowledge Base non riflettono l'ultima modifica dei dati | Non è stata eseguita una nuova sincronizzazione dopo la modifica | Avviare una sincronizzazione manuale o attendere la successiva pianificata |