Αναφορά ημερολογίου (προεπισκόπηση)

Σημείωμα

Αυτό το άρθρο περιγράφει δυνατότητες που χρησιμοποιούνται σε παράγοντες ή ροές παραγόντων που υποστηρίζονται από την τυπική πλεξούδα.

Σημαντικό

Αυτή είναι μια δυνατότητα προεπισκόπησης.

• Microsoft κυκλοφορεί δυνατότητες προεπισκόπησης πριν από μια επίσημη κυκλοφορία, έτσι ώστε οι πελάτες να αποκτήσουν πρώιμη πρόσβαση και να παρέχουν σχόλια.
• Οι δυνατότητες προεπισκόπησης έχουν περιορισμένη λειτουργικότητα και δεν προορίζονται για χρήση στην παραγωγή.
• Microsoft μπορεί να αλλάξουν τα ονόματα και τις παραμέτρους των εργαλείων MCP προεπισκόπησης. Αποφύγετε τις εξαρτήσεις που είναι ενσωματωμένες στον κώδικα. Microsoft διατηρεί την υποστήριξη σεναρίου.
• Οι δυνατότητες προεπισκόπησης υπόκεινται στο Microsoft συμπληρωματικοί όροι χρήσης.

Σημείωμα

Τα εργαλεία Microsoft 365 MCP για συγκεκριμένες εφαρμογές (Copilot, Ημερολόγιο, Αλληλογραφία, SharePoint, OneDrive, Teams, User και Word) προορίζονται μόνο για σκοπούς συμβατότητας με προηγούμενες εκδόσεις και δεν πρέπει να χρησιμοποιούνται σε περιβάλλοντα παραγωγής ή νέα έργα. Για νέα έργα που απαιτούν πρόσβαση σε πόρους του Microsoft 365, χρησιμοποιήστε το Work IQ MCP με την πλεξούδα GitHub Copilot. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Work IQ MCP στο Copilot Studio.

Επισκόπηση

Αναγνωριστικό διακομιστή	Διεύθυνση URL σε επίπεδο μισθωτή	Εμφανιζόμενο όνομα	Περιγραφή
mcp_CalendarTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_CalendarTools	Ημερολόγιο	Εργαλεία για λειτουργίες ημερολογίου όπως δημιουργία, ενημέρωση, ανάκτηση συμβάντων, διαχείριση προσκλήσεων και έλεγχος διαθεσιμότητας.

Διαθέσιμα εργαλεία

mcp_CalendarTools_graph_acceptEvent

Αποδεχτείτε την καθορισμένη πρόσκληση συμβάντος στο ημερολόγιο ενός χρήστη.

Απαιτούμενες παράμετροι:

• eventId: Το αναγνωριστικό του συμβάντος προς αποδοχή

Προαιρετικές παράμετροι:

• userId: Αναγνωριστικό χρήστη ή userPrincipalName
• comment: Προαιρετικό κείμενο που περιλαμβάνεται στην απάντηση
• sendResponse: Εάν θα σταλεί απάντηση στον διοργανωτή

mcp_CalendarTools_graph_cancelEvent

Ακυρώστε ένα συμβάν στο ημερολόγιο ενός καθορισμένου χρήστη και ειδοποιήστε τους συμμετέχοντες.

Απαιτούμενες παράμετροι:

• eventId: Το μοναδικό αναγνωριστικό του συμβάντος για ακύρωση

Προαιρετικές παράμετροι:

• userId: Αναγνωριστικό χρήστη ή userPrincipalName
• comment: Προαιρετικό μήνυμα ακύρωσης

mcp_CalendarTools_graph_createEvent

Δημιουργήστε ένα νέο συμβάν ημερολογίου στο ημερολόγιο ενός καθορισμένου χρήστη. Υποστηρίζει επαναλαμβανόμενες εκδηλώσεις και ηλεκτρονικές συσκέψεις.

Απαιτούμενες παράμετροι:

• θέμα: Θέμα συμβάντος ή τίτλος (καμία τιμή)
• start: Έναρξη χρονικής σήμανσης με dateTime και timeZone
• end: Λήξη χρονικής σήμανσης με dateTime και timeZone
• attendees_addresses: Πίνακας διευθύνσεων ηλεκτρονικού ταχυδρομείου συμμετεχόντων

Προαιρετικές παράμετροι:

