Arbejds-IQ-brugerreference (prøveversion)

Vigtig

Dette er en prøveversionsfunktion.

  • Microsoft udgiver prøveversionsfunktioner før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.
  • Prøveversionsfunktioner har begrænset funktionalitet og er ikke beregnet til produktionsbrug.
  • Microsoft kan ændre navne og parametre for MCP-værktøjer i forhåndsversion. Undgå hardkodede afhængigheder. Microsoft vedligeholder scenariesupport.
  • Prøveversionsfunktioner er underlagt Microsoft supplerende vilkår for anvendelse.

Overview

Server-ID URL-adresse på lejerniveau Vis navn Beskrivelse
mcp_MeServer https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_MeServer		 Arbejds-IQ-bruger MCP-server til selvforståelse og organisationsbevidsthed. Brug denne MCP-server til at få adgang til brugerprofiler i din organisation og udføre forskellige handlinger, f.eks. hente din profil, en brugers profil, en brugers chef eller direkte rapporter.

Tilgængelige værktøjer

mcp_graph_getDirectReports

Viser en angivet brugers direkte rapporter i mappen. Du skal enten angive brugerens objekt-id (GUID) eller vedkommendes userPrincipalName (maillignende UPN). Brug ikke me som userIdentifier.

Påkrævede parametre:

  • userIdentifier: Brugerens objekt-id (GUID) eller userPrincipalName (UPN)

Bemærk

Send ikke me som userIdentifier. Hvis kun vist navn er tilgængeligt, skal du først slå brugeren op for at hente userPrincipalName eller objekt-id' et.

Valgfrie parametre:

  • Vælg: Kommasepareret liste over egenskaber, der skal returneres (f.eks. id, displayName, mail, , jobTitle) userPrincipalName
  • top: Antal elementer, der skal returneres pr. side

mcp_graph_getMyManager

Henter den nærmeste leder for den loggede bruger (den kaldende bruger). Dette slutpunkt returnerer altid lederen for den aktuelle brugerkontekst.

Valgfrie parametre:

  • vælg: Kommasepareret liste over egenskaber, der returneres

mcp_graph_getMyProfile

Henter profiloplysningerne for den bruger, der er logget på (kalderen). Dette slutpunkt returnerer altid profilen for den aktuelle brugerkontekst.

Valgfrie parametre:

  • markere: Kommasepareret liste over brugerprofilegenskaber
  • Udvide: Udvid relaterede tabeller (f.eks. leder directReports)

mcp_graph_getUserProfile

Henter en angivet brugers profil i mappen. Du skal enten angive brugerens objekt-id (GUID) eller vedkommendes userPrincipalName (maillignende UPN). Brug ikke me som userIdentifier. For den bruger, der er logget på, skal du bruge mcp_graph_getMyProfile.

Påkrævede parametre:

  • userIdentifier: Brugerens objekt-id (GUID) eller userPrincipalName (UPN)

Bemærk

Send mig ikke. Hvis kun det viste navn er tilgængeligt, skal du først slå brugeren op.

Valgfrie parametre:

  • vælg: Kommasepareret liste over brugeroplysninger, der skal returneres
  • Udvide: Udvid en relateret tabel (leder ELLER directReports). Du kan kun udvide én egenskab pr. anmodning.

mcp_graph_getUsersManager

Henter lederen for en angivet bruger i mappen. Angiv enten brugerens objekt-id (GUID) eller vedkommendes userPrincipalName (maillignende UPN). Brug ikke me som userIdentifier. For den bruger, der er logget på, skal du bruge mcp_graph_getMyManager.

Påkrævede parametre:

  • userIdentifier: Brugerens objekt-id (GUID) eller userPrincipalName (UPN)

Bemærk

Send mig ikke. Hvis kun det viste navn er tilgængeligt, skal du først slå brugeren op.

Valgfrie parametre:

  • Vælg: Kommasepareret liste over egenskaber, der skal returneres for lederen, f.eks id. , displayName, mail, jobTitle, userPrincipalName

mcp_graph_listUsers

