Brukerreferanse (forhåndsvisning)

Merknad

Denne artikkelen beskriver funksjoner som brukes i agenter eller agentstrømmer drevet av standardledningsnettet.

Important

Dette er en forhåndsvisningsfunksjon.

  • Microsoft utgir forhåndsvisningsfunksjoner før en offisiell utgivelse, slik at kundene kan få tidlig tilgang og gi tilbakemelding.
  • Forhåndsvisningsfunksjoner har begrenset funksjonalitet og er ikke ment for produksjonsbruk.
  • Microsoft kan endre mcp-verktøynavn og parametere for forhåndsvisning. Unngå hardkodede avhengigheter. Microsoft opprettholder scenariostøtte.
  • Forhåndsvisningsfunksjoner er underlagt Microsoft ekstra vilkår for bruk.

Oversikt

Server-ID URL på leiernivå Visningsnavn Beskrivelse
mcp_MeServer https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_MeServer		 Bruker Verktøy for selvinnsikt og organisatorisk bevissthet. Bruk dette verktøyet for å få tilgang til brukerprofiler i organisasjonen din og utføre ulike handlinger som å hente profilen din, en brukers profil, en brukers leder eller direkte rapporter.

Tilgjengelige verktøy

mcp_graph_getDirectReports

Viser direkterapporter for en angitt bruker i katalogen. Du må angi enten brukerens objekt-ID (GUID) eller deres userPrincipalName (e-postlignende UPN). Ikke bruk me som userIdentifier.

Obligatoriske parametere:

  • userIdentifier: Brukerens objekt-ID (GUID) eller userPrincipalName (UPN)

Merknad

Ikke send me som userIdentifier. Hvis bare visningsnavn er tilgjengelig, må du først slå opp brukeren for å hente userPrincipalName eller objekt-ID.

Valgfrie parametere:

  • Velg: Kommadelt liste over egenskaper som skal returneres (for eksempel id, , displayName, mail, jobTitleuserPrincipalName)
  • topp: Antall elementer som skal returneres per side

mcp_graph_getMyManager

Henter lederen for den påloggede brukeren (anroperen). Dette endepunktet returnerer alltid lederen for gjeldende brukerkontekst.

Valgfrie parametere:

  • velge: Kommadelt liste over overordnedeegenskaper som skal returneres

mcp_graph_getMyProfile

Henter profildetaljene til den påloggede brukeren (innringeren). Dette endepunktet returnerer alltid profilen til gjeldende brukerkontekst.

Valgfrie parametere:

  • velge: Kommadelt liste over brukerprofilegenskaper
  • Utvide: Utvid relaterte tabeller (for eksempel leder, directReports)

mcp_graph_getUserProfile

Henter en angitt brukerprofil i katalogen. Du må angi enten brukerens objekt-ID (GUID) eller deres userPrincipalName (e-postlignende UPN). Ikke bruk me som userIdentifier. Bruk for den påloggede brukeren mcp_graph_getMyProfile.

Obligatoriske parametere:

  • userIdentifier: Brukerens objekt-ID (GUID) eller userPrincipalName (UPN)

Merknad

Ikke send meg. Hvis bare visningsnavnet er tilgjengelig, må du først slå opp brukeren.

Valgfrie parametere:

  • velge: Kommadelt liste over brukeregenskaper som skal returneres
  • Utvide: Utvid en relatert tabell (overordnet ELLER directReports). Du kan bare utvide én egenskap per forespørsel.

mcp_graph_getUsersManager

Henter lederen for en angitt bruker i katalogen. Angi enten brukerens objekt-ID (GUID) eller deres userPrincipalName (e-postlignende UPN). Ikke bruk me som userIdentifier. Bruk for den påloggede brukeren mcp_graph_getMyManager.

Obligatoriske parametere:

  • userIdentifier: Brukerens objekt-ID (GUID) eller userPrincipalName (UPN)

Merknad

Ikke send meg. Hvis bare visningsnavnet er tilgjengelig, må du først slå opp brukeren.

Valgfrie parametere:

  • Velg: Kommadelt liste over egenskaper som skal returneres for lederen, for eksempel id, displayName, mail, jobTitleuserPrincipalName