• userId: Αναγνωριστικό χρήστη ή userPrincipalName
• body: Σώμα συμβάντος με contentType (Κείμενο/HTML) και περιεχόμενο
• τοποθεσία: Τοποθεσία με displayName
• attendees_types: Ρόλοι συμμετεχόντων (υποχρεωτικό, προαιρετικό, πόρος)
• attendees_names: Εμφανιζόμενα ονόματα συμμετεχόντων
• περιοδικότητα: Μοτίβο και περιοχή περιοδικότητας
• isOnlineMeeting: Ορίστε την τιμή σε true για διαδικτυακή σύσκεψη
• onlineMeetingProvider: teamsForBusiness, , skypeForBusinessskypeForConsumer
• allowNewTimeProposals: Να επιτρέπονται προτάσεις χρόνου (προεπιλογή: true)
• transactionId: Idempotence αναγνωριστικό

mcp_CalendarTools_graph_declineEvent

Απορρίψτε την καθορισμένη πρόσκληση συμβάντος στο ημερολόγιο ενός χρήστη.

Απαιτούμενες παράμετροι:

• eventId: Το αναγνωριστικό του συμβάντος προς απόρριψη

Προαιρετικές παράμετροι:

• userId: Αναγνωριστικό χρήστη ή userPrincipalName

• comment: Προαιρετικό κείμενο στην απάντηση

• sendResponse: Εάν θα γίνει αποστολή απόκρισης

mcp_CalendarTools_graph_deleteEvent

Διαγράψτε ένα συμβάν από το ημερολόγιο ενός καθορισμένου χρήστη.

Απαιτούμενες παράμετροι:

• eventId: Το μοναδικό αναγνωριστικό του συμβάντος που θα διαγραφεί

Προαιρετικές παράμετροι:

• userId: Αναγνωριστικό χρήστη ή userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Προτείνετε χρόνους και τοποθεσίες σύσκεψης με βάση τη διαθεσιμότητα των διοργανωτών και συμμετεχόντων.

Απαιτούμενες παράμετροι:

• meetingDuration: Διάρκεια σύσκεψης (για παράδειγμα, 'PT1H')

Προαιρετικές παράμετροι:

• userId: Αναγνωριστικό διοργανωτή ή userPrincipalName
• attendees_addresses: Διευθύνσεις ηλεκτρονικού ταχυδρομείου συμμετεχόντων
• attendees_types: Τύποι συμμετεχόντων
• attendees_names: Εμφανιζόμενα ονόματα συμμετεχόντων
• χρονικός περιορισμός: Διαθεσιμότητα ώρας με timeslots και activityDomain
• locationConstraint: Επιλογές τοποθεσίας
• maxCandidates: Μέγιστες προτάσεις
• isOrganizerOptional: Προαιρετική σημαία διοργανωτή
• returnSuggestionReasons: Συμπερίληψη λόγων
• minimumAttendeePercentage: Ελάχιστο όριο συμμετοχής

mcp_CalendarTools_graph_getEvent

Λάβετε ένα μοναδικό συμβάν ημερολογίου από το ημερολόγιο ενός καθορισμένου χρήστη.

Απαιτούμενες παράμετροι:

• eventId: Το μοναδικό αναγνωριστικό του συμβάντος

Προαιρετικές παράμετροι:

• userId: Αναγνωριστικό χρήστη ή userPrincipalName
• select: Παράμετρος ερωτήματος OData \$select
• expand: OData \$expand για ιδιότητες περιήγησης

mcp_CalendarTools_graph_getSchedule

Λάβετε το ελεύθερο/κατειλημμένο χρονοδιάγραμμα για έναν χρήστη, μία λίστα διανομής ή έναν πόρο.

Απαιτούμενες παράμετροι:

• schedules: Διευθύνσεις SMTP χρηστών ή πόρων
• startTime: Ώρα έναρξης με dateTime και timeZone
• endTime: Ώρα λήξης με dateTime και timeZone

Προαιρετικές παράμετροι:

• userId: Αναγνωριστικό χρήστη ή userPrincipalName
• availabilityViewInterval: Χρονική περίοδος σε λεπτά

mcp_CalendarTools_graph_listCalendarView

Ανάκτηση εμφανίσεων ημερολογίου εντός ενός καθορισμένου χρονικού εύρους για έναν χρήστη.

Απαιτούμενες παράμετροι:

• startDateTime: Εύρος ώρας έναρξης (ISO 8601)
• endDateTime: Λήξη χρονικού εύρους (ISO 8601)

Προαιρετικές παράμετροι:

• userId: Αναγνωριστικό χρήστη ή userPrincipalName
• top: Μέγιστος αριθμός συμβάντων
• orderby: ρήτρα order by

