Références de calendrier Work IQ (aperçu)

Aperçu

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 :

• objet : Objet/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: Clause 'Order By'

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

Fonctions principales

Gestion des événements

• Créer, lire, mettre à jour et supprimer les événements
• Accepter, refuser et annuler des invitations
• Prise en charge des événements périodiques
• Intégration à des réunions en ligne (Teams, Skype)

Disponibilité et planification

• Obtenir des créneaux libres/occupés
• Rechercher les heures de réunion avec la vérification de la disponibilité
• Affichage Calendrier avec filtrage d’intervalles de temps
• Analyse de la disponibilité des participants

Gestion des participants

• Gérer les participants requis, facultatifs et de ressources
• Support des propositions de créneaux horaires
• Suivre les réponses
• Prise en charge des listes de distribution

Critères de périodicité

• Chaque jour, chaque semaine, deux fois par semaine, chaque mois et chaque année
• Périodicité absolue et relative
• Date de fin ou nombre d’occurrences
• Spécifications de jour de semaine et de 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

Notes

• 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 motif 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