Benutzerreferenz (Vorschau)

Overview

Verfügbare Tools

mcp_graph_getDirectReports

Listet die direkten Berichte eines angegebenen Benutzers im Verzeichnis auf. Du musst entweder die Objekt-ID des Nutzers (GUID) oder deren userPrincipalName (e-mailähnliches UPN) angeben. Verwenden Sie me nicht als userIdentifier.

Erforderliche Parameter:

• userIdentifier: Benutzerobjekt-ID (GUID) oder userPrincipalName (UPN)

Optionale Parameter:

• Auswählen: Komma-separierte Liste von zu zurückgebenden Eigenschaften (zum Beispiel id, displayName, mail, jobTitle, ) userPrincipalName
• Oberste: Anzahl der Elemente, die pro Seite zurückgegeben werden sollen

mcp_graph_getMyManager

Ruft den Vorgesetzten des angemeldeten Benutzers (der Anrufer) ab. Dieser Endpunkt gibt immer den Vorgesetzten des aktuellen Benutzerkontexts zurück.

Optionale Parameter:

• Auswählen: Kommagetrennte Liste der Managereigenschaften, die zurückgegeben werden sollen

mcp_graph_getMyProfile

Ruft die Profildetails des angemeldeten Benutzers (der Anrufer) ab. Dieser Endpunkt gibt immer das Profil des aktuellen Benutzerkontexts zurück.

Optionale Parameter:

• Auswählen: Kommagetrennte Liste der Benutzerprofileigenschaften
• Erweitern: Erweitern Sie verwandte Tabellen (zum Beispiel Manager, directReports)

mcp_graph_getUserProfile

Ruft das Profil eines angegebenen Benutzers im Verzeichnis ab. Du musst entweder die Objekt-ID des Nutzers (GUID) oder deren userPrincipalName (e-mailähnliches UPN) angeben. Verwenden Sie me nicht als userIdentifier. Verwenden Sie mcp_graph_getMyProfilefür den angemeldeten Benutzer .

Erforderliche Parameter:

• userIdentifier: Benutzerobjekt-ID (GUID) oder userPrincipalName (UPN)

Optionale Parameter:

• Auswählen: Kommagetrennte Liste der Benutzereigenschaften, die zurückgegeben werden sollen
• Erweitern: Erweitern Sie eine verwandte Tabelle (Manager ODER directReports). Sie können pro Anforderung nur eine Eigenschaft erweitern.

mcp_graph_getUsersManager

Ruft den Vorgesetzten eines angegebenen Benutzers im Verzeichnis ab. Geben Sie entweder die Objekt-ID (GUID) des Benutzers oder deren userPrincipalName (E-Mail-ähnliche UPN) an. Verwenden Sie me nicht als userIdentifier. Verwenden Sie mcp_graph_getMyManagerfür den angemeldeten Benutzer .

Erforderliche Parameter:

• userIdentifier: Benutzerobjekt-ID (GUID) oder userPrincipalName (UPN)

Optionale Parameter:

• select: Kommagetrennte Liste von Eigenschaften, die für Manager zurückgegeben werden sollen, z. B. id, displayName, mail, jobTitle, userPrincipalName

mcp_graph_listUsers

Ruft eine Liste der Benutzer in der Organisation ab. Unterstützt Abfrageoptionen wie $select, $filter, $top, . $orderby Der Standardwert ConsistencyLevel ist „eventual“.

Optionale Parameter:

• Nach oben: Nur die ersten n Benutzer anzeigen
• Auswählen: Kommagetrennte Liste der Benutzereigenschaften, die zurückgegeben werden sollen
• Filter: Filtern Sie Benutzer nach Eigenschaft, wie zum Beispiel startswith(displayName,'A')
• OrderBy: Ordnung ergibt sich nach gegebener Eigenschaft, wie zum Beispiel displayName
• Suche: Freitextsuche für Benutzer. Format: "property:value", z. B. displayName:Neha zum Durchführen einer Suche in Anzeigenamen, die Neha enthalten. Unterstützt mehrere Eigenschaften mit Leerzeichen. Fallbackregel: Wenn $search ein Fehler auftritt oder keine Ergebnisse zurückgibt, versuchen Sie es automatisch erneut.$filter
• Count: Anzahl von Elementen einschließen (wahr oder falsch)
• ConsistencyLevel: Erforderlicher Header für erweiterte Abfragen (Standard: eventual)

