Αναφορά χρήστη (προεπισκόπηση)

Σημείωμα

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

Σημαντικό

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

• 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_MeServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MeServer	Χρήστης	Εργαλεία αυτογνωσίας και οργανωσιακής επίγνωσης. Χρησιμοποιήστε αυτό το εργαλείο για να αποκτήσετε πρόσβαση σε προφίλ χρηστών στον οργανισμό σας και να εκτελέσετε διάφορες ενέργειες, όπως λήψη του προφίλ σας, προφίλ χρήστη, διαχειριστή χρήστη ή άμεσες αναφορές.

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

mcp_graph_getDirectReports

Εμφανίζει τις άμεσες αναφορές ενός καθορισμένου χρήστη στον κατάλογο. Πρέπει να καταχωρήσετε είτε το αναγνωριστικό αντικειμένου του χρήστη (GUID) είτε το δικό του userPrincipalName (UPN που μοιάζει με ηλεκτρονικό ταχυδρομείο). Μην χρησιμοποιείτε το me ως το userIdentifier.

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

• userIdentifier: Αναγνωριστικό αντικειμένου χρήστη (GUID) ή userPrincipalName (UPN)

Σημείωμα

Μην στέλνετε me ως userIdentifier. Εάν υπάρχει μόνο εμφανιζόμενο όνομα, αναζητήστε πρώτα τον χρήστη για λήψη userPrincipalName ή αναγνωριστικό αντικειμένου.

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

• Επιλέξτε: Λίστα ιδιοτήτων διαχωρισμένων με κόμματα για επιστροφή (για παράδειγμα, id, displayName, mail, jobTitle) userPrincipalName
• κορυφή: Ο αριθμός των στοιχείων που θα επιστραφούν ανά σελίδα

mcp_graph_getMyManager

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

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

• διαλέγω: Λίστα ιδιοτήτων διευθυντή διαχωρισμένων με κόμματα για επιστροφή

mcp_graph_getMyProfile

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

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

• διαλέγω: Λίστα ιδιοτήτων προφίλ χρήστη διαχωρισμένων με κόμματα
• Αναπτύξτε: Ανάπτυξη σχετικών πινάκων (για παράδειγμα, manager, directReports)

mcp_graph_getUserProfile

Ανακτά το προφίλ ενός καθορισμένου χρήστη στον κατάλογο. Πρέπει να καταχωρήσετε είτε το αναγνωριστικό αντικειμένου του χρήστη (GUID) είτε το δικό του userPrincipalName (UPN που μοιάζει με ηλεκτρονικό ταχυδρομείο). Μην χρησιμοποιείτε το me ως το userIdentifier. Για τον συνδεδεμένο χρήστη, χρησιμοποιήστε mcp_graph_getMyProfile.

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

• userIdentifier: Αναγνωριστικό αντικειμένου χρήστη (GUID) ή userPrincipalName (UPN)

Σημείωμα

Μην στείλεις εμένα. Εάν είναι διαθέσιμο μόνο το εμφανιζόμενο όνομα, αναζητήστε πρώτα τον χρήστη.

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

• διαλέγω: Λίστα ιδιοτήτων χρήστη διαχωρισμένων με κόμματα για επιστροφή
• Αναπτύξτε: Αναπτύξτε έναν σχετικό πίνακα (manager OR directReports). Μπορείτε να αναπτύξετε μόνο μία ιδιότητα ανά αίτηση.

mcp_graph_getUsersManager

Ανακτά τη διαχείριση ενός καθορισμένου χρήστη στον κατάλογο. Εισαγάγετε είτε το αναγνωριστικό αντικειμένου του χρήστη (GUID) είτε το δικό του userPrincipalName (UPN που μοιάζει με ηλεκτρονικό ταχυδρομείο). Μην χρησιμοποιείτε το me ως το userIdentifier. Για τον συνδεδεμένο χρήστη, χρησιμοποιήστε mcp_graph_getMyManager.

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

• userIdentifier: Αναγνωριστικό αντικειμένου χρήστη (GUID) ή userPrincipalName (UPN)

Σημείωμα

Μην στείλεις εμένα. Εάν είναι διαθέσιμο μόνο το εμφανιζόμενο όνομα, αναζητήστε πρώτα τον χρήστη.

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

• Επιλέξτε: Λίστα ιδιοτήτων διαχωρισμένων με κόμματα για επιστροφή για τον διευθυντή, όπως id, displayName, mail, jobTitle, userPrincipalName

mcp_graph_listUsers

Ανακτά μια λίστα χρηστών στον οργανισμό. Υποστηρίζει επιλογές ερωτημάτων όπως $select, $filter, $top, $orderby. Η προεπιλογή ConsistencyLevel είναι τελικά.

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

