Postreferanse (forhåndsvisning)

Bemerkning

Funksjonene i denne artikkelen drives av standardledningsnettet, som bruker faktureringsalternativene beskrevet i Lisensiering for agenter drevet av standardledningsnettet. Lær hvordan du får tilgang til standardfunksjoner i Access standardagenter og agentflyter.

Important

Dette er en forhåndsvisningsfunksjon.

  • Microsoft utgir forhåndsvisningsfunksjoner før en offisiell utgivelse, slik at kundene kan få tidlig tilgang og gi tilbakemelding.
  • Forhåndsvisningsfunksjoner har begrenset funksjonalitet og er ikke ment for produksjonsbruk.
  • Microsoft kan endre mcp-verktøynavn og parametere for forhåndsvisning. Unngå hardkodede avhengigheter. Microsoft opprettholder scenariostøtte.
  • Forhåndsvisningsfunksjoner er underlagt Microsoft ekstra vilkår for bruk.

Oversikt

Server-ID URL på leiernivå Visningsnavn Beskrivelse
mcp_MailTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_MailTools
Post Verktøy for Microsoft Graph e-postoperasjoner, inkludert opprettelse, sending, svar på og håndtering av e-postmeldinger.

Tilgjengelige verktøy

mcp_MailTools_graph_mail_createMessage

Opprett en e-postmelding. Støtter HTML ved å angi body.body.contentType = "HTML".

Obligatoriske parametere:

  • tema: Meldingsemne
  • toRecipients: Matrise av mottakere med e-postadresser
  • kropp: Meldingstekst med contentType (Tekst/HTML) og innhold

Valgfrie parametere:

  • preferHtml: Angi sann for HTML-innhold
  • Topptekst: Valgfrie tilleggsoverskrifter

mcp_MailTools_graph_mail_deleteMessage

Sletter en melding fra den påloggede brukerens postboks.

Obligatoriske parametere:

  • Id: Meldings-ID

Valgfrie parametere:

  • If-Match: Valgfri ETag for samtidig tilgangskontroll

mcp_MailTools_graph_mail_getMessage

Får en melding via ID fra den påloggede brukerens postboks. Bruk preferHtml for å be om HTML-innhold.

Obligatoriske parametere:

  • Id: Meldings-ID

Valgfrie parametere:

  • velge: OData select-setningsdel
  • utvide: Utvid OData-setningsdel
  • preferHtml: Be om HTML-brødtekstformat
  • Topptekst: Valgfrie HTTP-overskrifter

mcp_MailTools_graph_mail_listSent

Vis meldinger i sendte elementer.

Valgfrie parametere:

  • filter: OData-filter
  • søke: Søkespørring
  • orderby: Sorteringsuttrykk
  • topp: Antall elementer som skal returneres
  • velge: Felt som skal returneres

mcp_MailTools_graph_mail_reply

Send et svar til en eksisterende melding. Støtter HTML via preferHtml eller headers.

Obligatoriske parametere:

  • Id: Meldings-ID som du vil svare på

Valgfrie parametere:

  • kommentar: Svartekst
  • budskap: Valgfrie meldingsoverstyringer
  • preferHtml: Aktiver HTML-formatering
  • Topptekst: Valgfrie HTTP-overskrifter

mcp_MailTools_graph_mail_svarAlle

Send et svar til en eksisterende melding. Støtter HTML via preferHtml eller headers.

Obligatoriske parametere:

  • Id: Meldings-ID til svar til

Valgfrie parametere:

  • kommentar: Svartekst
  • budskap: Valgfrie meldingsoverstyringer
  • preferHtml: Aktiver HTML-formatering
  • Topptekst: Valgfrie HTTP-overskrifter

mcp_MailTools_graph_mail_searchMessages

Søk Outlook meldinger ved hjelp av Microsoft Graph Søke-API med KQL-stilspørringer (KeyWord Query Language).

Obligatoriske parametere:

  • Forespørsler: Matrise med søkeforespørsler med entityTypes, spørring, fra, størrelsesparametere

Støtter søk i meldingsinnhold, emne, brødtekst og vedlegg

mcp_MailTools_graph_mail_sendDraft

Send en eksisterende kladdemelding med ID.

Obligatoriske parametere:

  • Id: Kladdemeldings-ID som skal sendes

mcp_MailTools_graph_mail_sendMail

Send en e-postmelding som den påloggede brukeren.

Obligatoriske parametere:

  • Melding: Meldingsobjekt med emne, toRecipientsog brødtekst
  • emne: E-postemne
  • toRecipients: Primære mottakere
  • Brødtekst: Brødtekst i e-post med contentType (Tekst/HTML) og innhold

Valgfrie parametere:

  • ccRecipients: Kopimottakere
  • blindkopier: Blindkopimottakere
  • saveToSentItems: Lagre til sendte elementer (standard: sann)
  • preferHtml: Tving HTML-gjengivelse
  • Topptekst: Valgfrie flere HTTP-overskrifter

10. mcp_MailTools_graph_mail_updateMessage

Oppdaterer egenskapene til en melding som kan dempes, for eksempel emne, brødtekst og kategorier.

Obligatoriske parametere:

  • Id: Meldings-ID

Valgfrie parametere:

  • tema: Nytt emne
  • kropp: Brødtekst for ny melding
  • Kategorier: Meldingskategorier
  • viktighet: Lav, normal eller høy
  • If-Match:ETag for kontroll av samtidighet

Viktige funksjoner

E-postsammensetning

  • Opprette kladder og sende e-postmeldinger
  • Støtte for HTML og ren tekst
  • Til-, KOPI- og BLINDKOPI-mottakere
  • Rike formateringsalternativer

E-postbehandling

  • Få, oppdater og slett meldinger.
  • Svar- og svarfunksjonalitet.
  • Administrasjon av utkast
  • Innstillinger for kategori og viktighet.

Søk og filtrering

  • Meldingssøk i KQL-stil.
  • Støtte for OData-spørring.
  • Søk på tvers av emne, brødtekst og vedlegg.
  • Paginering og filtrering.

Sentitems

  • Liste over sendte meldinger.
  • Valgfritt lagring til sendte elementer.
  • Filtrer og søk i sendte elementer.

Merknader

  • Alle operasjoner bruker Microsoft Graph e-post-API.
  • HTML-innhold krever contentType = "HTML" i brødteksten.
  • preferHtml toppteksten forespør HTML-format for brødteksten.
  • Søk bruker Microsoft Graph Søke-API med KQL-spørringer.
  • Kladdemeldinger kan opprettes, oppdateres og sendes separat.
  • ETag støtte for samtidighetskontroll på oppdateringer.