Ссылка по почте (предварительный просмотр)

Note

В этой статье описываются особенности, используемые в агентах или потоках агентов, питаемых стандартным жгутом.

Important

Это предварительная версия функции.

• Microsoft выпускает предварительные версии функций перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.
• Предварительные версии функций имеют ограниченные функциональные возможности и не предназначены для использования в производственной среде.
• Microsoft может изменить названия и параметры инструментов MCP на стадии предварительной версии. Избегайте жестко закодированных зависимостей. Microsoft обеспечивает поддержку сценариев.
• Предварительные версии функции регулируются дополнительными условиями использования Microsoft.

Note

Специализированные инструменты Microsoft 365 MCP (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User и Word) предназначены только для обратной совместимости и не должны использоваться в производственных средах или новых проектах. Для новых проектов, требующих доступа к ресурсам Microsoft 365, используйте Work IQ MCP с использованием GitHub Copilot. Для получения дополнительной информации смотрите раздел Work IQ MCP in Copilot Studio.

Overview

Идентификатор сервера	URL-адрес на уровне клиента	Показать имя	Description
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	Mail	Инструменты для почтовых операций Microsoft Graph, включая создание, отправку, ответ и управление электронными письмами.

Доступные средства

mcp_MailTools_graph_mail_createMessage

Создайте черновик электронной почты. Поддерживает HTML путем установки body.body.contentType = "HTML".

Требуемые параметры:

• Тема: Тема сообщения
• toRecipients: Массив получателей с адресами электронной почты
• тело сообщения: Тело сообщения с contentType (Text/HTML) и содержимым

Необязательные параметры

• preferHtml: Задайте значение true для HTML-содержимого
• Заголовки: Необязательные дополнительные заголовки

mcp_MailTools_graph_mail_deleteMessage

Удаляет сообщение из почтового ящика вошедшего в систему пользователя.

Требуемые параметры:

• идентификатор: Идентификатор сообщения

Необязательные параметры

• If-Match: необязательный ETag для управления конкурентным доступом

mcp_MailTools_graph_mail_getMessage

Получает сообщение по идентификатору из почтового ящика вошедшего в систему пользователя. Используйте preferHtml для запроса основного текста в формате HTML.

Требуемые параметры:

• идентификатор: Идентификатор сообщения

Необязательные параметры

• выбирать: Предложение OData select
• расширение: Клаузула расширения OData
• preferHtml: Формат текста ЗАПРОСА HTML
• Заголовки: Необязательные заголовки HTTP

mcp_MailTools_graph_mail_listSent

Список сообщений в папке "Отправленные".

Необязательные параметры

• фильтр: Фильтр OData
• искать: Поисковый запрос
• orderby: Выражение сортировки
• Максимум: Количество возвращаемых элементов
• выбор: Поля для возврата

mcp_MailTools_graph_mail_reply

Отправьте ответ существующему сообщению. Поддерживает HTML с помощью preferHtml или headers.

Требуемые параметры:

• идентификатор: Идентификатор сообщения для ответа

Необязательные параметры

• комментарий: Текст ответа
• Сообщение: Переопределение сообщений (необязательно)
• preferHtml: Включение форматирования HTML
• Заголовки: Необязательные заголовки HTTP

mcp_MailTools_graph_mail_replyAll

Ответьте всем участникам цепочки сообщений. Поддерживает HTML с помощью preferHtml или headers.

Требуемые параметры:

• идентификатор: Идентификатор сообщения для ответа всем

Необязательные параметры

• комментарий: Текст ответа
• Сообщение: Переопределение сообщений (необязательно)
• preferHtml: Включение форматирования HTML
• Заголовки: Необязательные заголовки HTTP

mcp_MailTools_graph_mail_searchMessages

Поиск сообщений Outlook с помощью API поиска Microsoft Graph с использованием KQL-запросов.

Требуемые параметры:

• requests: массив запросов поиска с параметрами: entityTypes, query, from, size

Поддерживает поиск содержимого сообщения, темы, текста и вложений

mcp_MailTools_graph_mail_sendDraft

Отправьте один из существующих черновиков сообщения по идентификатору.

Требуемые параметры:

• идентификатор: Идентификатор черновика сообщения для отправки

mcp_MailTools_graph_mail_sendMail

Отправьте сообщение электронной почты в качестве пользователя, вошедшего в систему.

Требуемые параметры:

• message: объект сообщения с темой, toRecipients, и основным текстом
• Тема: Тема электронной почты
• toRecipients: Основные получатели
• тело: Текст электронной почты с contentType (Text/HTML) и содержимым

Необязательные параметры

• ccRecipients: Получатели углеродного копирования
• bccRecipients: Получатели скрытой копии
• saveToSentItems: сохранить в папку "Отправленные" (по умолчанию: true)
• preferHtml: Принудительное отображение HTML
• Заголовки: Необязательные дополнительные заголовки HTTP

10. mcp_MailTools_graph_mail_updateMessage

Обновляет изменяемые свойства сообщения, такие как тема, основной текст и категории.

Требуемые параметры:

• идентификатор: Идентификатор сообщения

Необязательные параметры

• Тема: Новая тема
• тело: Текст нового сообщения
• Категории: Категории сообщений
• важность: Низкий, обычный или высокий
• If-Match:ETag для управления параллелизмом

Ключевые особенности

Композиция электронной почты

• Создание черновиков и отправка сообщений электронной почты
• Поддержка HTML и обычного текста
• Получатели: Кому, Копия (CC), скрытая копия (BCC)
• Расширенные параметры форматирования

Управление электронной почтой

• Получение, обновление и удаление сообщений.
• Возможности ответа и ответа всем.
• Управление черновиками.
• Настройки категории и важности.

Поиск и фильтрация

• KQL-поиск сообщений.
• Поддержка запросов OData.
• Поиск по теме, основному тексту и вложениям.
• Разбиение на страницы и фильтрация.

Sentitems

• Список отправленных сообщений.
• Необязательное сохранение в папке "Отправленные".
• Фильтрация и поиск в папке "Отправленные".

Notes

• Все операции используют Microsoft Graph Mail API.
• HTML-содержимое должно содержать contentType = "HTML" в тексте сообщения.
• Заголовок preferHtml запрашивает формат текста письма в HTML.
• Поиск осуществляется с помощью Microsoft Graph Search API с запросами KQL.
• Черновики сообщений можно создавать, обновлять и отправлять отдельно.
• Поддержка ETag для управления параллелизмом при обновлениях.