Sähköpostiviittaus (ennakko)

Muistio

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.

Tärkeää

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