Referencja do poczty (zapowiedź)

Note

Ten artykuł opisuje cechy stosowane w przepływach agentów lub przepływach agentów zasilanych standardową wiązką.

Important

To jest funkcja w wersji zapoznawczej.

• Microsoft udostępnia funkcje w wersji zapoznawczej przed ich oficjalnym wydaniem, aby klienci mogli uzyskać wcześniejszy dostęp i przekazać opinie.
• Funkcje w wersji zapoznawczej mają ograniczone funkcje i nie są przeznaczone do użytku produkcyjnego.
• Microsoft może zmienić nazwy i parametry narzędzia MCP w wersji zapoznawczej. Unikaj zakodowanych na sztywno zależności. Microsoft obsługuje scenariusze.
• Funkcje w wersji zapoznawczej podlegają dodatkowym warunkom użytkowania firmy Microsoft.

Note

Narzędzia Microsoft 365 MCP specyficzne dla aplikacji (Copilot, Kalendarz, Mail, SharePoint, OneDrive, Teams, User i Word) są przeznaczone wyłącznie do kompatybilności wstecznej i nie powinny być używane w środowiskach produkcyjnych ani nowych projektach. W przypadku nowych projektów wymagających dostępu do zasobów Microsoft 365 korzystaj z Work IQ MCP z uprzężą Microsoft Copilot. Więcej informacji można znaleźć w artykule Work IQ MCP w Copilot Studio.

Overview

Identyfikator serwera	Adres URL na poziomie dzierżawcy	Wyświetlana nazwa	Opis
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	Poczta	Narzędzia do operacji pocztowych Microsoft Graph, w tym tworzenie, wysyłanie, odpowiadanie i zarządzanie wiadomościami e-mailowymi.

Dostępne narzędzia

mcp_MailTools_graph_mail_createMessage

Utwórz roboczą wiadomość e-mail. Obsługuje kod HTML przez ustawienie body.body.contentType = "HTML".

Wymagane parametry:

• Temat: Temat wiadomości
• toRecipients: Zestaw odbiorców z adresami e-mail
• body: Ciało wiadomości z typem treści (Tekst/HTML) i treścią

Parametry opcjonalne:

• preferHtml: Ustaw na true dla treści HTML
• Nagłówki: Opcjonalne dodatkowe nagłówki

mcp_MailTools_graph_mail_deleteMessage

Usuwa wiadomość ze skrzynki pocztowej zalogowanego użytkownika.

Wymagane parametry:

• id: ID wiadomości

Parametry opcjonalne:

• If-Match: Opcjonalny nagłówek ETag do sterowania współbieżnością

mcp_MailTools_graph_mail_getMessage

Pobiera wiadomość na podstawie identyfikatora ze skrzynki pocztowej zalogowanego użytkownika. Użyj polecenia preferHtml , aby zażądać treści HTML.

Wymagane parametry:

• id: ID wiadomości

Parametry opcjonalne:

• select: Klauzula wyboru OData
• expand: Klauzula OData expand
• preferHtml: Żądanie formatu treści HTML
• Nagłówki: Opcjonalne nagłówki HTTP

mcp_MailTools_graf_emaile_listaWysłane

Wyświetl wiadomości w elementach wysłanych.

Parametry opcjonalne:

• filter: Filtr OData
• search: Zapytanie wyszukiwania
• orderby: Wyrażenie sortowania
• top: Liczba elementów do zwrócenia
• select: Pola do zwrócenia

mcp_MailTools_graph_mail_reply

Wyślij odpowiedź na istniejącą wiadomość. Obsługuje kod HTML za pośrednictwem metody preferHtml lub headers.

Wymagane parametry:

• id: Identyfikator wiadomości do odpowiedzi

Parametry opcjonalne:

• Komentarz: tekst odpowiedzi
• komunikat: Opcjonalne zastąpienia komunikatów
• preferHtml: Włącz formatowanie HTML
• Nagłówki: Opcjonalne nagłówki HTTP

