Käyttäjäviite (esikatselu)

Note

Tässä artikkelissa kuvataan ominaisuuksia, joita käytetään agenteissa tai agenttivirroissa, joita käytetään standardivaljastuksen voimalla.

Tärkeää

Tämä on esiversiotoiminto.

  • Microsoft julkaisee esiversio-ominaisuuksia ennen virallista julkaisua, jotta asiakkaat voivat käyttää ja antaa palautetta ennen virallista julkaisua.
  • Esikatselutoiminnot toimivat rajoitetusti, eikä niitä ole tarkoitettu tuotantokäyttöön.
  • Microsoft saattavat muuttaa esikatselun MCP-työkalujen nimiä ja parametreja. Vältä kovakoodattuja riippuvuuksia. Microsoft ylläpitää skenaariotukea.
  • Esikatselutoimintoihin sovelletaan Microsoft lisäkäyttöehtoja.

Yleiskatsaus

Palvelintunnus Vuokraajatason URL-osoite Näyttönimi Kuvaus
mcp_MeServer https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_MeServer		 Käyttäjä Työkaluja itsetuntemukseen ja organisatoriseen tietoisuuteen. Käytä tätä työkalua päästäksesi käyttäjäprofiileihin organisaatiossasi ja suorittaaksesi erilaisia toimintoja, kuten saadaksesi oman profiilisi, käyttäjän profiilin, käyttäjän managerin tai suorien alaiset.

Käytettävissä olevat työkalut

mcp_graph_getDirectReports

Näyttää luettelon hakemistossa määritetyn käyttäjän suorista raporteista. Sinun on annettava joko käyttäjän objektitunnus (GUID) tai hänen userPrincipalName (sähköpostin kaltainen käyttäjätunnus). Älä käytä me :n userIdentifiermuodossa.

Pakolliset parametrit:

  • userIdentifier: Käyttäjän objektitunnus (GUID) tai userPrincipalName (UPN)

Note

Älä lähetä muodossa meuserIdentifier. Jos käytettävissä on vain näyttönimi, hae ensin käyttäjä userPrincipalName tai objektitunnus.

Valinnaiset parametrit:

  • Valitse: Pilkuin eroteltu luettelo palautetta olevista ominaisuuksista (esimerkiksi id, , displayNamemail, , jobTitle, userPrincipalName)
  • huippu: Sivukohtaisessa palautettavien kohteiden määrä

mcp_graph_getMyManager

Hakee kirjautuneen käyttäjän esimiehen (soittaja). Tämä päätepiste palauttaa aina nykyisen käyttäjäkontekstin esimiehen.

Valinnaiset parametrit:

  • valikoida: Pilkuin eroteltu luettelo esimiehen ominaisuuksista, jotka palautetaan

mcp_graph_getMyProfile

Hakee kirjautuneen käyttäjän (soittajan) profiilitiedot. Tämä päätepiste palauttaa aina nykyisen käyttäjäkontekstin profiilin.

Valinnaiset parametrit:

  • valikoida: Pilkuin eroteltu käyttäjäprofiilin ominaisuuksien luettelo
  • Laajentaa: Laajenna liittyvät taulukot (esimerkiksi esimies, directReports)

mcp_graph_getUserProfile

Hakee määritetyn käyttäjän profiilin -hakemistosta. Sinun on annettava joko käyttäjän objektitunnus (GUID) tai hänen userPrincipalName (sähköpostin kaltainen käyttäjätunnus). Älä käytä me :n userIdentifiermuodossa. Jos kyseessä on kirjautunut käyttäjä, käytä -mcp_graph_getMyProfile

Pakolliset parametrit:

  • userIdentifier: Käyttäjän objektitunnus (GUID) tai userPrincipalName (UPN)

Note

Älä lähetä minua. Jos käytettävissä on vain näyttönimi, etsi ensin käyttäjä.

Valinnaiset parametrit:

  • valikoida: Pilkuin eroteltu luettelo käyttäjien ominaisuuksista, jotka palautetaan
  • Laajentaa: Laajenna liittyvä taulukko (esimies OR directReports). Voit laajentaa vain yhden ominaisuuden pyyntöä kohden.

mcp_graph_getUsersManager

Hakee määritetyn käyttäjän esimiehen -hakemistossa. Anna joko käyttäjän objektitunnus (GUID) tai hänen userPrincipalName (sähköpostin kaltainen upN). Älä käytä me :n userIdentifiermuodossa. Jos kyseessä on kirjautunut käyttäjä, käytä -mcp_graph_getMyManager

Pakolliset parametrit:

  • userIdentifier: Käyttäjän objektitunnus (GUID) tai userPrincipalName (UPN)

Note

Älä lähetä minua. Jos käytettävissä on vain näyttönimi, etsi ensin käyttäjä.

