Reference Teams (Preview)

Note

Tento článek popisuje funkce používané v agentech nebo tocích agentů využívajících standardní harness.

Important

Toto je funkce Preview.

• Microsoft uvolňuje funkce ve verzi Preview před oficiálním vydáním, aby k nim zákazníci mohli získat předběžný přístup a poskytnout zpětnou vazbu.
• Funkce ve verzi Preview mají omezené funkce a nejsou určené pro produkční použití.
• Microsoft můžou změnit názvy a parametry nástrojů MCP ve verzi Preview. Vyhněte se pevně zakódovaným závislostem. Microsoft udržuje podporu scénářů.
• Funkce ve verzi Preview podléhají Microsoft dodatečným podmínkám použití.

Přehled

ID serveru	Adresa URL na úrovni tenanta	Zobrazované jméno	Scope	Description
mcp_TeamsServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_TeamsServer	Teams	McpServers.Teams.All	Microsoft Teams nástroje pro správu chatů, kanálů a uživatelů nebo zpráv v nich. Tento server MCP můžete použít pro operace Teams, jako je vytváření, aktualizace a načítání chatů a chatových zpráv, správa týmů a kanálů a provádění úloh správy souvisejících s těmito úkoly.

Nástroje pro chat

mcp_graph_chat_addChatMember

Koncový bod:POST /v1.0/chats/{chat-id}/members

Přidá člena do chatu pomocí tagů user@odata.bind, @odata.type a volitelných rolí (člen, vlastník). Vrátí kód chyby 409, pokud již člen existuje, kód chyby 400 pro neplatné odkazy na uživatele nebo kód chyby 403, pokud zásady omezují přidávání.

Požadované parametry: ID chatu, @odata.type, user@odata.bind, role

mcp_graph_chat_createChat

Koncový bod:POST /v1.0/chats

Vytvoří nový chat v Teams s chatType (oneOnOne vyžaduje přesně dva účastníky, skupinový chat vyžaduje více než dva účastníky) a dalšími členy. Vrátí hodnotu 400, pokud oneOnOne má nesprávný počet členů, 409, pokud už mají stejní účastníci chat, nebo 403, pokud volající nemá práva.

Požadované parametry:chatType, členové

mcp_graph_chat_deleteChat

Koncový bod:DELETE /v1.0/chats/{chat-id}

Obnovitelně odstraní chat. Vrátí hodnotu 403, pokud oprávnění chybí, nebo 404, pokud již byla odstraněna. Tato operace se řídí zásadami uchovávání dat tenanta.

Požadované parametry: ID chatu

mcp_graph_chat_deleteChatMessage

Koncový bod:POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

Dočasné odstranění zprávy chatu. Vrátí hodnotu 403 bez Chat.ReadWrite, 404 pro neplatná ID a může stále uchovávat zprávu o dodržování předpisů.

Požadované parametry: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

Koncový bod:GET /v1.0/chats/{chat-id}

Načte chat podle ID. Vrátí metadata, jako je typ a téma. Vrátí hodnotu 404, pokud chat neexistuje nebo není viditelný, nebo 403, pokud jsou oprávnění odepřena.

Požadované parametry: ID chatu

mcp_graph_chat_getChatMessage

Koncový bod:GET /v1.0/chats/{chat-id}/messages/{message-id}

Načte chatovou zprávu podle ID. Vrátí hodnotu 404, pokud zpráva neexistuje nebo je skrytá, nebo 403 bez správných práv.

Požadované parametry: ID chatu, message-id

mcp_graph_chat_listChatMembers

Koncový bod:GET /v1.0/chats/{chat-id}/members

Zobrazí seznam účastníků chatu. Vrátí role (člen, vlastník nebo host). Vrátí hodnotu 403 bez oprávnění ke čtení nebo 404, pokud chat nebyl nalezen.

Požadované parametry: ID chatu

mcp_graph_chat_listChatMessages

Koncový bod:GET /v1.0/chats/{chat-id}/messages

Vypíše zprávy v chatu s volitelnými parametry $top, $filter a $orderby. Vrátí stránkované výsledky. Dodržování předpisů může skrýt obsah. Chyby zahrnují kód 400 pro chybné dotazy a kód 429 při omezení počtu požadavků.

