Strumenti email

Una casella di posta collegata è anche una famiglia di strumenti per l'agente, leggi, cerca, apri, invia, rispondi, contrassegna e sposta la posta. Tutti owner-only, e distinti dall'Email-come-canale.

La casella di posta che colleghi come canale Email ha una doppia superficie: oltre a rispondere alla posta in arrivo, mette a disposizione del tuo agente una famiglia di strumenti, leggere la posta in arrivo, cercare, aprire un messaggio, inviare, rispondere nel thread, contrassegnare come letto/non letto e spostare i messaggi. Ognuno di questi strumenti è owner-only. Ecco cosa può fare un agente interno con una casella di posta usata come strumenti.

Collega

Non c'è un passaggio di collegamento separato per gli strumenti email, collegare il canale Email è ciò che li attiva. La stessa riga della casella di posta alimenta entrambe le superfici.

Collega una casella di posta in Canali → Aggiungi canale → Email, accesso Gmail, oppure IMAP/SMTP per qualsiasi altro provider. I passaggi completi sono sulla pagina del canale Email.
Collega quella connessione a un agente interno, la dashboard o BotFather. Gli strumenti email appaiono solo per i chiamanti interni.
Parla con l'agente. Chiedigli di controllare la posta in arrivo, cercare un mittente o preparare una risposta.

Il dettaglio abilitante: questi strumenti sono owner-only, funzionano solo su superfici interne e mai per un visitatore del sito web, perché una casella di posta contiene posta privata. Un agente di web-chat pubblico non li vedrà nemmeno dopo che li hai collegati. E l'impostazione Sola lettura del canale è l'interruttore on/off della metà di scrittura: attivala e invia, rispondi, contrassegna e sposta scompaiono, lasciando solo gli strumenti di lettura.

Cosa può fare l'agente

Strumento	Accesso	Tipo	Cosa fa
`email_list_accounts`	Solo proprietario	Read	Elenca le caselle di posta collegate a questo agente con indirizzo, provider e stato, chiamalo per primo quando ne è collegata più di una per ottenere l'uid dell'account.
`email_read_inbox`	Solo proprietario	Read	Elenca i messaggi recenti di una cartella (predefinita INBOX) con oggetto, mittente, data e stato di lettura.
`email_search`	Solo proprietario	Read	Cerca in una cartella per parola chiave tra oggetto, mittente e corpo; restituisce i messaggi corrispondenti.
`email_get_message`	Solo proprietario	Read	Apre un messaggio dal suo id, oggetto completo, da/a/cc, data e testo del corpo.
`email_send`	Solo proprietario	Write	Invia una nuova email (testo semplice o HTML) con CC e BCC facoltativi, dall'indirizzo collegato.
`email_reply`	Solo proprietario	Write	Risponde a un messaggio nel thread, imposta gli header di threading e antepone 'Re:' all'oggetto.
`email_mark_read`	Solo proprietario	Write	Contrassegna un messaggio come letto o non letto.
`email_move`	Solo proprietario	Write	Sposta un messaggio in un'altra cartella o etichetta, Cestino, Archivio e simili.

Owner-only, e la separazione lettura/scrittura

Nessuno di questi è public-safe. Tutti e otto sono vincolati a un chiamante interno più la presenza del componente aggiuntivo email, e ogni chiamata è marcata come sensibile in modo da restare nascosta al flusso della chat. All'interno di questo, ci sono due livelli: i quattro strumenti di lettura (elenca account, leggi la posta in arrivo, cerca, apri messaggio) e i quattro strumenti di scrittura (invia, rispondi, contrassegna come letto, sposta). L'interruttore Sola lettura del canale rimuove i quattro di scrittura, una casella di posta in sola lettura permette all'agente di triage e citare la posta ma mai di agire su di essa.

Esempio pratico

Dici al tuo agente di supporto interno: "Controlla la mia posta in arrivo per qualsiasi cosa da Acme questa settimana, e se hanno chiesto della fattura, rispondi che è in arrivo." L'agente esegue email_search per Acme, email_get_message per leggere il thread, poi email_reply per rispondere nel thread con il tuo nome mittente e la tua firma, un solo round-trip, nessun cambio di contesto verso il tuo client di posta.

Limiti e onestà

Le scritture sono invii reali. email_send e email_reply recapitano a destinatari reali dal tuo indirizzo reale. Prova prima su un agente interno.
La sola lettura è la protezione. Con l'impostazione Sola lettura del canale attiva, gli strumenti di scrittura sono nascosti del tutto, l'agente può leggere ma mai inviare, contrassegnare o spostare.
Gli id sono opachi e dipendono dal provider. L'id di un messaggio è un numero per le caselle IMAP e una stringa per Gmail, restituisci sempre esattamente ciò che email_read_inbox o email_search hanno restituito; non tirare a indovinare.
Scegli la casella di posta quando ce n'è più di una. Con più caselle di posta collegate, chiama prima email_list_accounts e passa l'account_uid; con una singola casella viene scelta per te.

Risoluzione dei problemi

L'agente non vede gli strumenti email, probabilmente sei su un agente pubblico/di web-chat. La famiglia è owner-only; collega la casella di posta a un agente interno.
Le letture funzionano, l'invio viene rifiutato, la casella di posta è in modalità Sola lettura, oppure (per IMAP) la metà SMTP non è riuscita ad autenticarsi. Controlla entrambe.
"No email accounts connected", la casella di posta non è collegata a questo agente, oppure la connessione ha dato errore. Ricollega da Canali.

FAQ

È diverso dal canale Email? Stessa connessione, seconda superficie. Il canale risponde alla posta in arrivo; gli strumenti permettono a un agente interno di leggere e agire sull'intera casella di posta.

Un visitatore del sito web può leggere la mia posta in arrivo? Mai, tutti e otto gli strumenti sono owner-only e restano disattivati sugli agenti rivolti ai clienti.

Posso collegare più di una casella di posta? Sì, ognuna ha il proprio account_uid; elenca prima gli account, poi indirizzane una.

Prossimi passi

Canale Email, l'altra metà: posta in arrivo come conversazioni
Google Workspace, Drive, Docs, Calendar e Gmail
Abilità dell'agente, come gli strumenti si collegano a un agente
Panoramica delle integrazioni

In questa pagina