הפניה למשתמש (תצוגה מקדימה)

הערה

מאמר זה מתאר תכונות המשמשות בסוכנים או בזרימות סוכנים המופעלים על ידי הרתמה הסטנדרטית.

חשוב

‏‫‏‫זוהי תכונת Preview.‬‬

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

הערה

כלי MCP של Microsoft 365 ייעודיים ליישום (Copilot, Calendar, Mail, 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.

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

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

הערה

אל תשלח me כ-userIdentifier. אם רק שם התצוגה זמין, חפש תחילה את המשתמש כדי להשיג או userPrincipalName מזהה אובייקט.

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

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

mcp_graph_getMyManager

מאחזר את המנהל של המשתמש המחובר (המחייג). נקודת קצה זו מחזירה תמיד את המנהל של הקשר המשתמש הנוכחי.

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

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

mcp_graph_getMyProfile

מאחזר את פרטי הפרופיל של המשתמש המחובר (מתקשר). נקודת קצה זו מחזירה תמיד את הפרופיל של הקשר המשתמש הנוכחי.

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

• בחר: רשימה מופרדת באמצעות פסיק של מאפייני פרופיל משתמש
• להרחיב: הרחב טבלאות קשורות (לדוגמה, מנהל, directReports)

mcp_graph_getUserProfile

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

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

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

הערה

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

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

• בחר: רשימה מופרדת באמצעות פסיק של מאפייני משתמש להחזרה
• להרחיב: הרחב טבלה קשורה (מנהל או 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. ברירת ConsistencyLevel המחדל היא במקרה.

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

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

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

ידע עצמי

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

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

• אחזר פרופיל של משתמש כלשהו לפי מזהה או UPN.
• גש למפרטי משתמש כגון displayName, mailjobTitle, , ועוד.
• הרחב טבלאות קשורות כגון 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 יכול להרחיב מאפיין אחד בלבד לכל בקשה ( אוmanagerdirectReports).
• $search כולל חזרה אוטומטית למצב אם $filter החיפוש נכשל.
• ConsistencyLevel eventual נדרש עבור שאילתות מתקדמות.
• תבנית חיפוש: "property:value" עם מרכאות.

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

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

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

חיפוש משתמש

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

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

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

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

• השתמש mcp_graph_getUserProfile עם userIdentifier.
• השתמש select כדי לקבל מאפיינים ספציפיים.
• בשימוש expand לכלול manager או directReports.

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

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