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

Il s’agit d’une fonctionnalité 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.

Aperçu

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: 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

Fonctionnalités clés

Gestion d’événement

  • 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

  • Prenez des emplois du temps libres ou chargés.
  • 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 d’horaires.
  • 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 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