Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
Huomautus
Tämän artikkelin ominaisuudet perustuvat standardivaljaisiin, jotka käyttävät Lisensointi-osiossa kuvattuja laskutusvaihtoehtoja agenteille, jotka käyttävät standardivaljasta. Opi, miten pääset käsiksi standardeihin liittyviin ominaisuuksiin Accessin standardiagenteissa ja agenttivirroissa.
Important
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 | Vaikutusalue | Kuvaus |
|---|---|---|---|---|
mcp_TeamsServer |
https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_TeamsServer |
Tiimit | McpServers.Teams.All |
Microsoft Teams -työkalut keskustelujen, kanavien sekä käyttäjien tai viestien hallintaan. Käytä tätä MCP Server for Teams -toimintoja, kuten keskusteluiden ja keskusteluviestien luomista, päivittämistä ja noutamista, tiimien ja kanavien hallintaa sekä näihin tehtäviin liittyvien hallintatehtävien suorittamista. |
Keskustelutyökalut
mcp_graph_chat_addChatMember
Päätepiste:POST /v1.0/chats/{chat-id}/members
Lisää jäsenen keskusteluun käyttämällä - user@odata.bind, @odata.type- ja valinnaisia rooleja (jäsen, omistaja). Palauttaa 409-virhekoodin, jos jäsen on jo olemassa, 400-virhekoodin virheellisille käyttäjäviittauksille tai 403-virhekoodin, jos käytännöt rajoittavat lisäämistä.
Pakolliset parametrit: chat-id, @odata.type, user@odata.bind, roles
mcp_graph_chat_createChat
Päätepiste:POST /v1.0/chats
Luo uuden Teams-keskustelun : n kanssa chatType (oneOnOne edellyttää täsmälleen kahta osallistujaa, ryhmä vaatii enemmän kuin kaksi) ja -jäseniä. Palauttaa luvun 400, jos oneOnOne jäsenmäärä on väärä, 409, jos samoilla osallistujilla on jo keskustelu, tai 403, jos soittajalta puuttuu oikeudet.
Pakolliset parametrit:chatType, jäsenet
mcp_graph_chat_poistaKeskustelu
Päätepiste:DELETE /v1.0/chats/{chat-id}
Poistaa keskustelu pehmeästi. Palauttaa arvon 403, jos käyttöoikeus puuttuu, tai arvon 404, jos se on jo poistettu. Vuokraajan säilytyskäytännöt hallinnoivat tätä toimintoa.
Pakolliset parametrit: chat-id
mcp_graph_chat_deleteChatMessage
Päätepiste:POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete
Poistaa keskusteluviestin pehmeästi. Palauttaa luvun 403 ilman Chat.ReadWrite, virheellisten tunnusten 404:n, ja se saattaa silti säilyttää sanoman yhteensopivuuden puolesta.
Pakolliset parametrit: user-id, chat-id, chatMessage-id
mcp_graph_chat_getChat
Päätepiste:GET /v1.0/chats/{chat-id}
Noutaa keskustelun ID:n perusteella. Palauttaa metatietoja, kuten tyypin ja aiheen. Palauttaa luvun 404, jos keskustelua ei ole olemassa tai se ei ole näkyvissä, tai arvon 403, jos käyttöoikeudet on estetty.
Pakolliset parametrit: chat-id
mcp_graph_chat_getChatMessage (Viestin hakemisto chatille MCP Graph -rajapinnasta)
Päätepiste:GET /v1.0/chats/{chat-id}/messages/{message-id}
Hakee keskusteluviestin tunnuksen perusteella. Palauttaa luvun 404, jos viestiä ei ole olemassa tai se on piilotettu, tai 403:n, jolla ei ole asianmukaisia oikeuksia.
Pakolliset parametrit: chat-id, message-id
mcp_graph_chat_listChatMembers
Päätepiste:GET /v1.0/chats/{chat-id}/members
Näyttää luettelon keskusteluiden osallistujista. Palauttaa roolit (jäsen, omistaja tai vieras). Palauttaa luvun 403 ilman lukuoikeuksia tai 404: n, jos keskustelusta ei löydy.
Pakolliset parametrit: chat-id
mcp_graph_chat_listChatMessages
Päätepiste:GET /v1.0/chats/{chat-id}/messages
Näyttää keskustelun viestit, joissa on valinnainen $top, $filter, ja $orderby. Palauttaa sivutetut tulokset. Yhteensopivuus saattaa piilottaa sisällön. Virheisiin kuuluvat 400 virheellisille kyselyille ja 429 rajoittamista varten.
Pakolliset parametrit: chat-id
Valinnaiset parametrit:$top, $filter, , $orderby
mcp_graafinen_keskusteluluettelo_listaaKeskustelut
Päätepiste:GET /v1.0/chats
Luetteloi soittajan keskustelut valinnaisilla $top, $filter, $expandja $orderby. Palauttaa vain näkyvät keskustelut; piilotettuja tai järjestelmäkeskusteluja voidaan sulkea pois. Palauttaa virheellisille lajittelulausekkeille luvun 400.
Valinnaiset parametrit:$top, $orderby, $expand, , $filter
mcp_grafiikka_keskustelu_lähetäViesti
Päätepiste:POST /v1.0/chats/{chat-id}/messages
Julkaisee uuden tekstimuotoisen viestin keskustelussa. Tarvitsee chat-id-tunnuksen ja ei-mitään body.content-sisältöä; vain teksti, jota tuetaan. Tämä saattaa palauttaa 429:n rajoittamisesta, 403:n, jos oikeuksia puuttuu, tai 404:n, jos keskustelu on virheellinen. Ei idempotent—avoid sokko-uudelleenyrityksiä.
Pakolliset parametrit: chat-id, body
mcp_graph_chat_updateChat
Päätepiste:PATCH /v1.0/chats/{chat-id}
Päivittää keskusteluominaisuudet, kuten vain ryhmäkeskusteluja koskevat ohjeet. Epäonnistuu kun käytössä on 400, jos käytetään yksi yhteen -keskustelulle, 403 ilman oikeuksia tai 404, jos chatia ei löydy.
Pakolliset parametrit: chat-id, topic
mcp_graph_chat_updateChatMessage
Päätepiste:PATCH /v1.0/chats/{chat-id}/messages/{message-id}
Päivittää keskusteluviestin uudella tekstimuotoisessa sisällössä. Jotkin järjestelmän tai yhteensopivuuden sanomat estävät muokkaamisen. Toiminto palauttaa arvon 403 tai 400, jos muokkausta ei sallita, tai 409-arvon ristiriidoille.
Pakolliset parametrit: chat-id, message-id
Kanava- ja tiimityökalut
mcp_graph_teams_addChannelMember
Päätepiste:POST /v1.0/teams/{team-id}/channels/{channel-id}/members
Lisää jäsenen yksityiseen tai jaettuun kanavaan käyttämällä - user@odata.bind, @odata.type- ja valinnaisia rooleja (omistaja tai tyhjä). Epäonnistuu vakiokanavissa. Palauttaa luvun 409, jos jäsen on jo olemassa, ja luvun 403, jos käyttöoikeuksia ei ole määritetty.
Pakolliset parametrit: team-id, channel-id, displayName, roles, user@odata.bind, @odata.type
mcp_graph_tiimit_luoKanava
Päätepiste:POST /v1.0/teams/{team-id}/channels
Luo tiimissä kanavan, displayName joka sisältää membershipTypevalinnaisen kuvauksen (vakio, yksityinen, jaettu) ja valinnaiset jäsenet. Yksityiset tai jaetut kanavat edellyttävät eksplisiittisiä jäseniä. Kaksoiskappaleet tai virheellinen jäsenyys aiheuttavat luvun 400 tai 409.
Pakolliset parametrit: team-id, displayName
Valinnaiset parametrit: kuvaus, jäsenyydenTyyppi, jäsenet
mcp_graph_teams_createPrivateChannel
Päätepiste:POST /v1.0/teams/{team-id}/channels
Luo yksityisen kanavan määrittämällä -arvoksi membershipTypeprivate. Jäseniä on sisällytettävä kanavaa luodessasi, ja jäsenluettelossa on oltava vähintään yksi omistaja. Palauttaa arvon 400, jos jäsenet puuttuvat, arvon 409, jos nimet ovat päällekkäisiä, tai arvon 403, jos kutsujalla ei ole oikeuksia.
Pakolliset parametrit: team-id, displayName, members
mcp_graph_teams_getChannel
Päätepiste:GET /v1.0/teams/{team-id}/channels/{channel-id}
Hakee kanavan, jossa on valinnainen $select ja $filter. Palauttaa luvun 404, jos kanavaa ei löydy tai soittajalta puuttuu käyttöoikeus, 403, jos käyttöoikeudet eivät riitä, tai 400 suodattimen, jota ei tueta.
Pakolliset parametrit: team-id, channel-id
Valinnaiset parametrit:$select, $filter
mcp_graph_teams_getTeam
Päätepiste:GET /v1.0/teams/{team-id}
Hakee tiimin ominaisuudet valinnaisilla $select ominaisuuksilla ja $expand. Palauttaa luvun 403 tai 404, jos joukkue ei ole käytettävissä.
Pakolliset parametrit: team-id
Valinnaiset parametrit:$select, $expand
mcp_graph_teams_listChannelMembers
Päätepiste:GET /v1.0/teams/{team-id}/channels/{channel-id}/members
Näyttää luettelon tietyn Microsoft Teams kanavan kaikista jäsenistä. Palauttaa kunkin jäsenen metatiedot, kuten käyttäjätiedot, roolit ja jäsenyyden tilan. Näistä tiedoista on hyötyä kanavan osallistumisen valvonnan, jäsenyyden tarkistamisen ennen roolipäivityksiä tai vaatimustenmukaisuuden varmistamisessa.
Pakolliset parametrit: team-id, channel-id
Valinnaiset parametrit:$top, $expand
mcp_graph_teams_listChannelMessages
Päätepiste:GET /v1.0/teams/{team-id}/channels/{channel-id}/messages
Näyttää luettelon kanavan viesteistä. Mukauta tuloksia valinnaisten $top parametrien ja $expand -parametrien avulla. Esimerkiksi kohdetta käytetään $expand vastausten sisällyttämiseen. Sivutus käsitellään :n kautta @odata.nextLink. Palauttaa arvon 403 ilman lukuoikeutta tai 400 virheellisille kyselyasetuksille.
Pakolliset parametrit: team-id, channel-id
Valinnaiset parametrit:$top, $expand
mcp_graph_teams_listChannels
Päätepiste:GET /v1.0/teams/{team-id}/allChannels
Näyttää luettelon ryhmän kanavista. Mukauta tuloksia valinnaisten $select parametrien tai $filter parametrien avulla. Palauttaa yksityiset ja jaetut kanavat vain, jos soittaja on jäsen. Epäonnistuu virheellä 403: lla, jos soittajalta puuttuvat lukuoikeudet, tai 400 virheellisille OData-kyselyille.
Pakolliset parametrit: team-id
Valinnaiset parametrit:$select, $filter
mcp_graph_teams_listTeams
Päätepiste:GET /v1.0/users/{user-id}/joinedTeams
Näyttää luettelon tietyn käyttäjän yhdistetyistä tiimeistä. Palauttaa vain kyseisen käyttäjän jäsenyydet, ei kaikkia vuokraajaryhmiä. Palauttaa luvun 403, jos soittaja ei voi tehdä kyselyä käyttäjälle, tai arvon 404, jos tunnus on virheellinen.
Pakolliset parametrit: user-id
mcp_graph_teams_postChannelMessage
Päätepiste:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages
Julkaisee vain teksti -viestin kanavalle. Edellyttää team-id-, channel-id- ja body.content-parametria. Palauttaa luvun 403 ilman ChannelMessage.Send-tiedostoa, 404: n, jos kanavaa ei löydy, tai 400:n, jos sisältöä puuttuu.
Pakolliset parametrit: team-id, channel-id, body
mcp_graph_teams_replyToChannelMessage
Päätepiste:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies
Vastaa viestiin kanavassa käyttämällä body.content-toimintoa. Vain pelkkää tekstiä tuetaan. Palauttaa luvun 404, jos pääviestiä ei löydy, luvun 403 ilman oikeuksia tai 400 virheellisen sisällön osalta.
Pakolliset parametrit: team-id, channel-id, message-id, body
mcp_graph_teams_updateChannel
Päätepiste:PATCH /teams/{team-id}/channels/{channel-id}
Päivittää kanavan uudella displayName tai kuvauksella. Rajoitukset voivat koskea erikoiskanavia, kuten Yleisiä. Palauttaa 403:n käyttöoikeuksien puuttuessa, 409:n jos nimi on jo käytössä tai 400:n virheellisestä syötteestä.
Pakolliset parametrit: team-id, channel-id
Valinnaiset parametrit: displayName, description
mcp_graph_teams_updateChannelMember
Päätepiste:PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}
Päivittää jäsenen roolin yksityisessä tai jaetussa kanavassa muuttamalla rooleja. Vakiokanavat perivät rooleja tiimiltä ja hylkäävät päivitykset yleensä. Palauttaa luvun 400, jos yritetään vakiokanavissa, 403, jos se ei ole sallittu, tai 404, jos jäsentä ei löydy.
Kuvankäsittelyn pakolliset parametrit: team-id, channel-id, membership-id, roolit
Tuetut toiminnot
- Keskusteluiden hallinta (luo, lue, päivitä, poista)
- Viestitoiminnot (lähetä, nouda, muokkaa, poista)
- Kanavan hallinta (luo, määritä, luettelo)
- Jäsenten hallinta (lisää, päivitä, luettelo)
- Ryhmän toiminnot (noutaminen, luettelo)
Tärkeimmät ominaisuudet
- Täydet luonti-, luku-, päivitys- ja poistotoiminnot (CRUD) keskusteluissa ja kanavissa.
- Yksityisten, jaettujen ja vakiokanavien tuki.
- Viestien ketjutus ja vastaukset.
- Jäsenroolien hallinta.
- OData-kyselyn tuki suodattamiselle ja sivutetuille toiminnoille.