Vai al contenuto
Kaiross

Integrazioni: collegare le applicazioni agli agenti

Email, documenti, CRM, gestionali, database e altri servizi diventano strumenti degli agenti. Ogni azione che modifica dati chiede la tua conferma in chat.

Ultimo aggiornamento:

Come funziona

  1. Apri Integrazioni, scegli il servizio e premi Nuova connessione.
  2. Compila il modulo seguendo Guida e permessi consigliati (la stessa guida è nella pagina di ogni integrazione, qui sotto). Le credenziali vengono cifrate nel Vault e non sono più visibili.
  3. Premi Prova connessione, poi Salva (o Salva e connetti per i servizi con accesso OAuth).
  4. Collega la connessione agli agenti dalla scheda MCP e database dell’agente.

Una connessione vive a livello di workspace: la crei una volta e la colleghi a più agenti. Ogni agente usa solo gli strumenti che abiliti.

Pagina Integrazioni con i connettori per categoria
Pagina Integrazioni con i connettori per categoria
La pagina Integrazioni: connettori del catalogo divisi per categoria.

Servizi con «Connetti» (OAuth)

Google, Microsoft 365, Slack, HubSpot, Salesforce, Dropbox, Box, bexio e Business Central usano l’accesso OAuth: registri un’app presso il fornitore, inserisci Client ID e Client secret in Kaiross e autorizzi con l’account da usare.

  1. Nel modulo della connessione copia l’Indirizzo di ritorno (Redirect URI) da registrare nell’app OAuth con l’icona Copia indirizzo di ritorno.
  2. Nella console del fornitore crea l’app e incolla quel Redirect URI (i passi esatti sono nella pagina di ogni integrazione).
  3. Torna in Kaiross, inserisci Client ID e Client secret e premi Salva e connetti: si apre la finestra del fornitore per autorizzare l’accesso.

Per Google usa una schermata di consenso di tipo Interno e per Microsoft un’app a tenant singolo: così possono autorizzare solo gli utenti della tua azienda.

Collegare un’integrazione a un agente

  1. Apri Agenti, scegli l’agente e vai alla scheda MCP e database (riquadro Strumenti dell’agente).
  2. In Aggiungi scegli Dal catalogo per una nuova connessione (il pulsante del modulo diventa Salva e collega), Collega un’integrazione esistente per una connessione già creata, oppure Server MCP esterno (vedi Server MCP esterni).
  3. In Strumenti abilitati lascia attivi solo gli strumenti utili all’agente. Le azioni hanno il badge azione.
  4. Premi Test sulla riga dello strumento, poi Prova in chat.

Azioni con conferma

Le scritture (inviare email, creare record, caricare file) sono spente di default: si attivano nella connessione con l’opzione «Consenti … (con conferma)». Quando l’agente vuole eseguirne una, la chat mostra una scheda Azione con il riepilogo e i pulsanti Conferma ed esegui e Annulla. Senza risposta, la richiesta scade dopo 30 minuti.

In Conferma delle azioni (scheda MCP e database) puoi togliere la conferma a singole azioni innocue. Nelle automazioni pubblicate le azioni non chiedono conferma: la pubblicazione vale come approvazione.

Se la prova di connessione non riesce

MessaggioCosa fare
Credenziali non valideControlla token, password o chiave API; se è scaduto creane uno nuovo.
Permessi insufficientiAggiungi gli scope indicati nella pagina dell’integrazione (e il consenso dell’amministratore, se richiesto).
Accesso scaduto / Account non collegatoPremi Connetti o Ricollega nella connessione.
Servizio non raggiungibileControlla indirizzo, porta, firewall o tunnel VPN.
Risorsa non trovataControlla indirizzo e identificativi (sito, database, sottodominio) nella configurazione.
Configurazione incompleta o non validaCompleta il campo indicato nel messaggio.

45 di 45 integrazioni

Email e calendario

Documenti

Collaborazione

Produttività

CRM e supporto

Gestionali

E-commerce e pagamenti

Messaggistica

Sviluppo

Database

Storage

Web