mcp_MailTools_graph_mail_replyAll

Wyślij odpowiedź do istniejącej wiadomości. Obsługuje kod HTML za pośrednictwem metody preferHtml lub headers.

Wymagane parametry:

• id: Identyfikator wiadomości do odpowiedzi do wszystkich

Parametry opcjonalne:

• Komentarz: Tekst odpowiedzi
• komunikat: Opcjonalne zastąpienia komunikatu
• preferHtml: Włącz formatowanie HTML
• Nagłówki: Opcjonalne nagłówki HTTP

mcp_MailTools_graph_mail_searchMessages

Przeszukuj wiadomości programu Outlook za pomocą interfejsu API wyszukiwania w Microsoft Graph, używając zapytań w stylu języka zapytań opartych na słowach kluczowych (KQL).

Wymagane parametry:

• Żądania: Tablica żądań wyszukiwania z parametrami entityTypes, query, from, size

Obsługuje wyszukiwanie zawartości wiadomości, tematu, treści i załączników

mcp_MailTools_graph_mail_sendDraft

Wyślij istniejącą wersję roboczą wiadomości za pomocą identyfikatora.

Wymagane parametry:

• id: ID wersji roboczej wiadomości do wysłania

mcp_MailTools_graph_mail_sendMail

Wyślij wiadomość e-mail jako zalogowanego użytkownika.

Wymagane parametry:

• Wiadomość: Obiekt wiadomości z tematem, toRecipients, i treścią
• Temat: Temat e-maila
• doAdresatów: Główni adresaci
• body: Treść wiadomości e-mail z typem zawartości (tekst/HTML) i treścią

Parametry opcjonalne:

• ccRecipients: Odbiorcy DW
• bccRecipients: Odbiorcy ukrytej kopii
• saveToSentItems: Zapisz w folderze Wysłane (domyślnie: true)
• preferHtml: Wymusz renderowanie HTML
• Nagłówki: Opcjonalne dodatkowe nagłówki HTTP

10. mcp_MailTools_graph_mail_updateMessage

Aktualizuje właściwości modyfikowalne wiadomości, takie jak temat, treść i kategorie.

Wymagane parametry:

• id: ID wiadomości

Parametry opcjonalne:

• Temat: Nowy temat
• Treść: Nowa treść wiadomości
• Kategorie: Kategorie wiadomości
• Ważność: Niska, Normalna lub Wysoka
• If-Match:ETag do sterowania współbieżnością

Kluczowe funkcje

Kompozycja wiadomości e-mail

• Tworzenie wersji roboczych i wysyłanie wiadomości e-mail
• Obsługa kodu HTML i zwykłego tekstu
• Adresaci do, DW i BCC
• Bogate opcje formatowania

Zarządzanie pocztą e-mail

• Pobieranie, aktualizowanie i usuwanie komunikatów.
• Funkcje Odpowiedz i Odpowiedz wszystkim.
• Zarządzanie szkicami
• Ustawienia kategorii i ważności.

Wyszukiwanie i filtrowanie

• Wyszukiwanie komunikatów w stylu KQL.
• Obsługa zapytań OData.
• Wyszukiwanie w tematach, treściach i załącznikach.
• Stronicowanie i filtrowanie.

Sentitems

• Wyświetl listę wysłanych wiadomości.
• Opcjonalne zapisywanie wysłanych elementów.
• Filtrowanie i wyszukiwanie wysłanych elementów.

Uwagi

• Wszystkie operacje używają interfejsu API poczty Microsoft Graph.
• Zawartość HTML wymaga elementu contentType = "HTML" w treści.
• preferHtml nagłówek prosi o format treści HTML.
• Wyszukiwanie korzysta z interfejsu API Microsoft Graph Search i zapytań KQL.
• Wersje robocze wiadomości można tworzyć, aktualizować i wysyłać oddzielnie.
• ETag Wsparcie dla kontroli współbieżności podczas aktualizacji.