Sähköpostiviittaus (ennakko)

Huomautus

Tämän artikkelin ominaisuudet perustuvat standardivaljaisiin, jotka käyttävät Lisensointi-osiossa kuvattuja laskutusvaihtoehtoja agenteille, jotka käyttävät standardivaljasta. Opi, miten pääset käsiksi standardeihin liittyviin ominaisuuksiin Accessin standardiagenteissa ja agenttivirroissa.

Important

Tämä on esiversiotoiminto.

  • Microsoft julkaisee esiversio-ominaisuuksia ennen virallista julkaisua, jotta asiakkaat voivat käyttää ja antaa palautetta ennen virallista julkaisua.
  • Esikatselutoiminnot toimivat rajoitetusti, eikä niitä ole tarkoitettu tuotantokäyttöön.
  • Microsoft saattavat muuttaa esikatselun MCP-työkalujen nimiä ja parametreja. Vältä kovakoodattuja riippuvuuksia. Microsoft ylläpitää skenaariotukea.
  • Esikatselutoimintoihin sovelletaan Microsoft lisäkäyttöehtoja.

Yleiskatsaus

Palvelintunnus Vuokraajatason URL-osoite Näyttönimi Kuvaus
mcp_MailTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_MailTools
Sähköposti Työkaluja Microsoft Graph -sähköpostitoimintoihin, mukaan lukien sähköpostiviestien luominen, lähettäminen, vastaaminen ja hallinta.

Käytettävissä olevat työkalut

mcp_MailTools_graph_mail_createMessage

Luo luonnossähköposti. Tukee HTML:ää asetuksella body.body.contentType = "HTML".

Pakolliset parametrit:

  • aihe: Viestin aihe
  • toRecipients: Vastaanottajien matriisi, joissa on sähköpostiosoitteet
  • keho: Viestin teksti, jossa on contentType (Teksti/HTML) ja sisältöä

Valinnaiset parametrit:

  • preferHtml: MÄÄRITÄ HTML-sisällön arvoksi tosi
  • Otsikot: Valinnaiset lisäotsikot

mcp_MailTools_graph_mail_deleteMessage (poistaViesti)

Poistaa viestin kirjautuneen käyttäjän postilaatikosta.

Pakolliset parametrit:

  • henkilöllisyystodistus: Viestin tunnus

Valinnaiset parametrit:

  • If-Match: Valinnainen ETag samanaikaisuuden hallintaan

mcp_MailTools_graph_mail_getMessage

Hakee viestin tunnuksen perusteella sisäänkirjautuneen käyttäjän postilaatikosta. Käytä preferHtml pyytääksesi HTML-rungon.

Pakolliset parametrit:

  • henkilöllisyystodistus: Viestin tunnus

Valinnaiset parametrit:

  • valikoida: OData-valintalauseke
  • laajentaa: OData-laajennuslauseke
  • preferHtml: Pyydä HTML-leipätekstimuotoa
  • Otsikot: Valinnaiset HTTP-otsikot

mcp_MailTools_grafiikka_sähköposti_luetteloLähetetty

Luettele viestit lähetetyissä kohteissa.

Valinnaiset parametrit:

  • suodatin: OData-suodatin
  • etsiä: Hakukysely
  • orderby: Lajittelulauseke
  • huippu: Palautettavien kohteiden määrä
  • valikoida: Palautettavat kentät

mcp_MailTools_graph_mail_reply

Lähetä vastaus aiemmin luotuun viestiin. HTML:ää tuetaan preferHtml:n tai headers:n kautta.

Pakolliset parametrit:

  • henkilöllisyystodistus: Viestitunnus, johon vastataan

Valinnaiset parametrit:

  • kommentti: Vastaa tekstiin
  • viesti: Valinnainen viesti syrjäyttää
  • preferHtml: HTML-muotoilun ottaminen käyttöön
  • Otsikot: Valinnaiset HTTP-otsikot

mcp_MailTools_graph_mail_vastaaKaikille

Lähetä vastaus kaikkiin aiemmin luotuun viestiin. HTML:ää tuetaan preferHtml:n tai headers:n kautta.

