Benutzerreferenz (Vorschau)

Note

In diesem Artikel werden Funktionen beschrieben, die in Agents oder Agent-Flows verwendet werden, die von der Standardumgebung unterstützt werden.

Important

Dies ist eine Vorschaufunktion.

• Microsoft veröffentlicht Vorschaufeatures vor einer offiziellen Version, sodass Kunden frühzeitig Zugriff erhalten und Feedback geben können.
• Vorschaufeatures verfügen über eingeschränkte Funktionen und sind nicht für die Produktionsverwendung vorgesehen.
• Microsoft könnte die Namen und Parameter von Vorschau-MCP-Tools ändern. Vermeiden Sie hartcodierte Abhängigkeiten. Microsoft behält die Szenariounterstützung bei.
• Vorschaufunktionen unterliegen den ergänzenden Nutzungsbedingungen von Microsoft.

Note

Anwendungsspezifische Microsoft 365 MCP-Tools (Copilot, Kalender, Mail, SharePoint, OneDrive, Teams, User und Word) sind ausschließlich für Abwärtskompatibilität gedacht und sollten nicht in Produktionsumgebungen oder neuen Projekten verwendet werden. Für neue Projekte, die Zugriff auf Microsoft 365-Ressourcen benötigen, verwenden Sie Work IQ MCP mit dem GitHub Copilot-Harness. Weitere Informationen finden Sie unter Work IQ MCP in Copilot Studio.

Overview

Server-ID	URL auf Mandantenebene	Anzeigename	Description
mcp_MeServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MeServer	Benutzer	Werkzeuge für Selbsterkenntnis und organisatorisches Bewusstsein. Nutzen Sie dieses Tool, um auf Benutzerprofile in Ihrer Organisation zuzugreifen und verschiedene Aktionen auszuführen, wie zum Beispiel Ihr Profil, das Profil eines Benutzers, einen Benutzermanager oder direkte Berichte zu erhalten.

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)

Note

Senden Sie me nicht als userIdentifier. Wenn nur der Anzeigename verfügbar ist, suchen Sie zuerst den Benutzer auf, um userPrincipalName oder die Objekt-ID zu erhalten.

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)

Note

Schicken Sie mich nicht. Wenn nur der Anzeigename verfügbar ist, suchen Sie zuerst den Benutzer nach.

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)

Note

Schicken Sie mich nicht. Wenn nur der Anzeigename verfügbar ist, suchen Sie zuerst den Benutzer nach.

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.