Riferimento e-mail (anteprima)

Note

Questo articolo descrive le caratteristiche utilizzate negli agenti o nei flussi di agenti alimentati dall'imbracatura standard.

Importante

Questa è una funzionalità di anteprima.

• Microsoft rilascia funzionalità di anteprima prima di una versione ufficiale, in modo che i clienti possano ottenere l'accesso anticipato e fornire commenti e suggerimenti.
• Le funzionalità di anteprima hanno funzionalità limitate e non sono destinate all'uso in produzione.
• Microsoft potrebbero modificare i nomi e i parametri degli strumenti MCP in anteprima. Evitare le dipendenze codificate in modo rigido. Microsoft supporta questo scenario.
• Le funzionalità di anteprima sono soggette a Microsoft condizioni supplementari per l'utilizzo.

Note

Gli strumenti MCP specifici per applicazioni Microsoft 365 (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User e Word) sono pensati solo per scopi di retrocompatibilità e non dovrebbero essere utilizzati in ambienti di produzione o nuovi progetti. Per nuovi progetti che richiedono accesso alle risorse di Microsoft 365, usa Work IQ MCP con il harness GitHub Copilot. Per maggiori informazioni, consulta Work IQ MCP in Copilot Studio.

Overview

ID del server	URL a livello di tenant	Nome visualizzato	Description
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	Mail	Strumenti per operazioni di posta Microsoft Graph, inclusi la creazione, l'invio, la risposta e la gestione dei messaggi email.

Strumenti disponibili

mcp_MailTools_graph_mail_createMessage

Crea una bozza di messaggio e-mail. Supporta l'HTML impostando body.body.contentType = "HTML".

Parametri obbligatori:

• subject: oggetto del messaggio
• toRecipients: matrice di destinatari con indirizzi e-mail
• body: corpo del messaggio con contentType (Testo/HTML) e contenuto

Parametri facoltativi:

• preferHtml: imposta su true per il contenuto HTML
• headers: intestazioni aggiuntive facoltative

mcp_MailTools_graph_mail_deleteMessage

Elimina un messaggio dalla cassetta postale dell'utente connesso.

Parametri obbligatori:

• id: ID messaggio

Parametri facoltativi:

• If-Match: Opzionale ETag per il controllo della concorrenza

mcp_MailTools_graph_mail_getMessage

Ottiene un messaggio in base all'ID dalla cassetta postale dell'utente connesso. Usare preferHtml per richiedere il corpo di HTML.

Parametri obbligatori:

• id: ID messaggio

Parametri facoltativi:

• select: clausola di selezione OData
• expand: clausola di espansione OData
• preferHtml: formato del corpo HTML della richiesta
• headers: intestazioni HTTP facoltative

mcp_MailTools_graph_mail_listSent

Elenca i messaggi negli elementi inviati.

Parametri facoltativi:

• filter: filtro OData
• search: query di ricerca
• orderby: espressione di ordinamento
• top: numero di elementi da restituire
• select: campi da restituire

mcp_MailTools_graph_mail_reply

Invia una risposta a un messaggio esistente. Supporta HTML tramite preferHtml o headers.

Parametri obbligatori:

• id: ID messaggio a cui rispondere

Parametri facoltativi:

• comment: testo della risposta
• message: sostituzione facoltativa dei messaggi
• preferHtml: abilita la formattazione HTML
• headers: intestazioni HTTP facoltative

mcp_MailTools_graph_mail_replyAll

Invia una risposta a tutti a un messaggio esistente. Supporta HTML tramite preferHtml o headers.

Parametri obbligatori:

• id: ID messaggio a cui rispondere a tutti

Parametri facoltativi:

• comment: testo della risposta
• message: sostituzione facoltativa dei messaggi
• preferHtml: abilita la formattazione HTML
• headers: intestazioni HTTP facoltative

mcp_MailTools_graph_mail_searchMessages

Eseguire ricerche nei messaggi di Outlook usando l'API di ricerca di Microsoft Graph con query nello stile di Keyword Query Language (KQL).

Parametri obbligatori:

• requests: matrice di richieste di ricerca con entityTypes, query, from, size parameters

Supporta la ricerca di contenuto, oggetto, corpo e allegati dei messaggi

mcp_MailTools_graph_mail_sendDraft

Invia una bozza di messaggio esistente tramite ID.

Parametri obbligatori:

• id: ID della bozza del messaggio da inviare

mcp_MailTools_graph_mail_sendMail

Invia un messaggio di posta elettronica come utente connesso.

Parametri obbligatori:

• Messaggio: Messaggio con oggetto, toRecipients, e corpo
• subject: Oggetto del messaggio e-mail
• toRecipients: destinatari principali
• body: corpo dell'e-mail con contentType (Testo/HTML) e contenuto

Parametri facoltativi:

• ccRecipients: destinatari in copia per conoscenza
• bccRecipients: destinatari in copia per conoscenza nascosta
• saveToSentItems: Salva sugli oggetti inviati (predefinito: vero)
• preferHtml: forza il rendering HTML
• headers: intestazioni HTTP aggiuntive facoltative

10. mcp_MailTools_graph_mail_updateMessage

Aggiorna le proprietà modificabili di un messaggio, ad esempio l'oggetto, il corpo e le categorie.

Parametri obbligatori:

• id: ID messaggio

Parametri facoltativi:

• subject: nuovo oggetto
• body: nuovo corpo del messaggio
• categorie: categorie di messaggi
• importance: Bassa, Normale o Alta
• If-Match:ETag per il controllo della concorrenza

Funzionalità principali

Composizione e-mail

• Creare bozze e inviare messaggi di posta elettronica
• Supporto HTML e testo normale
• Destinatari A, CC e CCn
• Opzioni di formattazione avanzata

Gestione e-mail

• Ottenere, aggiornare ed eliminare messaggi.
• Funzionalità Rispondi e Rispondi a tutti.
• Gestione delle bozze
• Impostazioni di categoria e importanza.

Ricerca e filtro

• Ricerca di messaggi in stile KQL.
• Supporto delle query OData.
• Cerca nell'oggetto, nel corpo e negli allegati.
• Impaginazione e filtro.

Sentitems

• Elencare i messaggi inviati.
• Salvataggio facoltativo per gli elementi inviati.
• Filtrare e cercare gli elementi inviati.

Note

• Tutte le operazioni utilizzano l'API di posta di Microsoft Graph.
• Il contenuto HTML richiede contentType = "HTML" nel corpo.
• preferHtml l'intestazione richiede il formato HTML per il corpo del messaggio.
• La ricerca usa l'API di ricerca di Microsoft Graph con query KQL.
• I messaggi bozza possono essere creati, aggiornati e inviati separatamente.
• ETag supporta il controllo della concorrenza negli aggiornamenti.