Microsoft 365:n käyttäjäprofiilin MCP-palvelimen viittaus

Tärkeä

Sinun on oltava osa Frontier-esiversio-ohjelmaa, jotta pääset tutustumaan Microsoft Agent 365:een ennen sen käyttöä. Frontier yhdistää sinut suoraan Microsoftin uusimpiin tekoälyinnovaatioihin. Frontier-esiversioita koskevat asiakassopimusten nykyiset esikatseluehdot. Koska nämä ominaisuudet ovat vielä kehitteillä, niiden käytettävyys ja ominaisuudet voivat muuttua ajan mittaan.

Yleiskatsaus

Palvelintunnus	Display name	Description
mcp_MeServer	Microsoft 365 -käyttäjäprofiilin MCP-palvelin	MCP-palvelin itsetuntemuksen ja organisaation tietoisuuden lisäämiseksi. Käytä tätä MCP-palvelinta käyttäjäprofiilien käyttämiseen organisaatiossasi ja suorita erilaisia toimintoja, kuten profiilisi, käyttäjän profiilin, käyttäjän esimiehen tai suorien raporttien hakeminen.

Käytettävissä olevat työkalut

mcp_graph_getDirectReports

Luettele määritetyn käyttäjän suorat raportit -hakemistossa. Sinun on annettava joko käyttäjän GUID-tunnus tai userPrincipalName (sähköpostin kaltainen upN). Älä käytä "minä"-merkkiä käyttäjänäIdentifier.

Pakolliset parametrit

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

Muistiinpano

Älä lähetä minua käyttäjänäIdentifier. Jos käytettävissä on vain näyttönimi, hae ensin käyttäjä userPrincipalName- tai objektitunnuksen hakemiseksi.

Valinnaiset parametrit

• select: Pilkuin eroteltu palautettavien ominaisuuksien luettelo (esimerkiksi id,displayName,mail,jobTitle,userPrincipalName)
• top: Sivukohtaisessa palautettavien kohteiden määrä

mcp_graph_getMyManager

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

Valinnaiset parametrit

• select: Pilkuin eroteltu luettelo esimiehen ominaisuuksista palautettavaksi

mcp_graph_getMyProfile

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

Valinnaiset parametrit

• select: Pilkuin eroteltu luettelo käyttäjäprofiilin ominaisuuksista
• expand: laajenna liittyvät entiteetit (esimerkiksi esimies, directReports)

mcp_graph_getUserProfile

Nouda määritetyn käyttäjän profiili hakemistosta. Sinun on annettava joko käyttäjän GUID-tunnus tai userPrincipalName (sähköpostin kaltainen upN). Älä käytä "minä"-merkkiä käyttäjänäIdentifier- käytä mcp_graph_getMyProfile kirjautuneen käyttäjän kohdalla.

Pakolliset parametrit

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

Muistiinpano

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

Valinnaiset parametrit

• select: Pilkuin eroteltu luettelo käyttäjien ominaisuuksista palautettavaksi
• expand: Laajenna liittyvä entiteetti (esimies TAI directReports). Voit laajentaa vain yhden ominaisuuden pyyntöä kohden.

mcp_graph_getUsersManager

Nouda määritetyn käyttäjän esimies -hakemistossa. Sinun on annettava joko käyttäjän GUID-tunnus tai userPrincipalName (sähköpostin kaltainen upN). Älä käytä "me"-merkkiä userIdentifier-toiminnossa – käytä mcp_graph_getMyManager kirjautuneen käyttäjän kohdalla.

Pakolliset parametrit

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

Muistiinpano

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

Valinnaiset parametrit

• select: Pilkuin eroteltu ominaisuusluettelo, joka palautetaan esimiehelle (esim. tunnus,näyttönimi,sähköposti,työOtsikko,userPrincipalName)

mcp_graph_listUsers

Organisaation käyttäjäluettelon noutaminen. Tukee kyselyvaihtoehtoja, kuten $select, $filter, $top $orderby. ConsistencyLevel määritetään oletuksena mahdolliseksi.

Valinnaiset parametrit