mcp_CalendarTools_graph_listEvents

Ανακτήστε μια λίστα συμβάντων από το ημερολόγιο ενός καθορισμένου χρήστη.

Προαιρετικές παράμετροι:

• userId: Αναγνωριστικό χρήστη ή userPrincipalName
• startDateTime: Εύρος ώρας έναρξης (ISO 8601)
• endDateTime: Λήξη χρονικού εύρους (ISO 8601)
• top: Μέγιστος αριθμός συμβάντων
• filter: Ερώτημα φίλτρου OData
• orderby: Σειρά δεδομένων OData κατά ερώτημα

mcp_CalendarTools_graph_updateEvent

Ενημερώστε ένα υπάρχον συμβάν ημερολογίου στο ημερολόγιο ενός καθορισμένου χρήστη.

Απαιτούμενες παράμετροι:

• eventId: Το μοναδικό αναγνωριστικό του συμβάντος

Προαιρετικές παράμετροι:

• userId: Αναγνωριστικό χρήστη ή userPrincipalName
• θέμα: Ενημερωμένο θέμα
• σώμα: Ενημερωμένο περιεχόμενο σώματος
• start: Ενημερώθηκε η ώρα έναρξης
• end: Ενημερώθηκε η ώρα λήξης
• location: Ενημερωμένη θέση
• attendees_addresses: Ενημερωμένα μηνύματα ηλεκτρονικού ταχυδρομείου συμμετεχόντων
• attendees_types: Ενημερωμένοι τύποι συμμετεχόντων
• attendees_names: Ενημερώθηκαν τα ονόματα συμμετεχόντων
• isCancelled: Ορίστε την σε true για ακύρωση
• περιοδικότητα: Ενημερωμένο μοτίβο περιοδικότητας

Δυνατότητες κλειδιά

Διαχείριση εκδηλώσεων

• Δημιουργήστε, διαβάστε, ενημερώστε και διαγράψτε συμβάντα.
• Αποδοχή, απόρριψη και ακύρωση προσκλήσεων.
• Υποστήριξη για επαναλαμβανόμενα συμβάντα.
• Ενοποίηση με διαδικτυακές συναντήσεις (Teams, skype).

Διαθεσιμότητα και προγραμματισμός

• Αποκτήστε προγράμματα διαθεσιμότητας/απασχόλησης.
• Βρείτε ώρες συνάντησης με έλεγχο διαθεσιμότητας.
• Προβολή ημερολογίου με φιλτράρισμα χρονικού εύρους.
• Ανάλυση διαθεσιμότητας συμμετεχόντων.

Διαχείριση συμμετεχόντων

• Διαχειριστείτε τους συμμετέχοντες, τους απαιτούμενους, τους προαιρετικούς και τους πόρους.
• Υποστήριξη για προτάσεις χρόνου.
• Παρακολουθήστε τις απαντήσεις.
• Υποστήριξη για λίστες διανομής.

Μοτίβα περιοδικότητας

• Καθημερινά, εβδομαδιαία, μηνιαία και ετήσια μοτίβα.
• Απόλυτη και σχετική υποτροπή.
• Ημερομηνία λήξης ή πλήθος περιστατικών.
• Προδιαγραφές ημέρας της εβδομάδας και μήνα.

Ηλεκτρονικές συσκέψεις

• Ενοποίηση με το Teams για επιχειρήσεις
• Υποστήριξη για το Skype για επιχειρήσεις
• Υποστήριξη για skype (για προσωπική χρήση)
• Αυτόματη δημιουργία σύνδεσης σύσκεψης

Σημειώσεις

• Όλα τα χρονικά σημάνσεις χρησιμοποιούν μορφή UTC/ISO 8601 με ζώνη ώρας
• Το MCP ημερολογίου βασίζεται στον UserprofileMCP εντοπισμό χρηστών στον οργανισμό
• Οι διευθύνσεις ηλεκτρονικού ταχυδρομείου πρέπει να είναι έγκυρης μορφής
• Οι πίνακες συμμετεχόντων (διευθύνσεις, τύποι, ονόματα) πρέπει να είναι με την ίδια σειρά
• Οι ηλεκτρονικές συσκέψεις απαιτούν isOnlineMeeting=true και onlineMeetingProvider
• Η περιοδικότητα απαιτεί αντικείμενα μοτίβου και περιοχής
• Οι ζώνες ώρας πρέπει να είναι συνεπείς στις ώρες έναρξης και λήξης
• TransactionId ενεργοποιεί idempotent τη δημιουργία συμβάντων