E-mailreferentie (voorvertoning)

Note

Dit artikel beschrijft functies die worden gebruikt in agenten of agentstromen die gebruikmaken van het standard harness.

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.

Overzicht

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
• lichaam: Berichttekst met contentType (Tekst/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: Optioneel ETag voor gelijktijdigheidsbeheer

mcp_MailTools_graph_mail_getMessage

Hiermee wordt een bericht op basis van id opgehaald 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
• uitbreiden: OData-uitvouwclausule
• preferHtml: HTML-hoofdtekstindeling aanvragen
• Headers: Optionele HTTP-headers

mcp_MailTools_graph_mail_lijstVerzonden

Berichten weergeven in Verzonden items.

Optionele parameters:

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

mcp_MailTools_grafiek_mail_antwoord

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
• Bericht: Optionele berichtoverschrijvingen
• preferHtml: HTML-opmaak inschakelen
• Headers: Optionele HTTP-headers

mcp_MailTools_graph_mail_antwoordAllen

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
• Bericht: 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:

• Verzoeken: Matrix van zoekaanvragen met entityTypes, query, van, grootteparameters

Ondersteunt het zoeken van berichtinhoud, onderwerp, hoofdtekst en bijlagen

mcp_MailTools_graph_mail_sendDraft

Verzend een bestaand conceptbericht via ID.

Vereiste parameters:

• id: Conceptbericht-id om te verzenden

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
• lichaam: Hoofdtekst van e-mail met contentType (Tekst/HTML) en inhoud

Optionele parameters:

• ccRecipients: Ontvangers van koolstofkopie
• bccRecipients: Geadresseerden voor blinde kopie
• 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
• Ontvangers bij Aan, CC en BCC
• Uitgebreide opmaakopties

E-mailbeheer

• Berichten ophalen, bijwerken en verwijderen.
• Antwoord- en antwoordfunctionaliteit.
• Conceptbeheer.
• Instellingen voor categorie en prioriteit.

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.