Sorgenti dati
Una sorgente dati collega una base di conoscenza a una tabella o a una query su un database esterno, trasformando ogni riga restituita in un contenuto consultabile dall'agente.
Prerequisiti
- Una base di conoscenza già creata.
- Credenziali di accesso (host, porta, database, utente, password) a un database raggiungibile dalla piattaforma.
Le sorgenti dati funzionano con i database PostgreSQL. Il form elenca anche MySQL e SQL Server, che al momento non sono disponibili: scegliendoli, la console mostra un messaggio che ne indica la non disponibilità. È consigliato l'uso di un'utenza tecnica dedicata e in sola lettura, non di un account applicativo condiviso.
Configurare la connessione
Ogni base di conoscenza può avere una sola connessione.
- Aprire la base di conoscenza e scegliere Aggiungi fonte > Sorgenti dati.
- Compilare i campi della connessione e indicare la tabella oppure la query.
- Fare clic su Testa connessione per verificare i parametri.
- Fare clic su Salva: la console apre la scheda Sorgenti dati. Il salvataggio richiede che il database sia raggiungibile dalla piattaforma: se non lo è, la connessione non viene salvata.
| Campo | Descrizione |
|---|---|
| Nome connessione | Nome con cui la connessione compare nella scheda |
| Tipo connessione | PostgreSQL. Le voci MySQL e SQL Server non sono al momento disponibili |
| Host e Porta | Indirizzo e porta del database (obbligatori) |
| Database | Nome del database (obbligatorio) |
| Schema | Schema da interrogare, predefinito public |
| Username e Password | Credenziali dell'utenza (username obbligatorio) |
| Tabella | Tabella da cui estrarre le righe |
| Query SQL | In alternativa alla tabella, una query personalizzata |
Le credenziali sono cifrate a riposo nel database della piattaforma e non vengono mai mostrate in chiaro dopo il salvataggio.
La query deve essere una sola istruzione SELECT, senza punto e virgola: istruzioni diverse o parole chiave non consentite vengono rifiutate con un messaggio che ne indica il motivo.
La scheda Sorgenti dati
La scheda Sorgenti dati è organizzata in sezioni. La sezione Connessioni mostra la connessione con tipo, host, porta, database e schema, la frequenza di aggiornamento ("aggiornamento manuale" se non è pianificato), lo stato e la data dell'Ultimo sync, insieme ai comandi:
| Comando | Effetto |
|---|---|
| Esegui sync | Avvia l'estrazione delle righe e la loro indicizzazione |
| Anteprima (icona a forma di occhio) | Mostra le righe restituite dalla query, senza indicizzarle |
| Modifica | Riapre il form della connessione; la password va reinserita solo se si vuole cambiarla |
| Elimina | Rimuove la sorgente dati, dopo una conferma |
Se la connessione usa una query, la sezione Query SQL ne riporta il testo.
Verificare la query con l'anteprima
Il comando Anteprima apre la sezione Anteprima, che mostra in tabella le prime 20 righe restituite e il loro numero: è utile per verificare che la query produca il risultato atteso prima di eseguire la sincronizzazione. La sezione si chiude con l'icona di chiusura.
Sincronizzazione e cronologia delle estrazioni
La sincronizzazione si avvia con Esegui sync e può essere ripetuta in qualsiasi momento. Quando per la connessione è impostato un aggiornamento periodico, la frequenza compare accanto alla connessione e nel riepilogo della scheda (ad esempio "ogni 60 min"); la console non offre un campo per impostarla.
La sezione Cronologia estrazioni elenca le sincronizzazioni più recenti, ciascuna con stato e data; per quelle completate riporta le righe estratte e i frammenti creati, per quelle non riuscite il messaggio di errore. L'icona Cancella storia estrazioni svuota l'elenco.
Come i dati diventano conoscenza
Ogni riga restituita dalla query viene convertita in un documento in formato tabellare, indicizzato come le altre fonti della base di conoscenza. 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 |
| Compare il messaggio che il supporto MySQL o SQL Server non è ancora disponibile | Il tipo di database scelto non è ancora supportato | Usare una connessione PostgreSQL |
| La query viene rifiutata | La query non è una singola istruzione SELECT oppure contiene parole chiave non consentite | Riscrivere la query come singola SELECT, senza punto e virgola |
| 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 non riflettono l'ultima modifica dei dati | Non è stata eseguita una nuova sincronizzazione dopo la modifica | Avviare Esegui sync |