Valinnaiset parametrit:

  • Valitse: Pilkuin eroteltu luettelo esimiestä varten palautettavasta ominaisuudesta, kuten id, displayName, mail, jobTitleuserPrincipalName

mcp_graph_listUsers

Hakee luettelon organisaation käyttäjistä. Tukee kyselyasetuksia, kuten $select, $filter, $top, $orderby. Oletusarvo ConsistencyLevel on lopulta.

Valinnaiset parametrit:

  • Top: Näytä vain ensimmäiset n käyttäjää
  • valikoida: Pilkuin eroteltu luettelo käyttäjien ominaisuuksista, jotka palautetaan
  • Suodatin: Käyttäjien suodattaminen ominaisuuden mukaan, kuten startswith(displayName,'A')
  • Lajittelu: Tulosten järjestäminen annetun ominaisuuden mukaan, kuten displayName
  • etsiä: Käyttäjien vapaatekstihaku. Muoto: "property:value",, kuten displayName:Neha hakujen näyttönimet, joissa on Neha. Tukee useita ominaisuuksia välilyönneillä. Varasääntö: Jos $search epäonnistuu tai ei palauta tuloksia, yritä automaattisesti uudelleen kohteella $filter.
  • Laskea: Sisällytä kohteiden määrä (tosi tai epätosi)
  • JohdonmukaisuusTaso: Lisäkyselyiden pakollinen otsikko (oletus: lopulta)

Tärkeimmät ominaisuudet

Itsetuntemusta

  • Hanki kirjautuneen käyttäjän profiili.
  • Hanki kirjautuneen käyttäjän esimies.
  • Käytä käyttäjän nykyisiä kontekstitietoja.
  • Käyttäjätunnisteita ei tarvita.

Käyttäjäprofiilit

  • Nouda minkä tahansa käyttäjän profiili tunnuksen tai UPN:n perusteella.
  • Käytä käyttäjäominaisuuksia, kuten displayName, mail, jobTitle ja paljon muuta.
  • Laajenna liittyvät taulukot, kuten manager ja directReports.
  • Valitse ominaisuudet :n avulla $select.

Organisaatiohierarkia

  • Hae käyttäjän esimies.
  • Hae käyttäjän suorat alaiset.
  • Siirry raportointirakenteessa.
  • Esimies- ja suorien raporttien suhteet.

Käyttäjien etsintä

  • Listaa organisaation käyttäjät.
  • Vapaatekstihaku ja automaattinen varatoiminto.
  • OData-suodattaminen ja järjestys.
  • Sivutustuki.
  • Laske käyttäjät tuloksissa.

Kyselytoiminnot

  • OData $select ominaisuuksien valintaan.
  • OData-$filter käyttäjien suodattamiseen.
  • OData$expand liittyviä entiteettejä varten.
  • OData $orderby lajittelua varten.
  • Vapaatekstihaku $search varamenettelyllä.
  • Lopulta johdonmukaisuuden tuki.

Muistiinpanot

  • Käytä mcp_graph_getMyProfile kirjautuneelle käyttäjälle, ei mcp_graph_getUserProfileminulle.
  • Käytä mcp_graph_getMyManager kirjautuneen käyttäjän managerina.
  • userIdentifier on oltava objekti-ID (GUID) tai userPrincipalName (UPN), älä käytä näyttönimeä.
  • Jos käytettävissä on vain näyttönimi, mcp_graph_listUsers etsi ensin käyttäjä.
  • $expand voi laajentaa vain yhden ominaisuuden pyyntöä kohti (manager tai directReports).
  • $search käyttää automaattista varatoimintoa $filter , jos haku epäonnistuu.
  • JohdonmukaisuusMukavuus, joka mahdollisesti vaaditaan kehittyneille kyselyille.
  • Hakumuoto: "property:value" lainausmerkeillä.

Yleiset käyttötapaukset

Hanki omat tiedot

  • Käytä mcp_graph_getMyProfile nykyisen käyttäjän profiilin hakemista.
  • Käytä mcp_graph_getMyManager nykyisen käyttäjän managerin hakemista.

Käyttäjän etsiminen

  • Käytä mcp_graph_listUsers hakuparametrin kanssa.

    Esimerkki: search='"displayName:John"' etsiä käyttäjiä nimeltä Jaako.

  • Nouda userPrincipalName tai objektitunnus tuloksista.

Käyttäjätietojen hakeminen

  • Käytä mcp_graph_getUserProfile :n kanssa userIdentifier.
  • select Käytä tätä tiettyjen ominaisuuksien hakemiseen.
  • Käytä expand mukaan manager tai directReports.

Organisaation rakenteen hankkiminen

  • mcp_graph_getUsersManager Käytä tätä käyttäjän esimiehen hakemiseen.
  • mcp_graph_getDirectReports käytä tätä käyttäjän suorien raporttien noutamiseen.
  • Ketjuta kutsuja siirtyäksesi raportointihierarkiassa.
  • Last updated on