Pakolliset parametrit:

  • viesti-ID: Viestin tunniste, johon vastataan kaikille

Valinnaiset parametrit:

  • kommentti: Vastaa tekstiin
  • viesti: Valinnainen viesti syrjäyttää
  • preferHtml: HTML-muotoilun ottaminen käyttöön
  • Otsikot: Valinnaiset HTTP-otsikot

mcp_MailTools_graph_mail_searchMessages

Hae Outlook viesteistä käyttämällä Microsoft Graph haun ohjelmointirajapintaa avainsanakyselykielen (KQL) tyylikyselyillä.

Pakolliset parametrit:

  • Pyyntöjä: Hakupyyntöjen matriisi, jossa on entityTypes, kysely, kohteesta, kokoparametreja

Tukee viestin sisällön, aiheen, leipätekstin ja liitteiden hakua

mcp_Sähköpostityökalut_graafi_sähköposti_lähetäLuonnos

Lähetä olemassa oleva luonnossanoma tunnuksen perusteella.

Pakolliset parametrit:

  • henkilöllisyystodistus: Lähetettävän luonnosviestin tunnus

mcp_MailTools_graph_mail_sendMail

Lähetä sähköpostiviesti kirjautuneena käyttäjänä.

Pakolliset parametrit:

  • Viesti: Viestiobjekti, jossa on aihe, toRecipients, ja leipäteksti
  • aihe: Sähköpostin aihe
  • toRecipients: Ensisijaiset vastaanottajat
  • sisältö: Sähköpostin leipäteksti, jossa on sisältötyyppi (Teksti/HTML) ja sisältöä

Valinnaiset parametrit:

  • ccRecipients: Hiilijäljennös vastaanottajat
  • bccRecipients: Sokeat hiilijäljennöksen vastaanottajat
  • saveToSentItems: Tallenna lähetettyihin kohteisiin (oletus: true)
  • preferHtml: HTML-hahmonnuksen pakottaminen
  • Otsikot: Valinnaisia muita HTTP-otsikoita

10. mcp_MailTools_graph_mail_updateMessage

Päivittää viestin muunnettavat ominaisuudet, kuten aiheen, leipätekstin ja luokat.

Pakolliset parametrit:

  • henkilöllisyystodistus: Viestin tunnus

Valinnaiset parametrit:

  • aihe: Uusi aihe
  • runkoteksti: Uusi viestin runko
  • Luokat: Viestiluokat
  • tärkeys: Matala, normaali tai suuri
  • If-Match:ETag samanaikaisuuden hallintaan

Tärkeimmät ominaisuudet

Sähköpostin koostumus

  • Luo luonnoksia ja lähetä sähköpostiviestejä
  • HTML:n ja vain teksti -tekstin tuki
  • Vastaanottajat, CC ja BCC-vastaanottajat
  • Monipuoliset muotoiluasetukset

Sähköpostien hallinta

  • Viestien hakeminen, päivittäminen ja poistaminen.
  • Vastaa ja vastaa kaikkiin -toiminto.
  • Luonnosten hallinta.
  • Luokka- ja tärkeysasetukset.

Haku ja suodatus

  • KQL-tyylinen viestihaku.
  • OData-kyselyjen tuki.
  • Hae aiheesta, viestitekstistä ja liitteistä.
  • Sivutus ja suodatus.

Sentitems

  • Luettele lähetetyt viestit.
  • Valinnainen tallennus lähetetyille tietoyksiköille.
  • Suodata ja hae lähetettyjä kohteita.

Huomautuksia

  • Kaikki toiminnot käyttävät Microsoft Graph Mail -ohjelmointirajapintaa.
  • HTML-sisältö edellyttää contentType = "HTML" body-osiossa.
  • preferHtml otsake pyytää HTML-leipätekstimuotoa.
  • Haku käyttää Microsoft Graph Haun ohjelmointirajapintaa KQL-kyselyiden kanssa.
  • Luonnossanomia voidaan luoda, päivittää ja lähettää erikseen.
  • ETag päivitysten samanaikaisuuden hallinnan tuki.