Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Note
Cet article décrit les caractéristiques utilisées dans les agents ou flux d’agents alimentés par le faisceau standard.
Important
Il s’agit d’une fonctionnalité 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.
Aperçu
| 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 |
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
ETagpour le contrôle de simultanéité
mcp_MailTools_graph_mail_getMessage
Obtient un message par ID 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 : select clause OData
- expand : clause d'extension OData
- preferHtml : format du corps de la requête en HTML
- headers : en-têtes HTTP facultatifs
mcp_MailTools_graph_liste_mail_envoyés
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_OutilsCourrier_Graphique_RéponseCourrier
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 (répondre à tous)
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 carbone invisible
- 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 :
ETagpour le contrôle de la concurrence
Fonctionnalités clé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 à toutes les réponses.
- Brouillon de gestion.
- 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. -
preferHtmll’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.
-
ETagprise en charge du contrôle de concurrence pour les mises à jour.