Email e calendario
Email (IMAP/SMTP)
Cerca e legge la posta via IMAP, invia email via SMTP (con conferma).
- Token o credenziali
- Azioni con conferma
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_folders | Elenca le cartelle della casella (Posta in arrivo, Inviata, …). | Lettura |
search_emails | Cerca email in una cartella (mittente, oggetto, testo, data, non lette). Restituisce le più recenti prima. | Lettura |
read_email | Legge un’email trovata con la ricerca: intestazioni, testo e nomi degli allegati. | Lettura |
send_email | Invia un’email. Richiede la conferma dell’utente, che vede destinatari, oggetto e testo. | Con conferma |
Configurazione passo per passo
In Kaiross apri Integrazioni, scegli Email (IMAP/SMTP) e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.
- Usa una casella dedicata o una "password per app" (Gmail, Microsoft 365 con MFA): mai la password personale.
- IMAP (porta 993, TLS) per leggere, SMTP (587 STARTTLS o 465 TLS) per inviare. Puoi configurarne uno solo.
- Ogni invio mostra in chat destinatari, oggetto e testo e parte solo dopo la tua conferma.
- Per Microsoft 365 è preferibile il connettore «Outlook Mail», con l’accesso tramite «Connetti». Per Gmail usa una password per app (Account Google → Sicurezza → Password per le app).
Campi del modulo: Utente (di solito l’indirizzo email), Server IMAP, Porta IMAP, Server SMTP, Porta SMTP, Mittente, Nome mittente.
Da incollare (cifrato nel Vault, poi non più visibile): Password o password per app.
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.
- Troppe richieste
- Il servizio limita la frequenza delle chiamate: riprova tra qualche minuto.