Reference e-mailu (Preview)

Note

Tento článek popisuje funkce používané v agentech nebo tocích agentů využívajících standardní harness.

Important

Toto je funkce Preview.

• Microsoft uvolňuje funkce ve verzi Preview před oficiálním vydáním, aby k nim zákazníci mohli získat předběžný přístup a poskytnout zpětnou vazbu.
• Funkce ve verzi Preview mají omezené funkce a nejsou určené pro produkční použití.
• Microsoft můžou změnit názvy a parametry nástrojů MCP ve verzi Preview. Vyhněte se pevně zakódovaným závislostem. Microsoft udržuje podporu scénářů.
• Funkce ve verzi Preview podléhají Microsoft dodatečným podmínkám použití.

Přehled

ID serveru	Adresa URL na úrovni tenanta	Zobrazované jméno	Description
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	Pošta	Nástroje pro operace s e-mailem v Microsoft Graph, včetně vytváření, odesílání, odpovídání a správy e-mailových zpráv.

Dostupné nástroje

mcp_MailTools_graph_mail_createMessage

Vytvořte koncept e-mailu. Podporuje HTML nastavením body.body.contentType = "HTML".

Požadované parametry:

• předmět: Předmět zprávy
• toRecipients: Pole příjemců s e-mailovými adresami
• tělo: Tělo zprávy s contentType (Text/HTML) a obsahem

Volitelné parametry:

• preferHtml: Nastavit na true pro obsah HTML
• hlavičky: Volitelné další hlavičky

mcp_MailTools_graph_mail_deleteMessage

Odstraní zprávu z poštovní schránky přihlášeného uživatele.

Požadované parametry:

• id: ID zprávy

Volitelné parametry:

• If-Match: Volitelné ETag pro řízení souběžnosti

mcp_MailTools_graph_mail_getMessage

Získá zprávu podle ID z poštovní schránky přihlášeného uživatele. Použijte preferHtml k vyžádání textu HTML.

Požadované parametry:

• id: ID zprávy

Volitelné parametry:

• select: klauzule OData select
• expand: klauzule OData expand
• preferHtml: Formát textu HTML požadavku
• hlavičky: Volitelné hlavičky HTTP

mcp_MailTools_graph_mail_listSent

Zobrazení seznamu zpráv v odeslaných položkách

Volitelné parametry:

• filtr: Filtr OData
• hledání: Vyhledávací dotaz
• orderby: Výraz řazení
• vrchol: Počet vrácených položek
• vyberte: Pole, která se mají vrátit

mcp_MailTools_graph_mail_reply

Odeslání odpovědi na existující zprávu Podporuje HTML prostřednictvím preferHtml nebo headers.

Požadované parametry:

• id: ID zprávy pro odpověď na

Volitelné parametry:

• komentář: Text odpovědi
• zpráva: Volitelná úprava zprávy
• preferHtml: Povolení formátování HTML
• hlavičky: Volitelné hlavičky HTTP

mcp_MailTools_graph_mail_replyAll

Odeslat odpověď všem na existující zprávu. Podporuje HTML prostřednictvím preferHtml nebo headers.

Požadované parametry:

• id: ID zprávy pro odpověď všem

Volitelné parametry:

• komentář: Text odpovědi
• zpráva: Volitelná úprava zprávy
• preferHtml: Povolení formátování HTML
• hlavičky: Volitelné hlavičky HTTP

mcp_MailTools_graph_mail_searchMessages

Hledání Outlook zpráv pomocí rozhraní API pro vyhledávání Microsoft Graph pomocí dotazů ve stylu jazyka KQL (Keyword Query Language).

Požadované parametry:

• requests: Pole vyhledávacích požadavků s parametry entityTypes, query, from a size

Podporuje vyhledávání obsahu zprávy, předmětu, textu a příloh.

mcp_MailTools_graph_mail_sendDraft

Odešle existující koncept zprávy pomocí ID.

Požadované parametry:

• id: ID konceptu zprávy, která se má odeslat

mcp_MailTools_graph_mail_sendMail

Odešlete e-mail jako přihlášený uživatel.

Požadované parametry:

• Zprávu: Objekt zprávy s předmětem toRecipientsa textem
• předmět: Předmět e-mailu
• toRecipients: Primární příjemci
• tělo: Tělo e-mailu s contentType (Text/HTML) a obsahem

Volitelné parametry:

• ccRecipients: Příjemci kopie
• bccRecipients: Příjemci skryté kopie
• saveToSentItems: Uložit do odeslaných položek (výchozí hodnota: true)
• preferHtml: Vynucení vykreslování HTML
• hlavičky: Volitelné další hlavičky HTTP

10. mcp_MailTools_graph_mail_updateMessage

Aktualizuje proměnlivé vlastnosti zprávy, jako je předmět, text a kategorie.

Požadované parametry:

• id: ID zprávy

Volitelné parametry:

• předmět: Nový předmět
• tělo: Text nové zprávy
• Kategorie: Kategorie zpráv
• důležitost: Nízká, Normální nebo Vysoká
• If-Match:ETag pro řízení souběžnosti

Klíčové funkce

Složení e-mailu

• Vytváření konceptů a odesílání e-mailů
• Podpora HTML a prostého textu
• Příjemci v polích Komu, Kopie a Skrytá kopie
• Možnosti bohatého formátování

Správa e-mailů

• Získejte, aktualizujte a odstraňte zprávy.
• Funkce Odpovědět a Odpovědět všem.
• Řízení konceptů.
• Nastavení kategorií a důležitosti

Vyhledávání a filtrování

• Hledání zpráv ve stylu KQL
• Podpora dotazů OData
• Hledání v předmětu, textu a přílohách
• Stránkování a filtrování

Sentitems

• Seznam odeslaných zpráv
• Volitelné ukládání do odeslaných položek
• Filtrování a vyhledávání odeslaných položek

Poznámky

• Všechny operace používají rozhraní Microsoft Graph Mail API pro poštu.
• Obsah HTML vyžaduje v těle contentType = "HTML".
• preferHtml hlavička vyžaduje formát těla HTML.
• Search používá Microsoft Graph rozhraní API pro vyhledávání s dotazy KQL.
• Koncepty zpráv je možné vytvářet, aktualizovat a odesílat samostatně.
• ETag podpora řízení souběžnosti při aktualizacích.