שתף דרך


חומר עזר עבור Microsoft 365 User Profile MCP Server

חשוב

עליך להיות חלק מתוכנית התצוגה המקדימה של Frontier כדי לקבל גישה מוקדמת ל - Microsoft Agent 365. Frontier מחברת אתכם ישירות עם החידושים האחרונים של Microsoft בתחום הבינה המלאכותית. קבל תכונות פורצות דרך מעשיות, שתף את התובנות שלך עם צוותי מוצרים ועזור לעצב את עתיד הבינה המלאכותית. תצוגות מקדימות של Frontier כפופות לתנאי התצוגה המקדימה הקיימים של הסכמי הלקוחות שלך. כאשר תכונות אלה עדיין בפיתוח, הזמינות והיכולות שלהן עשויות להשתנות עם הזמן.'

מבט כולל

מזהה שרת שם תצוגה תיאור
mcp_MeServer Microsoft 365 פרופיל משתמש MCP Server שרת MCP עבור ידע עצמי ומודעות ארגונית. השתמש בשרת MCP זה כדי לגשת לפרופילי משתמשים בארגון שלך ולבצע פעולות שונות כגון קבלת הפרופיל שלך, פרופיל משתמש, מנהל משתמש או דוחות ישירים.

כלים זמינים

mcp_graph_getDirectReports

פרט את הדוחות הישירים של משתמש שצוין במדריך הכתובות. עליך לספק את מזהה האובייקט (GUID) של המשתמש או את userPrincipalName שלו (UPN הכלול בדואר אלקטרוני). אל תשתמש ב- 'me' כ- 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 במקום זאת עבור המשתמש המחובר.

פרמטרים נדרשים:

  • מזהה משתמש: מזהה האובייקט (GUID) של המשתמש או userPrincipalName (UPN)

הערה

אל תשלח 'אותי'. אם רק שם התצוגה זמין, חפש תחילה את המשתמש.

פרמטרים אופציונליים:

  • בחר: רשימה מופרדת באמצעות פסיק של מאפייני משתמש להחזרה
  • להרחיב: הרחבת ישות קשורה (manager OR directReports). באפשרותך להרחיב מאפיין אחד בלבד לכל בקשה.

mcp_graph_getUsersManager (ניהול_משתמשים)

אחזר את המנהל של משתמש שצוין במדריך הכתובות. עליך לספק את מזהה האובייקט (GUID) של המשתמש או את userPrincipalName שלו (UPN הכלול בדואר אלקטרוני). אל תשתמש ב- 'me' כ- userIdentifier - mcp_graph_getMyManager במקום זאת עבור המשתמש המחובר.

פרמטרים נדרשים:

  • מזהה משתמש: מזהה האובייקט (GUID) של המשתמש או userPrincipalName (UPN)

הערה

אל תשלח 'אותי'. אם רק שם התצוגה זמין, חפש תחילה את המשתמש.

פרמטרים אופציונליים:

  • בחר: רשימת מאפיינים המופרדים באמצעות פסיקים להחזרה עבור המנהל (לדוגמה, id,displayName,mail,jobTitle,userPrincipalName)

mcp_graph_listUsers

אחזר רשימת משתמשים בארגון. תמיכה באפשרויות שאילתה כגון $select, $filter, $top, $orderby. רמת העקביות מוגדרת כברירת מחדל ל-"eventual".

פרמטרים אופציונליים:

  • סביבון: הצג רק את n המשתמשים הראשונים
  • בחר: רשימה מופרדת באמצעות פסיק של מאפייני משתמש להחזרה
  • מסנן: סנן משתמשים לפי מאפיין (לדוגמה, startswith(displayName,'A'))
  • סדר לפי: תוצאות הזמנה לפי מאפיין נתון (לדוגמה displayName)
  • חיפוש: חיפוש טקסט חופשי עבור משתמשים. תבנית: '"property:value"", לדוגמה, '"displayName:Neha"' כדי לחפש שמות תצוגה המכילים 'Neha'. תומך בריבוי מאפיינים עם רווחים. כלל חזרה למצב קודם: אם $search נכשל או אינו מחזיר תוצאות, נסה שוב באופן אוטומטי עם $filter.
  • מנה: כלול ספירת פריטים ('true' או 'false')
  • עקביותרמה: כותרת נדרשת עבור שאילתות מתקדמות (ברירת מחדל: 'eventual')