Požadované parametry: ID chatu

Volitelné parametry:$top, $filter, $orderby

mcp_graph_chat_listChats

Koncový bod:GET /v1.0/chats

Zobrazí seznam chatů pro volajícího s volitelným $top, $filter, $expand, a $orderby. Vrátí pouze viditelné chaty; skryté nebo systémové chaty můžou být vyloučené. Vrátí hodnotu 400 pro neplatné výrazy řazení.

Volitelné parametry:$top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

Koncový bod:POST /v1.0/chats/{chat-id}/messages

Publikuje novou zprávu ve formátu prostého textu v chatu. Potřebuje ID chatu a neprázdné body.content; podporován pouze text. Může vrátit chybu 429 kvůli omezení, 403 pokud chybí oprávnění nebo 404, pokud je chat neplatný. Nejde o idempotent—avoid opakované pokusy naslepo.

Požadované parametry: ID chatu, text

mcp_graph_chat_updateChat

Koncový bod:PATCH /v1.0/chats/{chat-id}

Aktualizuje vlastnosti chatu, například téma jenom pro skupinové chaty. Vrátí chybu 400, pokud se používá v soukromém chatu, 403 pokud nemáte práva, nebo 404, pokud chat nebyl nalezen.

Požadované parametry: ID chatu, téma

mcp_graph_chat_updateChatMessage

Koncový bod:PATCH /v1.0/chats/{chat-id}/messages/{message-id}

Aktualizuje chatovou zprávu novým obsahem ve formátu prostého textu. Některé zprávy systému nebo dodržování předpisů blokují úpravy. Operace vrátí kód 403 nebo 400, pokud nejsou úpravy povoleny, nebo kód 409 v případě konfliktů.

Požadované parametry: ID chatu, message-id

Nástroje kanálu a týmu

mcp_graph_teams_addChannelMember

Koncový bod:POST /v1.0/teams/{team-id}/channels/{channel-id}/members

Přidá člena do privátního nebo sdíleného kanálu pomocí user@odata.bind, @odata.type a volitelných rolí (vlastník nebo bez hodnoty). Selhání ve standardních kanálech Vrátí hodnotu 409, pokud je člen již přítomný, a 403, pokud chybí oprávnění.

Požadované parametry: id týmu, id kanálu, displayName, role, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

Koncový bod:POST /v1.0/teams/{team-id}/channels

Vytvoří kanál v týmu s volitelným popisem displayNamemembershipType (standardní, soukromý, sdílený) a volitelnými členy. Soukromé nebo sdílené kanály vyžadují explicitní členy. Duplicitní nebo neplatné členství způsobí chybu 400 nebo 409.

Požadované parametry: team-id, displayName

Volitelné parametry: popis, typ členství, členové

mcp_graph_teams_createPrivateChannel

Koncový bod:POST /v1.0/teams/{team-id}/channels

Vytvoří privátní kanál nastavením membershipType na private. Při vytváření kanálu musíte zahrnout členy a seznam členů musí mít alespoň jednoho vlastníka. Vrátí hodnotu 400, pokud chybí členové, 409 pro duplicitní názvy nebo 403, pokud volající nemá oprávnění.

Požadované parametry: id týmu, displayName, členové

mcp_graph_teams_getChannel

Koncový bod:GET /v1.0/teams/{team-id}/channels/{channel-id}

Načte kanál s volitelným $select a $filter. Vrátí hodnotu 404, pokud kanál nenajde nebo volající nemá přístup, 403, pokud nejsou dostatečná oprávnění nebo 400 pro nepodporované filtry.

Požadované parametry: team-id, channel-id

Volitelné parametry:$select, $filter

mcp_graph_teams_getTeam

Koncový bod:GET /v1.0/teams/{team-id}

Načte vlastnosti týmu s volitelným $select a $expand. Vrátí hodnotu 403 nebo 404, pokud je tým nepřístupný.

Požadované parametry: ID týmu

Volitelné parametry:$select, $expand

mcp_graph_teams_listChannelMembers

