Odniesienie kalendarzowe (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 harness 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_CalendarTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_CalendarTools		 Kalendarz Narzędzia do obsługi kalendarza, takie jak tworzenie, aktualizacja, pobieranie zdarzeń, zarządzanie zaproszeniami i sprawdzanie dostępności.

Dostępne narzędzia

mcp_CalendarTools_graph_acceptEvent

Zaakceptuj określone zaproszenie na wydarzenie w kalendarzu użytkownika.

Wymagane parametry:

  • eventId: ID zdarzenia do zaakceptowania

Parametry opcjonalne:

  • userId: ID użytkownika lub userPrincipalName
  • komentarz: Opcjonalny tekst w odpowiedzi
  • sendResponse: Czy wysłać odpowiedź do organizatora

mcp_CalendarTools_graph_anulujWydarzenie

Anuluj wydarzenie w kalendarzu określonego użytkownika i powiadamiaj uczestników.

Wymagane parametry:

  • eventId: unikalny identyfikator zdarzenia do anulowania

Parametry opcjonalne:

  • userId: ID użytkownika lub userPrincipalName
  • komentarz: Opcjonalna wiadomość o anulowaniu

mcp_CalendarTools_graph_createEvent

Utwórz nowe zdarzenie kalendarza w kalendarzu określonego użytkownika. Obsługuje zdarzenia cykliczne i spotkania online.

Wymagane parametry:

  • Temat: Temat wydarzenia lub tytuł (niepusty)
  • start: Znacznik czasu rozpoczęcia z dateTime i timeZone
  • end: Znacznik czasu zakończenia z dateTime i timeZone
  • attendees_addresses: Tablica adresów e-mail uczestników

Parametry opcjonalne:

  • userId: ID użytkownika lub userPrincipalName
  • Ciało: Ciało zdarzenia z typem treści (Tekst/HTML) i treścią
  • lokalizacja: Lokalizacja z displayName
  • attendees_types: Role uczestników (obowiązkowe, opcjonalne, zasoby)
  • attendees_names: Wyświetlane nazwy uczestników
  • cykliczność: wzorzec cykliczności i zakres
  • isOnlineMeeting: Ustaw na true dla spotkań online
  • onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
  • allowNewTimeProposals: Zezwalaj na propozycje terminów (domyślnie: true)
  • transactionId: Idempotence identyfikator

mcp_CalendarTools_graph_declineEvent

Odrzuć określone zaproszenie na wydarzenie w kalendarzu użytkownika.

Wymagane parametry:

  • eventId: ID zdarzenia do odrzucenia

Parametry opcjonalne:

  • userId: ID użytkownika lub userPrincipalName

  • komentarz: Opcjonalny tekst w odpowiedzi

  • sendResponse: Czy wysłać odpowiedź

mcp_CalendarTools_graph_deleteEvent

Usuń zdarzenie z kalendarza określonego użytkownika.

Wymagane parametry:

  • eventId: unikalny identyfikator zdarzenia do usunięcia

Parametry opcjonalne:

  • userId: ID użytkownika lub userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Sugeruj czasy spotkań i lokalizacje na podstawie dostępności organizatora i uczestnika.

Wymagane parametry:

  • meetingDuration: Czas trwania spotkania (na przykład 'PT1H')

Parametry opcjonalne:

  • userId: Identyfikator organizatora lub userPrincipalName
  • attendees_addresses: Adresy e-mail uczestników
  • attendees_types: Typy uczestników
  • attendees_names: Wyświetlane nazwy uczestników
  • timeConstraint: Dostępność czasu z timeslots i activityDomain
  • locationConstraint: Opcje lokalizacji
  • maxCandidates: Maksymalna liczba propozycji
  • isOrganizerOptional: flaga opcjonalności organizatora
  • returnSuggestionReasons: Uwzględnij powody
  • minimumAttendeePercentage: Minimalny próg frekwencji

mcp_CalendarTools_graph_getEvent

Pobierz jedno zdarzenie kalendarza z kalendarza określonego użytkownika.

Wymagane parametry:

  • eventId: Unikalny identyfikator zdarzenia

Parametry opcjonalne:

  • userId: ID użytkownika lub userPrincipalName
  • wybrać: parametr zapytania OData \$select
  • expand: OData \$expand dla właściwości nawigacyjnych

mcp_CalendarTools_graph_getSchedule

Pobierz harmonogram wolny/zajęty dla użytkownika, listy dystrybucyjnej lub zasobu.

Wymagane parametry:

  • harmonogramy: adresy SMTP użytkowników lub zasobów
  • startTime: Czas rozpoczęcia z dateTime i timeZone
  • endTime: Czas zakończenia z dateTime i timeZone

Parametry opcjonalne:

  • userId: ID użytkownika lub userPrincipalName
  • availabilityViewInterval: Długość przedziału czasowego w minutach

mcp_CalendarTools_graph_listCalendarView

Pobieranie wystąpień kalendarza w określonym zakresie czasu dla użytkownika.

Wymagane parametry:

  • startDateTime: Początek zakresu czasowego (ISO 8601)
  • endDateTime: Koniec zakresu czasowego (ISO 8601)

Parametry opcjonalne:

  • userId: ID użytkownika lub userPrincipalName
  • top: Maksymalna liczba zdarzeń
  • orderby: klauzula sortowania

mcp_CalendarTools_graph_listEvents

Pobierz listę zdarzeń z kalendarza określonego użytkownika.

Parametry opcjonalne:

  • userId: ID użytkownika lub userPrincipalName
  • startDateTime: Początek zakresu czasowego (ISO 8601)
  • endDateTime: Koniec zakresu czasowego (ISO 8601)
  • top: Maksymalna liczba zdarzeń
  • filtr: Zapytanie filtra OData
  • orderby: OData order by query

mcp_CalendarTools_graph_updateEvent

Zaktualizuj istniejące zdarzenie kalendarza w kalendarzu określonego użytkownika.

Wymagane parametry:

  • eventId: Unikalny identyfikator zdarzenia

Parametry opcjonalne:

  • userId: ID użytkownika lub userPrincipalName
  • Temat: Zaktualizowany temat
  • Główna treść: Zaktualizowana zawartość ciała
  • Początek: Zaktualizowana godzina rozpoczęcia
  • koniec: Zaktualizowany czas zakończenia
  • lokalizacja: Zaktualizowana lokalizacja
  • attendees_addresses: Zaktualizowane adresy e-mail uczestników
  • attendees_types: Zaktualizowane typy uczestników
  • attendees_names: Zaktualizowane imiona i nazwiska uczestników
  • isCancelled: Ustaw na true, aby anulować
  • Powtarzanie: Zaktualizowany wzorzec powtarzania

Kluczowe funkcje

Zarządzanie zdarzeniami

  • Twórz, czytaj, aktualizuj i usuwaj zdarzenia.
  • Akceptuj, odrzucaj i anuluj zaproszenia.
  • Wsparcie dla powtarzających się wydarzeń.
  • Integracja z spotkaniami online (Teams, Skype).

Dostępność i planowanie

  • Pobierz harmonogramy wolny/zajęty.
  • Znajdź godziny spotkań za pomocą sprawdzania dostępności.
  • Widok kalendarza z filtrowaniem zakresu czasu.
  • Analiza dostępności uczestników.

Zarządzanie uczestnikami

  • Zarządzaj uczestnikami wymaganymi, opcjonalnymi i zasobami.
  • Obsługa propozycji terminów.
  • Śledź reakcje.
  • Wsparcie dla list dystrybucyjnych.

Wzorce cyklu

  • Codzienne, tygodniowe, miesięczne i roczne wzorce.
  • Absolutne i względne nawroty.
  • Data zakończenia lub liczba zdarzeń.
  • Specyfikacje dnia tygodnia i miesiąca.

Spotkania online

  • Integracja z usługą Teams dla Firm
  • Obsługa programu Skype dla firm
  • Obsługa Skype (do użytku osobistego)
  • Automatyczne generowanie linku spotkania

Uwagi

  • Wszystkie znaczniki czasu używają formatu UTC/ISO 8601 ze strefą czasową
  • Kalendarz MCP używa UserprofileMCP, aby znajdować użytkowników w organizacji
  • Adresy e-mail muszą mieć prawidłowy format
  • Tablice uczestników (adresy, typy, nazwy) muszą być w tej samej kolejności
  • Spotkania online wymagają isOnlineMeeting=true i onlineMeetingProvider
  • Aby powtarzanie było możliwe, wymagane są obiekty wzorca i zakresu
  • Strefy czasowe powinny być spójne w godzinach rozpoczęcia i zakończenia
  • TransactionId umożliwia idempotent tworzenie zdarzeń
  • Ostatnia aktualizacja o