Référence du calendrier (aperçu)

Note

Cet article décrit les caractéristiques utilisées dans les agents ou flux d’agents alimentés par le faisceau standard.

Important

Cette fonctionnalité est en version préliminaire.

  • Microsoft publie des fonctionnalités en préversion avant leur publication officielle afin que les clients puissent y accéder en avant-première et faire part de leurs commentaires.
  • Les fonctionnalités en préversion ont des fonctionnalités restreintes et ne sont pas destinées à une utilisation en production.
  • Microsoft pourrait modifier les noms et les paramètres des outils MCP en préversion. Évitez les dépendances codées en dur. Microsoft gère la prise en charge des scénarios.
  • Les fonctionnalités en préversion sont soumises à Microsoft conditions d’utilisation supplémentaires.

Note

Les outils MCP spécifiques à une application Microsoft 365 (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User et Word) sont uniquement destinés à des fins de rétrocompatibilité et ne doivent pas être utilisés dans les environnements de production ou les nouveaux projets. Pour les nouveaux projets nécessitant l’accès aux ressources Microsoft 365, utilisez Work IQ MCP avec le harnais GitHub Copilot. Pour plus d’informations, voir Work IQ MCP dans Copilot Studio.

Overview

ID du serveur URL au niveau du locataire Nom d'affichage Description
mcp_CalendarTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_CalendarTools
Calendar Outils pour les opérations de calendrier comme la création, la mise à jour, la récupération d’événements, la gestion des invitations et la vérification de la disponibilité.

Outils disponibles

mcp_CalendarTools_graph_acceptEvent

Acceptez l’invitation d’événement spécifiée dans le calendrier d’un utilisateur.

Paramètres obligatoires :

  • eventId : ID de l’événement à accepter

Paramètres facultatifs :

  • userId : ID d’utilisateur ou userPrincipalName
  • commentaire : texte facultatif inclus dans la réponse
  • sendResponse : indique s’il faut envoyer une réponse à l’organisateur

mcp_CalendarTools_graph_annulerÉvénement

Annulez un événement dans le calendrier d’un utilisateur spécifié et informez les participants.

Paramètres obligatoires :

  • eventId : identificateur unique de l’événement à annuler

Paramètres facultatifs :

  • userId : ID d’utilisateur ou userPrincipalName
  • commentaire : Message d’annulation facultatif

mcp_CalendarTools_graph_createEvent

Créez un événement de calendrier dans le calendrier d’un utilisateur spécifié. Prend en charge les événements récurrents et les réunions en ligne.

Paramètres obligatoires :

  • sujet: Sujet ou titre de l’événement (non vide)
  • start : Démarrer l’horodatage avec dateTime et timeZone
  • end : Horodatage de fin avec dateTime et timeZone
  • attendees_addresses : tableau d’adresses e-mail des participants

Paramètres facultatifs :

  • userId : ID d’utilisateur ou userPrincipalName
  • body: Contenu de l'événement avec contentType (Text/HTML) et contenu
  • emplacement : emplacement avec displayName
  • attendees_types : Rôles de participant (obligatoires, facultatifs, ressources)
  • attendees_names : Noms d’affichage des participants
  • périodicité : modèle et plage de périodicité
  • isOnlineMeeting : défini sur true pour la réunion en ligne
  • onlineMeetingProvider : teamsForBusiness, skypeForBusiness, skypeForConsumer
  • allowNewTimeProposals : Autoriser les propositions de temps (valeur par défaut : true)
  • transactionId : Idempotence identificateur

mcp_CalendarTools_graph_declineEvent

Refusez l’invitation d’événement spécifiée dans le calendrier d’un utilisateur.

Paramètres obligatoires :

  • eventId : ID de l’événement à refuser

Paramètres facultatifs :

  • userId : ID d’utilisateur ou userPrincipalName

  • commentaire : texte facultatif en réponse

  • sendResponse : indique s’il faut envoyer une réponse

mcp_OutilsCalendrier_graphe_supprimerÉvénement

Supprimez un événement du calendrier d’un utilisateur spécifié.

Paramètres obligatoires :

  • eventId : identificateur unique de l’événement à supprimer

Paramètres facultatifs :

  • userId : ID d’utilisateur ou userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Suggérez des heures et des emplacements de réunion en fonction de la disponibilité de l’organisateur et des participants.

Paramètres obligatoires :

  • meetingDuration : durée de la réunion (par exemple, « PT1H »)

Paramètres facultatifs :

  • userId : ID de l’organisateur ou userPrincipalName
  • attendees_addresses : Adresses e-mail des participants
  • attendees_types : Types de participants
  • attendees_names : Noms d’affichage des participants
  • timeConstraint : disponibilité du temps avec timeslots et activityDomain
  • locationConstraint : options d’emplacement
  • maxCandidates : suggestions maximales
  • isOrganizerOptional : indicateur facultatif de l’organisateur
  • returnSuggestionReasons : Inclure des raisons
  • minimumAttendeePercentage : seuil de présence minimal

