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

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_CalendarTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_CalendarTools	Calendar	Инструменты для работы с календарем, такие как создание, обновление, получение событий, управление приглашениями и проверка их доступности.

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

mcp_CalendarTools_graph_принятьСобытие

Примите указанное приглашение на событие в календаре пользователя.

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

• eventId: Идентификатор события, которое нужно принять

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

• userId: ИД пользователя или userPrincipalName
• comment: необязательный текст, включенный в ответ
• sendResponse: стоит ли отправлять ответ организатору

mcp_CalendarTools_graph_cancelEvent

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

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

• eventId: уникальный идентификатор отменяемого события

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

• userId: ИД пользователя или userPrincipalName
• comment: необязательное сообщение об отмене

mcp_CalendarTools_graph_создатьСобытие

Создайте новое событие календаря в указанном календаре пользователя. Поддерживает повторяющиеся события и онлайн-встречи.

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

• subject: тема или название события (не должно быть пустым)
• start: метка времени начала с dateTime и timeZone
• конец: метка времени окончания с dateTime и timeZone
• attendees_addresses: массив адресов электронной почты участников

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

• userId: ИД пользователя или userPrincipalName
• body: тело события с contentType (Text/HTML) и содержимым
• location: местоположение с displayName
• attendees_types: роли участников (обязательный, необязательный, ресурс)
• attendees_names: отображаемые имена участников
• recurrence: шаблон повторения и диапазон
• isOnlineMeeting: установлено значение «true» для онлайн-встреч
• onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
• allowNewTimeProposals: разрешить предложения нового времени (по умолчанию: true)
• transactionId: Idempotence идентификатор

mcp_CalendarTools_graph_declineEvent

Отклоните указанное приглашение на событие в календаре пользователя.

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

• eventId: идентификатор события для отклонения

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

• userId: ИД пользователя или userPrincipalName

• comment: необязательный текст в качестве ответа

• sendResponse: отправлять ли ответ

mcp_CalendarTools_graph_deleteEvent

Удалите событие из календаря указанного пользователя.

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

• eventId: уникальный идентификатор удаляемого события

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

• userId: ИД пользователя или userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Предлагать время и местоположения для встреч на основе доступности организаторов и участников.

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

• meetingDuration: продолжительность встречи (например, PT1H)

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

• userId: идентификатор организатора или userPrincipalName
• attendees_addresses: адреса электронной почты участников
• attendees_types: типы участников
• attendees_names: отображаемые имена участников
• timeConstraint: доступность времени с timeslots и activityDomain
• locationConstraint: варианты местоположения
• maxCandidates: максимальное число предложений
• isOrganizerOptional: флаг необязательного организатора
• returnSuggestionReasons: включать причины
• minimumAttendeePercentage: минимальный порог посещаемости

mcp_CalendarTools_graph_getEvent

Получите одно событие из календаря указанного пользователя.

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

• eventId: уникальный идентификатор события

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

• userId: ИД пользователя или userPrincipalName
• select: параметр запроса OData \$select
• expand: OData \$expand для навигационных свойств

mcp_CalendarTools_graph_getSchedule

Получите расписание занятости/доступности для пользователя, списка рассылки или ресурса.

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

• schedules: SMTP-адреса пользователей или ресурсов
• startTime: Начало времени с dateTime и timeZone
• endTime: время окончания с dateTime и timeZone

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

• userId: ИД пользователя или userPrincipalName
• availabilityViewInterval: длительность временного интервала в минутах

mcp_CalendarTools_graph_listCalendarView

Получение событий календаря в пределах указанного диапазона времени для пользователя.

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

• startDateTime: начало временного диапазона (ISO 8601)
• endDateTime: конец временного диапазона (ISO 8601)

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

• userId: ИД пользователя или userPrincipalName
• top: максимальное количество событий
• orderby: предложение сортировки

mcp_CalendarTools_graph_listEvents

Получение списка событий из указанного календаря пользователя.

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

• userId: ИД пользователя или userPrincipalName
• startDateTime: начало временного диапазона (ISO 8601)
• endDateTime: конец временного диапазона (ISO 8601)
• top: максимальное количество событий
• filter: запрос с фильтром OData
• orderby: запрос сортировки OData

mcp_CalendarTools_graph_updateEvent

Обновите существующее событие календаря в указанном календаре пользователя.

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

• eventId: уникальный идентификатор события

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

• userId: ИД пользователя или userPrincipalName
• тема: обновленная тема
• body: обновленное содержание тела
• start: обновленное время начала
• end обновленное время окончания
• location: обновленное местоположение
• attendees_addresses: обновленные электронные адреса участников
• attendees_types: обновленные типы участников
• attendees_names: обновленные имена участников
• isCancelled: установите значение true для отмены
• recurrence: обновленный шаблон повторения

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

Управление событиями

• Создавайте, читайте, обновляйте и удаляйте события.
• Принимайте, отклоняйте и отменяйте приглашения.
• Поддержка для повторяющихся событий.
• Интеграция с онлайн-встречами (Teams, Skype).

Доступность и планирование

• Получайте свободные/плотные графики.
• Найдите время встреч с проверкой доступности.
• Просмотр календаря с фильтрацией временного диапазона.
• Анализ доступности участников.

Управление участниками

• Управляйте обязательными, необязательными и ресурсными участниками.
• Поддержка предложений по времени.
• Отслеживайте реакции.
• Поддержка списков рассылки.

Шаблоны повторения

• Ежедневные, еженедельные, ежемесячные и годовые схемы.
• Абсолютная и относительная рецидив.
• Дата окончания или количество случаев.
• Спецификации дня недели и месяца.

Собрания по сети

• Интеграция с Microsoft Teams для бизнеса
• Поддержка Skype для бизнеса
• Поддержка Skype (для личного пользования)
• Автоматическое создание ссылки для собрания

Notes

• Все метки времени используют формат UTC/ISO 8601 с часовыми поясами
• Календарь MCP использует UserprofileMCP для поиска пользователей в организации
• Адреса электронной почты должны соответствовать допустимому формату
• Массивы участников (адреса, типы, имена) должны находиться в одном порядке.
• Онлайн-встречи требуют isOnlineMeeting=true и onlineMeetingProvider
• Для повторения требуются объекты шаблона и диапазона
• Часовые пояса должны быть согласованы между временем начала и окончания
• TransactionId позволяет idempotent создавать события