• Κορυφή: Εμφάνιση μόνο των πρώτων n χρηστών
• διαλέγω: Λίστα ιδιοτήτων χρήστη διαχωρισμένων με κόμματα για επιστροφή
• Φίλτρο: Φιλτράρισμα χρηστών κατά ιδιότητα, όπως startswith(displayName,'A')
• Orderby: Παραγγελία αποτελεσμάτων βάσει δεδομένης ιδιότητας, όπως displayName
• αναζήτηση: Αναζήτηση ελεύθερου κειμένου για χρήστες. Μορφή: "property:value", όπως displayName:Neha για αναζήτηση εμφανιζόμενων ονομάτων που περιέχουν Neha. Υποστηρίζει πολλές ιδιότητες με κενά διαστήματα. Εναλλακτικός κανόνας: Εάν $search αποτύχει ή δεν επιστρέψει κανένα αποτέλεσμα, δοκιμάστε ξανά αυτόματα με $filterτο .
• Αρίθμηση: Συμπερίληψη πλήθους στοιχείων (true ή false)
• ConsistencyLevel: Απαιτούμενη κεφαλίδα για σύνθετα ερωτήματα (προεπιλογή: τελικό)

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

Αυτογνωσία

• Αποκτήστε το προφίλ του συνδεδεμένου χρήστη.
• Λάβετε τον προϊστάμενο του συνδεδεμένου χρήστη.
• Αποκτήστε πρόσβαση στις τρέχουσες πληροφορίες περιβάλλοντος χρήστη.
• Δεν χρειάζεται αναγνωριστικό χρήστη.

Προφίλ χρηστών

• Ανάκτηση του προφίλ οποιουδήποτε χρήστη μέσω ID ή UPN.
• Αποκτήστε πρόσβαση σε ιδιότητες χρήστη όπως displayName, mail, jobTitleκαι πολλά άλλα.
• Αναπτύξτε σχετικούς πίνακες όπως manager και directReports.
• Επιλέξτε ιδιότητες χρησιμοποιώντας το $select.

Ιεραρχία οργανισμού

• Αποκτήστε τον προϊστάμενο ενός χρήστη.
• Λήψη των άμεσων αναφορών ενός χρήστη.
• Περιηγηθείτε στη δομή αναφορών.
• Διαχείριση και άμεσες σχέσεις αναφορών.

Εντοπισμός χρήστη

• Λίστα χρηστών στον οργανισμό.
• Αναζήτηση ελεύθερου κειμένου με αυτόματη επιστροφή.
• Φιλτράρισμα και ταξινόμηση OData.
• Υποστήριξη σελιδοποίησης.
• Καταμέτρηση χρηστών στα αποτελέσματα.

Δυνατότητες ερωτημάτων

• OData $select για την επιλογή ιδιότητας.
• OData $filter για φιλτράρισμα χρηστών.
• OData $expand για σχετικές οντότητες.
• OData $orderby για ταξινόμηση.
• $search ελεύθερου κειμένου με εφεδρική επιλογή.
• Υποστήριξη ενδεχόμενης συνέπειας

Σημειώσεις

• Χρησιμοποιήστε mcp_graph_getMyProfile το για τον συνδεδεμένο χρήστη, όχι mcp_graph_getUserProfile μαζί μου.
• Χρησιμοποιήστε το mcp_graph_getMyManager για τον προϊστάμενο του συνδεδεμένου χρήστη.
• userIdentifier πρέπει να είναι αναγνωριστικό αντικειμένου (GUID) ή userPrincipalName (UPN), μην χρησιμοποιείτε εμφανιζόμενο όνομα.
• Εάν είναι διαθέσιμο μόνο το εμφανιζόμενο όνομα, χρησιμοποιήστε το mcp_graph_listUsers για να αναζητήσετε πρώτα τον χρήστη.
• $expand Μπορεί να αναπτύξει μόνο μία ιδιότητα ανά αίτηση (manager ή directReports).
• $search Το έχει αυτόματη επιστροφή σε $filter εάν αποτύχει η αναζήτηση.
• Το ConsistencyLevel απαιτείται τελικά για σύνθετα ερωτήματα.
• Μορφή αναζήτησης: "property:value" με εισαγωγικά.

Υποθέσεις συνήθους χρήσης

Λήψη των πληροφοριών μου

• Χρησιμοποιήστε το mcp_graph_getMyProfile για να λάβετε το προφίλ του τρέχοντος χρήστη.
• Χρησιμοποιήστε το mcp_graph_getMyManager για να λάβετε τον διαχειριστή του τρέχοντος χρήστη.

Εύρεση χρήστη

• Χρησιμοποιήστε mcp_graph_listUsers το με την παράμετρο αναζήτησης.

  Παράδειγμα: search='"displayName:John"' για να βρείτε χρήστες με το όνομα Γιάννης.

• Λήψη userPrincipalName ή αναγνωριστικού αντικειμένου από τα αποτελέσματα.

Λήψη λεπτομερειών χρήστη

• Χρησιμοποιήστε το mcp_graph_getUserProfile με το userIdentifier.
• Χρησιμοποιήστε select το για να λάβετε συγκεκριμένες ιδιότητες.
• Χρησιμοποιήστε το expand για να συμπεριλάβετε manager ή directReports.

Λήψη οργανωτικής δομής

• Χρησιμοποιήστε mcp_graph_getUsersManager το για να λάβετε τον προϊστάμενο ενός χρήστη.
• Χρησιμοποιήστε mcp_graph_getDirectReports το για να λάβετε τις άμεσες αναφορές ενός χρήστη.
• Κλήσεις αλυσίδας για περιήγηση στην ιεραρχία αναφορών.