Informacje referencyjne usługi Work IQ Mail (podgląd)

Important

Jest to funkcja w wersji zapoznawczej.

• Microsoft udostępnia funkcje w wersji zapoznawczej przed oficjalnym wydaniem, aby klienci mogli uzyskać wcześniejszy dostęp i przekazać opinię.
• 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.

Overview

Identyfikator serwera	Adres URL na poziomie dzierżawcy	nazwa wyświetlana	Description
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	Poczta Work IQ	Serwer MCP dostarczający narzędzia poczty Microsoft Graph.

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: Tablica adresatów z adresami e-mail
• ciało: Treść wiadomości e-mail z typem zawartości (Tekst/HTML) i samą zawartością

Parametry opcjonalne:

• preferHtml: Ustaw wartość true dla zawartości HTML
• Nagłówki: Opcjonalne dodatkowe nagłówki

mcp_MailTools_graph_mail_deleteMessage

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

Wymagane parametry:

• id: Identyfikator komunikatu

Parametry opcjonalne:

• If-Match: Opcjonalne ETag do kontroli 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: Identyfikator komunikatu

Parametry opcjonalne:

• wybrać: Klauzula OData select
• rozszerzenie: klauzula rozszerzenia OData
• 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:

• filtr: Filtr OData
• szukać: Kwerenda wyszukiwania
• orderby: Wyrażenie sortowania
• Najwyżej: Liczba elementów, które mają być zwrócone
• wybierz: 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, na który ma odpowiadać

Parametry opcjonalne:

• komentarz: Tekst odpowiedzi
• Komunikat: Opcjonalne przesłonięcia komunikatów
• preferHtml: Włączanie formatowania 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 wszystkim

Parametry opcjonalne:

• komentarz: Tekst odpowiedzi
• Komunikat: Opcjonalne przesłonięcia komunikatów
• preferHtml: Włączanie formatowania 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: Identyfikator wiadomości roboczej do wysłania

mcp_MailTools_graph_mail_sendMail

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

Wymagane parametry:

• Komunikat: Obiekt komunikatu z tematem, toRecipientsi treścią
• Temat: Temat wiadomości e-mail
• toRecipients: Adresaci podstawowi
• ciało: Treść wiadomości e-mail z typem zawartości (Tekst/HTML) oraz zawartością

Parametry opcjonalne:

• ccRecipients: Adresaci kopii dwutlenku węgla
• bccRecipients: Ukryci odbiorcy kopii
• saveToSentItems: Zapisz do wysłanych elementów (wartość domyślna: true)
• preferHtml: Wymuszanie renderowania 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: Identyfikator komunikatu

Parametry opcjonalne:

• Temat: Nowy temat
• ciało: Nowa treść wiadomości
• Kategorie: Kategorie wiadomości
• znaczenie: Niski, normalny lub wysoki
• If-Match:ETag do kontroli 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.

Notes

• Wszystkie operacje używają interfejsu API poczty Microsoft Graph.
• Zawartość HTML wymaga elementu contentType = "HTML" w treści.
• preferHtml nagłówek żąda formatu 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 obsługa kontroli współbieżności podczas aktualizacji.