Henter en liste over brugere i organisationen. Understøtter forespørgselsindstillinger som $select, $filter, $top, $orderby. Standarden ConsistencyLevel er eventuel.

Valgfrie parametre:

  • Top: Vis kun de første n-brugere
  • vælg: Kommasepareret liste over brugeroplysninger, der skal returneres
  • Filter: Filtrer brugere efter egenskab, f.eks. startswith(displayName,'A')
  • Sorterefter: Bestil resultater efter en given egenskab, f.eks. displayName
  • søge: Fritekstsøgning for brugere. Format: "property:value", f.eks displayName:Neha . for at søge efter viste navne, der indeholder Neha. Understøtter flere egenskaber med mellemrum. Fallback-regel: Hvis $search mislykkes eller ikke returnerer nogen resultater, skal du automatisk prøve igen med $filter.
  • Tælle: Medtag antal elementer (sand eller falsk)
  • Konsistensniveau: Påkrævet header til avancerede forespørgsler (standard: eventual)

Nøglefunktioner

Selverkendelse

  • Hent profilen for den bruger, der er logget på.
  • Hent lederen for den bruger, der er logget på.
  • Få adgang til aktuelle brugerkontekstoplysninger.
  • Der er ikke behov for bruger-id'er.

Brugerprofiler

  • Hent en brugers profil efter id eller UPN.
  • Få adgang til brugeregenskaber som displayName, mail, jobTitleog meget mere.
  • Udvid relaterede tabeller, f.eks manager . og directReports.
  • Vælg egenskaber ved hjælp $selectaf .

Organisationshierarki

  • Hent en brugers chef.
  • Hent en brugers direkte rapporter.
  • Naviger i rapporteringsstrukturen.
  • Chef og direkte rapportrelationer.

Brugeropdagelse

  • Vis brugere i organisationen.
  • Fritekstsøgning med automatisk fallback.
  • OData-filtrering og -sortering.
  • Understøttelse af sideinddeling.
  • Antal brugere i resultater.

Forespørgselsfunktioner

  • OData $select til valg af egenskab.
  • OData $filter til brugerfiltrering.
  • OData-$expand for relaterede objekter.
  • OData $orderby til sortering.
  • Fritekst $search med fallback.
  • Eventuel understøttelse af konsistens.

Bemærkninger

  • Bruges mcp_graph_getMyProfile til bruger, der er logget på, ikke mcp_graph_getUserProfile til mig.
  • Bruges mcp_graph_getMyManager til administrator af bruger, der er logget på.
  • userIdentifier skal være objekt-id (GUID) eller userPrincipalName (UPN), brug ikke vist navn.
  • Hvis kun vist navn er tilgængeligt, skal du bruge mcp_graph_listUsers til at slå brugeren op først.
  • $expand kan kun udvide én egenskab pr. anmodning (manager eller directReports).
  • $search har automatisk fallback til $filter , hvis søgningen mislykkes.
  • ConsistencyLevel kræves eventuelt til avancerede forespørgsler.
  • Søgeformat: "property:value" med anførselstegn.

Almindelige anvendelsestilfælde

Hent mine oplysninger

  • Bruger mcp_graph_getMyProfile til at hente den aktuelle brugers profil.
  • Bruger mcp_graph_getMyManager til at hente den aktuelle brugers chef.

Find en bruger

  • Brugesmcp_graph_listUsers sammen med søgeparameteren.

    Eksempel: search='"displayName:John"' for at finde brugere med navnet John.

  • Hent userPrincipalName eller objekt-id fra resultater.

Hent brugeroplysninger

  • Bruges mcp_graph_getUserProfile sammen med userIdentifier.
  • Bruges select til at hente bestemte egenskaber.
  • Brug udvid til at inkludere manager eller directReports

Hent organisationsstrukturen

  • Brug mcp_graph_getUsersManager til at hente en brugers leder.
  • Bruges mcp_graph_getDirectReports til at hente en brugers direkte rapporter.
  • Kædekald for at navigere i rapporteringshierarkiet.
  • Last updated on