mcp_CalendarTools_graph_getEvent

Obtenez un événement de calendrier unique à partir du calendrier d’un utilisateur spécifié.

Paramètres obligatoires :

  • eventId : identificateur unique de l’événement

Paramètres facultatifs :

  • userId : ID d’utilisateur ou userPrincipalName
  • select : paramètre de requête OData \$select
  • expand : OData \$expand pour les propriétés de navigation

mcp_CalendarTools_graph_getSchedule

Obtenez la planification de disponibilité pour un utilisateur, une liste de distribution ou une ressource.

Paramètres obligatoires :

  • planifications : adresses SMTP des utilisateurs ou des ressources
  • startTime : heure de début avec dateTime et timeZone
  • endTime : heure de fin avec dateTime et timeZone

Paramètres facultatifs :

  • userId : ID d’utilisateur ou userPrincipalName
  • availabilityViewInterval : durée du créneau horaire en minutes

mcp_CalendarTools_graph_listCalendarView

Récupérez les occurrences de calendrier dans un intervalle de temps spécifié pour un utilisateur.

Paramètres obligatoires :

  • startDateTime : intervalle de temps de début (ISO 8601)
  • endDateTime : intervalle de temps de fin (ISO 8601)

Paramètres facultatifs :

  • userId : ID d’utilisateur ou userPrincipalName
  • top : nombre maximal d’événements
  • orderby : commande par clause

mcp_CalendarTools_graph_listEvents

Récupérez une liste d’événements à partir du calendrier d’un utilisateur spécifié.

Paramètres facultatifs :

  • userId : ID d’utilisateur ou userPrincipalName
  • startDateTime : intervalle de temps de début (ISO 8601)
  • endDateTime : intervalle de temps de fin (ISO 8601)
  • top : nombre maximal d’événements
  • filter : requête de filtre OData
  • orderby : ordre OData par requête

mcp_CalendarTools_graph_updateEvent

Mettez à jour un événement de calendrier existant dans le calendrier d’un utilisateur spécifié.

Paramètres obligatoires :

  • eventId : identificateur unique de l’événement

Paramètres facultatifs :

  • userId : ID d’utilisateur ou userPrincipalName
  • objet : Objet mis à jour
  • corps : contenu du corps mis à jour
  • start : Heure de début mise à jour
  • fin : heure de fin mise à jour
  • emplacement : emplacement mis à jour
  • attendees_addresses : e-mails des participants mis à jour
  • attendees_types : Types de participants mis à jour
  • attendees_names : Noms des participants mis à jour
  • isCancelled : défini sur true pour annuler
  • périodicité : Modèle de périodicité mise à jour

Principales fonctionnalités

Gestion des événements

  • Créez, lisez, mettez à jour et supprimez des événements.
  • Acceptez, refusez et annulez les invitations.
  • Support pour les événements récurrents.
  • Intégration avec les réunions en ligne (Teams, Skype).

Disponibilité et planification

  • Obtenir les plages de disponibilité.
  • Trouvez les horaires de rendez-vous avec la vérification de disponibilité.
  • Vue calendrier avec filtrage par plage de temps.
  • Analyse de la disponibilité des participants.

Gestion des participants

  • Gérer les participants obligatoires, facultatifs et les ressources.
  • Prise en charge des propositions temporelles.
  • Suivez les réactions.
  • Prise en charge des listes de distribution.

Critères de périodicité

  • Des schémas quotidiens, hebdomadaires, mensuels et annuels.
  • Récidive absolue et relative.
  • Date de fin ou nombre d’occurrences.
  • Spécifications du jour de la semaine et du mois.

Réunions en ligne

  • Intégration à Teams for Business
  • Prise en charge de Skype Entreprise
  • Prise en charge de Skype (pour une utilisation personnelle)
  • Génération automatique de liens de réunion

Remarques

  • Tous les horodatages utilisent le format UTC/ISO 8601 avec fuseau horaire
  • MCP Calendar utilise UserprofileMCP pour trouver des utilisateurs dans l'organisation.
  • Les adresses de messagerie doivent avoir un format valide
  • Les tableaux de participants (adresses, types, noms) doivent être dans le même ordre
  • Les réunions en ligne nécessitent isOnlineMeeting=true et onlineMeetingProvider
  • La périodicité nécessite à la fois des objets de modèle et de plage
  • Les fuseaux horaires doivent être cohérents entre les heures de début et de fin
  • TransactionId Permet idempotent la création d’événements