Database
PostgreSQL
Interroga un database PostgreSQL in sola lettura (tabelle, colonne, query SELECT).
- Token o credenziali
- Sola lettura
- Anche via tunnel VPN
Strumenti per l’agente
L’agente sceglie da solo lo strumento adatto alla domanda. Nella scheda MCP e database dell’agente puoi disattivare quelli che non servono.
| Strumento | Cosa fa | Tipo |
|---|---|---|
list_tables | Elenca tabelle e viste (schema, nome, tipo). Usa "search" per filtrare per nome. | Lettura |
describe_table | Colonne di una tabella: nome, tipo, nullabilità, chiave primaria. | Lettura |
execute_query | Esegue una query SELECT in sola lettura (PostgreSQL) e restituisce al massimo 200 righe. | Lettura |
Configurazione passo per passo
In Kaiross apri Integrazioni, scegli PostgreSQL e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.
- Crea un ruolo dedicato:
CREATE ROLE kaiross LOGIN PASSWORD '…'; GRANT pg_read_all_data TO kaiross;(o GRANT SELECT sulle sole tabelle utili). - Se il database è nella rete del cliente usa un tunnel VPN (Impostazioni → Rete / VPN).
- Kaiross esegue solo SELECT: controllo della query, sessione READ ONLY, statement_timeout e limite di righe.
Campi del modulo: Host, Porta, Database, Utente, SSL, Righe massime per query, Timeout (ms).
Da incollare (cifrato nel Vault, poi non più visibile): Password.
Da sapere
- Se il servizio è nella rete della tua azienda, crea prima un tunnel in Impostazioni → Rete / VPN e nella connessione scegli Raggiungibile tramite → il tunnel. Vedi Database e gestionali.
Collegarla a un agente
- Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
- In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
- Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
- Premi Prova in chat e fai una domanda che richiede i dati del servizio.
Errori frequenti
- Credenziali non valide
- Il server non accetta utente o password della login: controllali con il DBA e aggiorna la connessione.
- Permessi insufficienti
- La login non può leggere tabelle o viste: falle assegnare i permessi di sola lettura come negli script della guida ai database.
- Servizio non raggiungibile
- Controlla indirizzo, porta e firewall. Un server nella rete aziendale richiede un tunnel VPN; senza tunnel sono ammessi solo indirizzi pubblici.
- Connessione cifrata non riuscita
- Il server non accetta la cifratura, la richiede o ha un certificato non attendibile: controlla SSL. Senza cifratura solo dentro un tunnel VPN.
- Database non trovato
- Il database indicato non esiste sul server: controlla il nome del database.