Référence mail (aperçu)

Note

Cet article décrit les caractéristiques utilisées dans les agents ou flux d’agents alimentés par le faisceau standard.

Important

Cette fonctionnalité est en version préliminaire.

• Microsoft publie des fonctionnalités en préversion avant leur publication officielle afin que les clients puissent y accéder en avant-première et faire part de leurs commentaires.
• Les fonctionnalités en préversion ont des fonctionnalités restreintes et ne sont pas destinées à une utilisation en production.
• Microsoft pourrait modifier les noms et les paramètres des outils MCP en préversion. Évitez les dépendances codées en dur. Microsoft gère la prise en charge des scénarios.
• Les fonctionnalités en préversion sont soumises à Microsoft conditions d’utilisation supplémentaires.

Note

Les outils MCP spécifiques à une application Microsoft 365 (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User et Word) sont uniquement destinés à des fins de rétrocompatibilité et ne doivent pas être utilisés dans les environnements de production ou les nouveaux projets. Pour les nouveaux projets nécessitant l’accès aux ressources Microsoft 365, utilisez Work IQ MCP avec le harnais GitHub Copilot. Pour plus d’informations, voir Work IQ MCP dans Copilot Studio.

Overview

ID du serveur	URL au niveau du locataire	Nom d'affichage	Description
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	Mail	Outils pour les opérations de courrier Microsoft Graph, incluant la création, l’envoi, la réponse et la gestion des messages électroniques.

Outils disponibles

mcp_MailTools_graph_mail_createMessage

Créer un brouillon de courrier électronique. Prend en charge le HTML en définissant body.body.contentType = "HTML".

Paramètres obligatoires :

• subject : objet du message
• toRecipients : tableau de destinataires avec des adresses e-mail
• body : corps du message avec contentType (Text/HTML) et contenu

Paramètres facultatifs :

• preferHtml : défini sur true pour le contenu HTML
• headers : en-têtes supplémentaires facultatifs

mcp_MailTools_graph_mail_deleteMessage

Supprime un message de la boîte aux lettres de l’utilisateur connecté.

Paramètres obligatoires :

• id: ID de Message

Paramètres facultatifs :

• If-Match : Optionnel ETag pour le contrôle de simultanéité

mcp_MailTools_graph_mail_getMessage

Obtient un message par ID à partir de la boîte aux lettres de l’utilisateur connecté. Utilisez preferHtml pour demander le corps HTML.

Paramètres obligatoires :

• id: ID de Message

Paramètres facultatifs :

• select : clause OData select
• expand : clause d'extension OData
• preferHtml : format du corps de la requête en HTML
• headers : en-têtes HTTP facultatifs

mcp_MailTools_graph_mail_listSent

Listez les messages dans les éléments envoyés.

Paramètres facultatifs :

• filter : filtre OData
• search : requête de recherche
• orderby : expression de tri
• top : nombre d’éléments à retourner
• select: champs à retourner

mcp_MailTools_graph_mail_reply

Envoyer une réponse à un message existant. Prend en charge le format HTML via preferHtml ou headers.

Paramètres obligatoires :

• id : ID du message auquel répondre

Paramètres facultatifs :

• comment : texte de réponse
• message : remplacements de message facultatifs
• preferHtml : activer la mise en forme HTML
• headers : en-têtes HTTP facultatifs

mcp_MailTools_graph_mail_replyAll

Envoyer une réponse à tous pour un message existant. Prend en charge le format HTML via preferHtml ou headers.

Paramètres obligatoires :

• id : ID du message auquel répondre à tous

Paramètres facultatifs :

• comment : texte de réponse
• message : remplacements de message facultatifs
• preferHtml : activer la mise en forme HTML
• headers : en-têtes HTTP facultatifs

mcp_MailTools_graph_mail_searchMessages

Recherchez des messages Outlook à l’aide de l'API de recherche Microsoft Graph avec des requêtes au style KQL (Keyword Query Language).

Paramètres obligatoires :

• Demandes : Tableau de requêtes de recherche avec entityTypes, requête, paramètres 'from' et 'size'

Permet de rechercher dans le contenu des messages, l’objet, le corps et les pièces jointes

mcp_MailTools_graph_mail_sendDraft

Envoyer un message brouillon existant par ID.

Paramètres obligatoires :

• id : ID du brouillon à envoyer

mcp_MailTools_graph_mail_sendMail

Envoyer un courrier électronique en tant qu’utilisateur connecté.

Paramètres obligatoires :

• Message : Objet de message avec le sujet, toRecipients, et le corps
• subject : objet de l’e-mail
• toRecipients : destinataires principaux
• corps du message : Corps du message avec type de contenu (Texte/HTML) et contenu

Paramètres facultatifs :

• ccRecipients : destinataires en copie carbone
• bccRecipients : destinataires en copie cachée
• saveToSentItems : Enregistrer dans les éléments envoyés (par défaut : true)
• preferHtml : forcer le rendu HTML
• headers : en-têtes HTTP supplémentaires facultatifs

10. mcp_MailTools_graph_mail_updateMessage

Met à jour les propriétés mutables d’un message, telles que l’objet, le corps et les catégories.

Paramètres obligatoires :

• id: ID de Message

Paramètres facultatifs :

• subject : nouvel objet
• body : nouveau corps du message
• categories : catégories de messages
• importance : Faible, Normal ou Élevée
• If-Match :ETag pour le contrôle de la concurrence

Principales fonctionnalités

Composition de l’e-mail

• Créer des brouillons et envoyer des e-mails
• Support HTML et texte brut
• Destinataires À, CC et CCI
• Options de mise en forme avancées

Gestion du courrier électronique

• Obtenir, mettre à jour et supprimer des messages.
• Fonctionnalité répondre et répondre à tous.
• Gestion des brouillons.
• Paramètres de catégorie et d’importance.

Recherche et filtrage

• Recherche de messages de type KQL.
• Prise en charge des requêtes OData.
• Effectuez une recherche dans l’objet, le corps du message et les pièces jointes.
• Pagination et filtrage.

Sentitems

• Répertorier les messages envoyés.
• Enregistrement facultatif dans les éléments envoyés.
• Filtrez et recherchez les éléments envoyés.

Remarques

• Toutes les opérations utilisent l’API Microsoft Graph Mail.
• Le contenu HTML nécessite contentType = "HTML" dans le corps.
• preferHtml l’en-tête indique un format HTML pour le corps du message.
• La recherche utilise l’API de recherche Microsoft Graph avec des requêtes KQL.
• Vous pouvez créer, mettre à jour et envoyer des brouillons séparément.
• Prise en charge ETag pour le contrôle de concurrence lors des mises à jour.