תכונות מרכזיות

הכרת העצמי

  • קבל פרופיל משתמש מחובר
  • קבל את המנהל של המשתמש שנכנס
  • גישה למידע תלוי הקשר של המשתמש הנוכחי
  • אין צורך במזהי משתמש

פרופילי משתמשים

  • אחזר פרופיל של משתמש כלשהו לפי מזהה או UPN
  • מאפייני משתמש של Access (displayName, mail, jobTitle וכולי)
  • הרחבת ישויות קשורות (מנהל, directReports)
  • בחירת מאפיין עם $select

הירארכיה ארגונית

  • קבל את מנהל המשתמש
  • קבל דוחות ישירים של המשתמש
  • נווט במבנה הדיווח
  • יחסי עבודה בין מנהל למדווחים הישירים

גילוי משתמשים

  • פרט משתמשים בארגון
  • חיפוש טקסט חופשי עם גיבוי אוטומטי
  • סינון ומיון של OData
  • תמיכה בחלוקה לעמודים
  • ספירת משתמשים בתוצאות

יכולות שאילתה

  • OData $select לבחירת מאפיינים
  • OData $filter עבור סינון משתמשים
  • OData $expand עבור ישויות קשורות
  • OData $orderby למיון
  • טקסט חופשי $search עם גיבוי
  • תמיכה בעקביות בסופו של דבר

הערות

  1. השתמש mcp_graph_getMyProfile עבור משתמש מחובר, ולא mcp_graph_getUserProfile עם 'me'
  2. שימוש mcp_graph_getMyManager עבור מנהל המשתמשים המחוברים
  3. המזהה_המשתמש חייב להיות ID אובייקט (GUID) או userPrincipalName (UPN), ולא שם תצוגה
  4. אם רק שם התצוגה זמין, השתמש mcp_graph_listUsers כדי לחפש תחילה את המשתמש
  5. $expand להרחיב מאפיין אחד בלבד לכל בקשה (manager OR directReports)
  6. $search כולל גיבוי אוטומטי ל- $filter אם החיפוש נכשל
  7. ConsistencyLevel 'eventual' הנדרש עבור שאילתות מתקדמות
  8. תבנית חיפוש: '"property:value"' עם מרכאות

מקרי שימוש נפוצים

קבל את המידע שלי

  • השתמש mcp_graph_getMyProfile כדי לקבל את פרופיל המשתמש הנוכחי
  • השתמש mcp_graph_getMyManager כדי לקבל את המנהל הנוכחי של המשתמש

2. חיפוש משתמש

  • שימוש mcp_graph_listUsers עם פרמטר חיפוש

    לדוגמה: search='"displayName:John"' כדי למצוא משתמשים בשם John

  • קבל userPrincipalName או מזהה אובייקט מהתוצאות

3. קבל פרטי משתמש

  • שימוש ב-mcp_graph_getUserProfile עם userIdentifier
  • השתמש ב'בחר' כדי לקבל מאפיינים ספציפיים
  • שימוש בהרחבה כדי לכלול מנהלי התקנים או DirectReports

4. קבל מבנה ארגוני

  • השתמש mcp_graph_getUsersManager כדי לקבל מנהל של משתמש
  • שימוש mcp_graph_getDirectReports כדי לקבל דוחות ישירים של משתמש
  • שיחות שרשרת לניווט בהירארכיית דיווח