Koncový bod:GET /v1.0/teams/{team-id}/channels/{channel-id}/members

Zobrazí seznam všech členů konkrétního kanálu Microsoft Teams. Vrátí metadata o každém členovi, jako je identita, role a stav členství. Tyto informace jsou užitečné pro auditování účasti kanálu, ověření členství před aktualizacemi rolí nebo zajištění dodržování předpisů.

Požadované parametry: team-id, channel-id

Volitelné parametry:$top, $expand

mcp_graph_teams_listChannelMessages

Koncový bod:GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Vypíše zprávy v kanálu. K přizpůsobení výsledků použijte volitelné $top parametry a $expand parametry. Slouží $expand například k zahrnutí odpovědí. Stránkování se zpracovává přes @odata.nextLink. Vrátí hodnotu 403 bez oprávnění ke čtení nebo 400 pro neplatné možnosti dotazu.

Požadované parametry: team-id, channel-id

Volitelné parametry:$top, $expand

mcp_graph_teams_listChannels

Koncový bod:GET /v1.0/teams/{team-id}/allChannels

Zobrazí seznam kanálů v týmu. K přizpůsobení výsledků použijte volitelné $select parametry nebo $filter parametry. Vrátí privátní a sdílené kanály pouze v případě, že je volající členem. Selže s chybou 403, pokud volající nemá oprávnění ke čtení nebo 400 u neplatných dotazů OData.

Požadované parametry: ID týmu

Volitelné parametry:$select, $filter

mcp_graph_teams_listTeams

Koncový bod:GET /v1.0/users/{user-id}/joinedTeams

Zobrazí seznam připojených týmů konkrétního uživatele. Vrátí pouze členství daného uživatele, ne všechny týmy tenantů. Vrátí hodnotu 403, pokud volající nemůže dotazovat uživatele nebo 404, pokud je ID neplatné.

Požadované parametry: id uživatele

mcp_graph_teams_postChannelMessage

Koncový bod:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

Publikuje zprávu ve formátu prostého textu do kanálu. Vyžaduje id týmu, id kanálu a body.content. Vrátí hodnotu 403 bez ChannelMessage.Send, 404, pokud kanál nebyl nalezen, nebo 400, pokud chybí obsah.

Požadované parametry: team-id, channel-id, tělo

mcp_graph_teams_replyToChannelMessage

Koncový bod:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

Odpoví na zprávu v kanálu pomocí body.content. Podporuje se jenom prostý text. Vrátí hodnotu 404, pokud nadřazená zpráva nebyla nalezena, 403 bez práv nebo 400 pro neplatný obsah.

Požadované parametry: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

Koncový bod:PATCH /teams/{team-id}/channels/{channel-id}

Aktualizuje kanál s novým displayName nebo popisem. Omezení se můžou vztahovat na speciální kanály, jako je Obecné. Vrátí hodnotu 403 bez práv, 409 u duplicitních názvů nebo 400 pro neplatný vstup.

Požadované parametry: team-id, channel-id

Volitelné parametry: displayName, description

mcp_graph_teams_updateChannelMember

Koncový bod:PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

Aktualizuje roli člena v privátním nebo sdíleném kanálu změnou rolí. Standardní kanály dědí role od týmu a obvykle odmítají aktualizace. Vrátí hodnotu 400 při pokusu o použití standardních kanálů, 403 při neautorizovaném přístupu nebo 404, pokud člen nebyl nalezen.

Požadované parametry: team-id, channel-id, membership-id, roles

Podporované operace

• Správa chatu (vytvoření, čtení, aktualizace, odstranění)
• Operace se zprávami (odesílání, načítání, úpravy, odstranění)
• Správa kanálů (vytvoření, konfigurace, výpis)
• Správa členů (přidání, aktualizace, seznam)
• Týmové operace (načtení, výpis)

Klíčové funkce

• Úplné operace vytváření, čtení, aktualizace a odstraňování (CRUD) pro chaty a kanály
• Podpora privátních, sdílených a standardních kanálů
• Vytváření vláken zpráv a odpovědi
• Správa rolí členů
• Podpora dotazů OData pro filtrování a stránkování