Vai al contenuto
Kaiross

Database

SQL Server

Interroga un database Microsoft SQL Server 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.

StrumentoCosa faTipo
list_tables Elenca tabelle e viste (schema, nome, tipo). I gestionali hanno migliaia di tabelle: usa "search" con una parte del nome (es. "Cust", "Item", "SaleDoc", "Fatt") per trovare quelle pertinenti. Lettura
describe_table Colonne di una tabella: nome, tipo, nullabilità, chiave primaria. Lettura
execute_query Esegue una query SELECT in sola lettura (T-SQL) e restituisce al massimo 200 righe. Lettura

Configurazione passo per passo

In Kaiross apri Integrazioni, scegli SQL Server e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.

  1. Crea una login SQL dedicata: CREATE LOGIN kaiross WITH PASSWORD = '…'.
  2. Nel database: CREATE USER kaiross FOR LOGIN kaiross; ALTER ROLE db_datareader ADD MEMBER kaiross;
  3. Se il server è nella rete del cliente, collega prima un tunnel in Impostazioni → Rete / VPN.
  4. Kaiross esegue solo SELECT (controllo della query + permessi della login), con timeout e limite di righe.

Campi del modulo: Host, Porta, Nome server (TLS), Istanza (opzionale), Database, Utente, Connessione cifrata (TLS), Accetta certificato self-signed, 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

  1. Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
  2. In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
  3. Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
  4. 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 Connessione cifrata (TLS), Accetta certificato self-signed. Senza cifratura solo dentro un tunnel VPN.
Database non trovato
Il database indicato non esiste sul server: controlla il nome del database.

Altre integrazioni della categoria Database

Tutte le integrazioni