Gestionali
Abacus
Dati dell’ERP Abacus (clienti, fornitori, indirizzi, documenti) via REST API in sola lettura.
- 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_entities | Entità disponibili nella REST API del mandante (dal documento $metadata). | Lettura |
query_entity | Legge un’entità con filtro OData, campi e ordinamento; restituisce una tabella (grafici ed export). | Lettura |
Configurazione passo per passo
In Kaiross apri Integrazioni, scegli Abacus e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.
- In Abacus (programma 12): crea un Service User per la REST API con accesso in sola lettura al mandante e alle entità necessarie.
- Genera Client ID e secret (flusso client credentials) e indica URL del server e numero di mandante.
- Se Abacus è on-premise, raggiungilo con un tunnel VPN.
- Entità comuni: Subjects, Addresses, Customers, Suppliers. Usa list_entities per l’elenco completo.
Campi del modulo: URL del server Abacus, Mandante, Client ID (Service User).
Da incollare (cifrato nel Vault, poi non più visibile): Client secret.
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
- Controlla token, password o chiave API: spesso manca un carattere o il token è scaduto. Creane uno nuovo e aggiorna la connessione.
- Permessi insufficienti
- All’account o al token mancano i permessi necessari: confrontali con la configurazione qui sopra (Guida e permessi consigliati nell’app) e, se serve, crea un token nuovo.
- Servizio non raggiungibile
- Controlla indirizzo, porta e firewall. Un server nella rete aziendale richiede un tunnel VPN; senza tunnel sono ammessi solo indirizzi pubblici.
- Troppe richieste
- Il servizio limita la frequenza delle chiamate: riprova tra qualche minuto.