• top: Näytä vain ensimmäiset n käyttäjää
• select: Pilkuin eroteltu luettelo käyttäjien ominaisuuksista palautettavaksi
• filter: Suodata käyttäjiä ominaisuuden mukaan (esimerkiksi startswith(displayName,'A'))
• orderby: Järjestä tulokset annetun ominaisuuden mukaan (esimerkiksi displayName)
• search: Käyttäjien vapaatekstihaku. Muoto: '"property:value"', esim., '"displayName:Neha"' haku näyttönimiin, joissa on 'Neha'. Tukee useita ominaisuuksia välilyönneillä. Varasääntö: Jos $search epäonnistuu tai ei palauta tuloksia, yritä $filter automaattisesti uudelleen.
• count: Sisällytä kohteiden määrä ("true" tai "false")
• ConsistencyLevel: Kehittyneiden kyselyiden pakollinen otsikko (oletus: "lopulta")

Tärkeimmät ominaisuudet

Itsetuntemus

• Sisäänkirjautuneen käyttäjän profiilin hankkiminen
• Sisäänkirjautuneen käyttäjän esimiehen hankkiminen
• Käytä käyttäjän nykyisiä kontekstitietoja
• Käyttäjätunnisteita ei tarvita

Käyttäjäprofiili

• Käyttäjän profiilin noutaminen tunnuksen tai upn:n perusteella
• Käyttäjän ominaisuuksien käyttäminen (displayName, mail, jobTitle jne.)
• Laajenna liittyvät entiteetit (esimies, directReports)
• Ominaisuuden valinta $select kanssa

Organisaatiohierarkia

• Hae käyttäjän esimies
• Käyttäjän suorien raporttien noutaminen
• Siirry raportointirakenteessa
• Esimies- ja suorien raporttien suhteet

Käyttäjien etsintä

• Organisaation käyttäjien luetteloiminen
• Vapaatekstihaku ja automaattinen varavalinta
• OData-suodattaminen ja järjestys
• Sivutustuki
• Laske käyttäjät tuloksissa

Tärkeimmät ominaisuudet

• OData-$select ominaisuuden valintaa varten
• OData-$filter käyttäjien suodattamiseen
• Liittyvien entiteettien OData-$expand
• OData$orderby lajittelua varten
• Vapaatekstien $search vara varalla
• Lopulta johdonmukaisuuden tuki

Huomautuksia

1. Käytä mcp_graph_getMyProfile kirjautuneena käyttäjänä, älä mcp_graph_getUserProfile kanssani
2. Kirjautuneen käyttäjän esimiehen mcp_graph_getMyManager käyttäminen
3. userIdentifierin on oltava object ID (GUID) tai userPrincipalName (UPN), ei näyttönimi
4. Jos käytettävissä on vain näyttönimi, etsi käyttäjä ensin mcp_graph_listUsers avulla
5. $expand voi laajentaa vain yhtä ominaisuutta pyyntöä kohden (manager OR directReports)
6. $search varatoiminto $filter automaattisesti, jos haku epäonnistuu
7. JohdonmukaisuuSViive kehittyneille kyselyille "lopulta" vaaditaan
8. Hakumuoto: '"property:value"' lainausmerkeillä

Yleiset käyttötapaukset

Tietojen hankkiminen

• Hae nykyisen käyttäjän profiili mcp_graph_getMyProfile avulla
• Hanki nykyisen käyttäjän esimies mcp_graph_getMyManager avulla

2. Etsi käyttäjä

• mcp_graph_listUsers käyttäminen hakuparametrin kanssa

  Esimerkki: search='"displayName:John"' käyttäjien löytämiseksi, joiden nimi on Jaakko

• Hae userPrincipalName tai objektitunnus tuloksista

3. Käyttäjän tietojen noutaminen

• mcp_graph_getUserProfile käyttö userIdentifierin kanssa
• Tiettyjen ominaisuuksien hakeminen Valinta-valikon avulla
• Laajenna-laajennuksen avulla voit sisällyttää mukaan esimiehen tai directReports-tiedot

Organisaatiorakenne.

• Hae käyttäjän esimies mcp_graph_getUsersManager avulla
• Käyttäjän suorien raporttien hakeminen mcp_graph_getDirectReports avulla
• Ketjukutsut raportointihierarkiassa siirtymiseksi