Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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
dateTimeettimeZone -
end : Horodatage de fin avec
dateTimeettimeZone - 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 :
Idempotenceidentificateur
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
userPrincipalNamecommentaire : 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
timeslotsetactivityDomain - 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
\$expandpour 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
dateTimeettimeZone -
endTime : heure de fin avec
dateTimeettimeZone
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
UserprofileMCPpour 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=trueetonlineMeetingProvider - 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
-
TransactionIdPermetidempotentla création d’événements