Arbets-IQ-användarreferens (förhandsversion)

Important

Detta är en förhandsgranskningsfunktion.

  • Microsoft släpper förhandsversionsfunktioner före en officiell version så att kunderna kan få tidig åtkomst och ge feedback.
  • Förhandsgranskningsfunktioner har begränsade funktioner och är inte avsedda för produktionsanvändning.
  • Microsoft kan ändra mcp-verktygsnamn och parametrar för förhandsversionen. Undvik hårdkodade beroenden. Microsoft underhåller scenariostöd.
  • Förhandsgranskningsfunktioner omfattas av Microsoft kompletterande användningsvillkor.

Overview

Server-ID URL på klientorganisationsnivå Visningsnamn Description
mcp_MeServer https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_MeServer		 Work IQ-användare MCP-server för självkännedom och organisationsmedvetenhet. Använd den här MCP-servern för att komma åt användarprofiler i din organisation och utföra olika åtgärder, till exempel att hämta din profil, en användares profil, en användarhanterare eller direktrapporter.

Tillgängliga verktyg

mcp_graph_getDirectReports

Visar en lista över direktrapporter för en angiven användare i katalogen. Du måste ange antingen användarens objekt-ID (GUID) eller deras userPrincipalName (e-postliknande UPN). Använd me inte som userIdentifier.

Obligatoriska parametrar:

  • userIdentifier: Användarens objekt-ID (GUID) eller userPrincipalName (UPN)

Note

Skicka me inte som userIdentifier. Om endast visningsnamnet är tillgängligt letar du först upp användaren för att hämta userPrincipalName eller objekt-ID.

Valfria parametrar:

  • Välj: Kommaavgränsad lista över egenskaper som ska returneras (till exempel id, , displayNamemail, jobTitle, userPrincipalName)
  • topp: Antal objekt som ska returneras per sida

mcp_graph_getMyManager

Hämtar chefen för den inloggade användaren (anroparen). Den här API-slutpunkten returnerar alltid managern för den aktuella användarkontexten.

Valfria parametrar:

  • utvald: Kommaavgränsad lista över chefsegenskaper som ska returneras

mcp_graph_getMyProfile

Hämtar profilinformationen för den inloggade användaren (anroparen). Den här slutpunkten returnerar alltid profilen för den aktuella användarkontexten.

Valfria parametrar:

  • utvald: Kommaavgränsad lista över egenskaper för användarprofiler
  • Expandera: Expandera relaterade tabeller (till exempel chef, directReports)

mcp_graph_getUserProfile

Hämtar en angiven användares profil i katalogen. Du måste ange antingen användarens objekt-ID (GUID) eller deras userPrincipalName (e-postliknande UPN). Använd me inte som userIdentifier. För den inloggade användaren använder du mcp_graph_getMyProfile.

Obligatoriska parametrar:

  • userIdentifier: Användarens objekt-ID (GUID) eller userPrincipalName (UPN)

Note

Skicka mig inte. Om endast visningsnamnet är tillgängligt letar du först upp användaren.

Valfria parametrar:

  • utvald: Kommaavgränsad lista över användaregenskaper som ska returneras
  • Expandera: Expandera en relaterad tabell (chef ELLER directReports). Du kan bara expandera en egenskap per begäran.

mcp_graph_getUsersManager

Hämtar chefen för en angiven användare i katalogen. Ange antingen användarens objekt-ID (GUID) eller deras userPrincipalName (e-postliknande UPN). Använd me inte som userIdentifier. För den inloggade användaren använder du mcp_graph_getMyManager.

Obligatoriska parametrar:

  • userIdentifier: Användarens objekt-ID (GUID) eller userPrincipalName (UPN)

Note

Skicka mig inte. Om endast visningsnamnet är tillgängligt letar du först upp användaren.

Valfria parametrar:

  • Välj: Kommaavgränsad lista över egenskaper som ska returneras för chefen, till exempel id, displayName, mail, jobTitle, userPrincipalName

