E-mailreferentie (voorvertoning)

Note

In dit artikel worden functies beschreven die worden gebruikt in agents of agentstromen die mogelijk worden gemaakt met het standaardharnas.

Important

Dit is een preview-functie.

• Microsoft brengt previewfuncties uit vóór een officiële release, zodat klanten vroegtijdig toegang kunnen krijgen en feedback kunnen geven.
• Preview-functies hebben beperkte functionaliteit en zijn niet bedoeld voor productiegebruik.
• Microsoft kan de namen en parameters van het MCP-hulpprogramma preview wijzigen. Vermijd in code vastgelegde afhankelijkheden. Microsoft ondersteuning voor scenario's onderhoudt.
• Preview-functies zijn onderhevig aan Microsoft aanvullende gebruiksvoorwaarden.

Note

Applicatiespecifieke Microsoft 365 MCP-tools (Copilot, Agenda, Mail, SharePoint, OneDrive, Teams, Gebruiker en Word) zijn uitsluitend bedoeld voor achterwaartse compatibiliteit en mogen niet worden gebruikt in productieomgevingen of nieuwe projecten. Voor nieuwe projecten die toegang tot Microsoft 365-bronnen vereisen, gebruik Work IQ MCP met de GitHub Copilot-kabelboom. Voor meer informatie, zie Work IQ MCP in Copilot Studio.

Overview

Server-id	URL op tenantniveau	weergavenaam	Description
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	E-mail	Tools voor Microsoft Graph mailoperaties, waaronder het aanmaken, verzenden, beantwoorden en beheren van e-mailberichten.

Beschikbare hulpmiddelen

mcp_MailTools_graph_mail_createMessage

Maak een concept-e-mail. Ondersteunt HTML door instelling body.body.contentType = "HTML".

Vereiste parameters:

• Onderwerp: Berichtonderwerp
• toRecipients: Matrix van geadresseerden met e-mailadressen
• body: berichttekst met contentType (text/html) en inhoud

Optionele parameters:

• preferHtml: Instellen op true voor HTML-inhoud
• Headers: Optionele extra headers

mcp_MailTools_graph_mail_deleteMessage

Hiermee verwijdert u een bericht uit het postvak van de aangemelde gebruiker.

Vereiste parameters:

• id: Bericht-ID

Optionele parameters:

• if-Match: optionele ETag voor gelijktijdigheidsbeheer

mcp_MailTools_graph_mail_getMessage

Haalt een bericht op basis van de id op uit het postvak van de aangemelde gebruiker. Gebruiken preferHtml om HTML-hoofdtekst aan te vragen.

Vereiste parameters:

• id: Bericht-ID

Optionele parameters:

• selecteren: OData select-clausule
• expand: expand-component voor OData
• preferHtml: HTML-hoofdtekstindeling aanvragen
• Headers: Optionele HTTP-headers

mcp_MailTools_graph_mail_listSent

Berichten in Verzonden items weergeven.

Optionele parameters:

• filter: OData-filter
• zoeken: Zoekopdracht
• orderby: Sorteerexpressie
• Boven: Aantal te retourneren items
• selecteren: Velden die geretourneerd moeten worden

mcp_MailTools_graph_mail_reply

Een antwoord verzenden naar een bestaand bericht. Ondersteunt HTML via preferHtml of headers.

Vereiste parameters:

• id: Bericht-ID om op te antwoorden

Optionele parameters:

• commentaar: Antwoordtekst
• message: optionele berichtoverschrijvingen
• preferHtml: HTML-opmaak inschakelen
• Headers: Optionele HTTP-headers

mcp_MailTools_graph_mail_replyAll

Een antwoord sturen naar een bestaand bericht. Ondersteunt HTML via preferHtml of headers.

Vereiste parameters:

• id: bericht-id om allen te beantwoorden

Optionele parameters:

• commentaar: Antwoordtekst
• message: optionele berichtoverschrijvingen
• preferHtml: HTML-opmaak inschakelen
• Headers: Optionele HTTP-headers

mcp_MailTools_graph_mail_searchMessages

Zoek Outlook-berichten met de Microsoft Graph Search API met zoekopdrachten in de stijl van Keyword Query Language (KQL).

Vereiste parameters:

• requests: matrix van zoekaanvragen met de parameters entityTypes, query, from en size

Ondersteunt het zoeken van berichtinhoud, onderwerp, hoofdtekst en bijlagen

mcp_MailTools_graph_mail_sendDraft

Verzend een bestaand conceptbericht via ID.

Vereiste parameters:

• id: id van conceptbericht dat moet worden verzonden

mcp_MailTools_graph_mail_sendMail

Een e-mailbericht verzenden als de aangemelde gebruiker.

Vereiste parameters:

• Bericht: Berichtobject met onderwerp, toRecipientsen hoofdtekst
• Onderwerp: E-mailonderwerp
• toRecipients: Primaire geadresseerden
• body: hoofdtekst van e-mail met contentType (text/html) en inhoud

Optionele parameters:

• ccRecipients: CC-ontvangers
• bccRecipients: BCC-ontvangers
• saveToSentItems: Opslaan in verzonden items (standaard: true)
• preferHtml: HTML-rendering afdwingen
• Headers: Optionele extra HTTP-headers

10. mcp_MailTools_graph_mail_updateMessage

Hiermee worden de onveranderbare eigenschappen van een bericht bijgewerkt, zoals het onderwerp, de hoofdtekst en de categorieën.

Vereiste parameters:

• id: Bericht-ID

Optionele parameters:

• Onderwerp: Nieuw onderwerp
• lichaam: Nieuwe berichttekst
• Categorieën: Berichtcategorieën
• belang: Laag, Normaal of Hoog
• If-Match:ETag voor gelijktijdigheidsbeheer

Belangrijkste kenmerken

E-mailsamenstelling

• Concepten maken en e-mailberichten verzenden
• Ondersteuning voor HTML en tekst zonder opmaak
• Geadresseerden in Aan, CC en BCC
• RTF-opties

E-mailbeheer

• Berichten ophalen, bijwerken en verwijderen.
• Functionaliteit voor beantwoorden en allen beantwoorden.
• Conceptbeheer.
• Instellingen voor categorieën en urgentie.

Zoeken en filteren

• Berichten zoeken in KQL-stijl.
• Ondersteuning voor OData-query's.
• Zoeken naar onderwerpen, hoofdteksten en bijlagen.
• Paginering en filteren.

Sentitems

• Verzonden berichten weergeven.
• Optioneel opslaan voor verzonden items.
• Verzonden items filteren en zoeken.

Aantekeningen

• Alle bewerkingen maken gebruik van Microsoft Graph Mail-API.
• HTML-inhoud vereist contentType = "HTML" in de hoofdtekst.
• preferHtml header vraagt om HTML-indeling voor de berichttekst.
• Search maakt gebruik van Microsoft Graph Search-API met KQL-query's.
• Conceptberichten kunnen afzonderlijk worden gemaakt, bijgewerkt en verzonden.
• ETag ondersteuning voor gelijktijdigheidsbeheer voor updates.