mcp_graph_listUsers

Henter en liste over brukere i organisasjonen. Støtter spørringsalternativer som $select, $filter, , $top$orderby. Standardverdien ConsistencyLevel er eventuelt.

Valgfrie parametere:

  • Topp: Vis bare de første n brukerne
  • velge: Kommadelt liste over brukeregenskaper som skal returneres
  • Filter: Filtrere brukere etter egenskap, for eksempel startswith(displayName,'A')
  • Orderby: Ordreresultater etter gitt egenskap, for eksempel displayName
  • søke: Fritekstsøk etter brukere. Format: «egenskap:verdi», for eksempel for å søke etter visningsnavn som displayName:Neha inneholder Neha. Støtter flere egenskaper med mellomrom. Tilbakefallsregel: Hvis $search mislykkes eller returnerer ingen resultater, prøver du automatisk på nytt med $filter.
  • Telle: Inkluder antall elementer (sann eller usann)
  • Konsekvensnivå: Obligatorisk topptekst for avanserte spørringer (standard: eventuelt)

Nøkkelfunksjoner

Selverkjennelse

  • Få profilen til den påloggede brukeren.
  • Få lederen til den innloggede brukeren.
  • Få tilgang til gjeldende informasjon om brukerkontekst.
  • Du trenger ikke brukeridentifikatorer.

Brukerprofiler

  • Hent en brukers profil etter ID eller UPN.
  • Få tilgang til brukeregenskaper som displayName, mail, jobTitleog mer.
  • Utvid relaterte tabeller, for eksempel manager og directReports.
  • Velg egenskaper ved hjelp $selectav .

Organisasjonshierarki

  • Hent en brukers overordnede.
  • Få en brukers direkte rapporter.
  • Naviger i rapporteringsstrukturen.
  • Leder- og direkte rapportrelasjoner.

Brukeroppdagelse

  • List brukere i organisasjonen.
  • Fritekstsøk med automatisk tilbakefall.
  • OData-filtrering og bestilling.
  • Støtte for paginering.
  • Telle brukere i resultater.

Spørringsfunksjoner

  • OData $select for valg av egenskaper.
  • OData $filter for brukerfiltrering.
  • OData $expand for tilknyttede enheter.
  • OData $orderby for å sortere.
  • Fritekst-$search med reserveløsning.
  • Støtte for eventual konsistens.

Notater

  • Bruk mcp_graph_getMyProfile for den innloggede brukeren, ikke mcp_graph_getUserProfile for meg.
  • Bruk mcp_graph_getMyManager for den innloggede brukerens manager.
  • userIdentifier må være objekt-ID (GUID) eller userPrincipalName (UPN), ikke bruk visningsnavn.
  • Hvis bare visningsnavn er tilgjengelig, bruk mcp_graph_listUsers det til å slå opp brukeren først.
  • $expand kan bare utvide én egenskap per forespørsel (manager eller directReports).
  • $search har automatisk tilbakefall til $filter hvis søket mislykkes.
  • ConsistencyLevel eventual kreves for avanserte spørringer.
  • Søkeformat: «egenskap:verdi» med anførselstegn.

Vanlige brukstilfeller

Få min informasjon

  • Bruk mcp_graph_getMyProfile den for å få den nåværende brukerens profil.
  • Bruk mcp_graph_getMyManager den for å få den nåværende brukerens manager.

Finne en bruker

  • Bruk mcp_graph_listUsers med søkeparameteren.

    Eksempel: search='"displayName:John"' finne brukere som heter John.

  • Hent userPrincipalName eller objekt-ID fra resultater.

Få brukerdetaljer

  • Bruk mcp_graph_getUserProfile med userIdentifier.
  • Bruk select denne til å hente bestemte egenskaper.
  • Bruk expand å inkludere manager eller directReports.

Få organisasjonsstruktur

  • Bruk mcp_graph_getUsersManager til å få en brukers leder.
  • Bruk mcp_graph_getDirectReports denne til å få en brukers direkterapporter.
  • Kjedekall for å navigere i rapporteringshierarkiet.
  • Last updated on