Wichtigste Funktionen

Selbsterkenntnis

• Rufen Sie das Profil des angemeldeten Benutzers ab.
• Rufen Sie den Vorgesetzten des angemeldeten Benutzers ab.
• Zugreifen auf aktuelle Benutzerkontextinformationen.
• Keine Notwendigkeit für Benutzerbezeichner.

Benutzerprofile

• Rufen Sie das Profil eines benutzers nach ID oder UPN ab.
• Greifen Sie auf Benutzereigenschaften wie displayName, mail, jobTitle, und mehr zu.
• Erweitern Sie verwandte Tabellen wie manager und directReports.
• Wählen Sie Eigenschaften mithilfe von $select.

Organisationshierarchie

• Rufen Sie den Vorgesetzten eines Benutzers ab.
• Abrufen der direkt untergebenen Mitarbeitenden eines Benutzers.
• Navigieren Sie in der Berichtsstruktur.
• Vorgesetzte und direkte Berichtsbeziehungen.

Benutzerentdeckung

• Listen Sie Nutzer in der Organisation auf.
• Freitextsuche mit automatischem Fallback.
• OData-Filterung und -Sortierung.
• Paginierungsunterstützung.
• Zählen Sie Benutzer in den Ergebnissen.

Abfragefunktionen

• OData-$select zur Auswahl von Eigenschaften.
• OData-$filter für die Benutzerfilterung.
• OData-$expand für verwandte Entitäten.
• OData $orderby für die Sortierung.
• Freitext $search mit Fallback.
• Mögliche Konsistenzunterstützung.

Hinweise

• Verwenden Sie mcp_graph_getMyProfile für den angemeldeten Benutzer, nicht mcp_graph_getUserProfile mit ich.
• Verwenden Sie mcp_graph_getMyManager für den Vorgesetzten des angemeldeten Benutzers.
• userIdentifier muss Objekt-ID (GUID) oder userPrincipalName (UPN) sein, verwenden Sie keinen Anzeigenamen.
• Wenn nur der Anzeigename verfügbar ist, verwenden Sie mcp_graph_listUsers, um den Benutzer zuerst zu suchen.
• $expand kann pro Anfrage nur eine Eigenschaft erweitern (manager oder directReports).
• $search wechselt automatisch zu $filter, wenn die Suche fehlschlägt.
• ConsistencyLevel eventual für erweiterte Abfragen erforderlich.
• Suchformat: "property:value" mit Anführungszeichen.

Häufige Anwendungsfälle

Meine Informationen abrufen

• Nutze mcp_graph_getMyProfile es, um das Profil des aktuellen Nutzers zu erhalten.
• Verwenden Sie mcp_graph_getMyManager, um den Vorgesetzten des aktuellen Benutzers abzurufen.

Suchen eines Benutzers

• Verwenden Sie mcp_graph_listUsers mit dem Suchparameter.

  Beispiel: search='"displayName:John"' Um Nach Benutzern namens John zu suchen.

• userPrincipalName oder Objekt-ID aus den Ergebnissen abrufen.

Benutzerdetails abrufen

• mcp_graph_getUserProfile mit userIdentifier verwenden
• Verwenden Sie select, um bestimmte Eigenschaften abzurufen.
• Verwenden Sie expand, um manager oder directReports einzuschließen.

Organisationsstruktur abrufen

• Verwenden Sie mcp_graph_getUsersManager, um den Vorgesetzten eines Benutzers abzurufen.
• Verwenden Sie mcp_graph_getDirectReports, um die direkt unterstellten Mitarbeitenden eines Benutzers abzurufen.
• Verketten von Aufrufen zur Navigation in der Berichtshierarchie.