mcp_graph_listUsers

Hämtar en lista över användare i organisationen. Stöder frågealternativ som $select, $filter, $top, $orderby. Standardvärdet ConsistencyLevel är slutligt.

Valfria parametrar:

  • Topp: Visa endast de första n användarna
  • utvald: Kommaavgränsad lista över användaregenskaper som ska returneras
  • Filter: Filtrera användare efter egenskap, till exempel startswith(displayName,'A')
  • Orderby: Orderresultat efter angiven egenskap, till exempel displayName
  • sökning: Fritextsökning för användare. Format: "property:value", till exempel för att söka efter visningsnamn som displayName:Neha innehåller Neha. Stöder flera egenskaper med mellanrum. Reservregel: Om $search misslyckas eller inte returnerar några resultat försöker du automatiskt igen med $filter.
  • Räkna: Inkludera antal objekt (sant eller falskt)
  • ConsistencyLevel: Obligatoriskt huvud för avancerade frågor (standard: slutlig)

Viktiga funktioner

Självkännedom

  • Hämta den inloggade användarens profil.
  • Hämta den inloggade användarens chef.
  • Få åtkomst till aktuell användarkontextinformation.
  • Inget behov av användaridentifierare.

Användarprofiler

  • Hämta en användares profil med ID eller UPN.
  • Få åtkomst till användaregenskaper som displayName, mail, jobTitleoch mycket mer.
  • Expandera relaterade tabeller som manager och directReports.
  • Välj egenskaper med hjälp av $select.

Organisationshierarki

  • Hämta en användares chef.
  • Hämta en användares direktrapporter.
  • Navigera i rapporteringsstrukturen.
  • Manager- och direktrapporteringsrelationer.

Upptäckt av användare

  • Lista användare i organisationen.
  • Fritextsökning med automatisk återställning.
  • OData-filtrering och sortering.
  • Stöd för paginering.
  • Räkna användare bland resultaten.

Frågefunktioner

  • OData $select för val av egenskaper.
  • OData-$filter för användarfiltrering.
  • OData-$expand för relaterade entiteter.
  • OData $orderby för sortering.
  • Fritext-$search med reservlösning.
  • Stöd för eventuell konsekvens.

Notes

  • Använd mcp_graph_getMyProfile för inloggad användare, inte mcp_graph_getUserProfile med mig.
  • Använd mcp_graph_getMyManager för den inloggade användarens chef.
  • userIdentifier måste vara objekt-ID (GUID) eller userPrincipalName (UPN), använd inte visningsnamn.
  • Om endast visningsnamnet är tillgängligt använder du mcp_graph_listUsers för att söka efter användaren först.
  • $expand kan bara expandera en egenskap per begäran (manager eller directReports).
  • $search har automatisk återställning till $filter om sökningen misslyckas.
  • ConsistencyLevel krävs slutligen för avancerade frågor.
  • Sökformat: "property:value" med citattecken.

Vanliga användningsfall

Hämta min information

  • Använder mcp_graph_getMyProfile för att hämta den aktuella användarens profil.
  • Använder mcp_graph_getMyManager för att hämta den aktuella användarens chef.

Hitta en användare

  • Användermcp_graph_listUsers med sökparametern.

    Exempel: search='"displayName:John"' för att hitta användare med namnet John.

  • Hämta userPrincipalName eller objekt-ID från resultat.

Hämta användarinformation

  • Använd mcp_graph_getUserProfile med userIdentifier.
  • Använd select för att hämta specifika egenskaper.
  • Använd expandera för att inkludera manager eller directReports

Hämta organisationsstrukturen

  • Använd mcp_graph_getUsersManager för att hämta en användares chef.
  • Använd mcp_graph_getDirectReports för att hämta en användares direktrapporter.
  • Kedja anrop för att navigera i rapporthierarkin.
  • Last updated on