Mailreferentie (preview)

Note

De functies in dit artikel worden aangedreven door de standaard kabelboom, die gebruikmaakt van de factureringsopties zoals beschreven in Licensing voor agenten die door de standaardkabelboom worden aangestuurd. Leer hoe je standaardfuncties kunt openen in Access standaard agents en agentstromen.

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.

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