Riferimento mail (anteprima)

Note

Le funzionalità in questo articolo sono alimentate dallo standard harness, che utilizza le opzioni di fatturazione descritte in Licensing per gli agenti alimentati dallo standard harness. Impara come accedere alle funzionalità standard negli agenti standard Access e nei flussi degli agenti.

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.

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_listaInviati

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: sovrascrittura facoltativa del messaggio
  • preferHtml: abilita la formattazione HTML
  • headers: intestazioni HTTP facoltative

mcp_StrumentiDiPosta_grafico_posta_rispondiATutti

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

Parametri obbligatori:

  • id: ID messaggio per 'rispondi a tutti'

Parametri facoltativi:

  • comment: testo della risposta
  • message: sovrascrittura facoltativa del messaggio
  • 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:

  • Richieste: Array di richieste di ricerca con entityTypesparametri di dimensione , query, from

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 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

Scrivere posta elettronica

  • 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à di 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.
  • Last updated on