Referensi tim (pratinjau)

Note

Artikel ini menjelaskan fitur yang digunakan oleh agen atau alur agen yang didukung oleh standard harness.

Important

Ini adalah fitur pratinjau.

• Microsoft merilis fitur pratinjau sebelum rilis resmi sehingga pelanggan bisa mendapatkan akses awal dan memberikan umpan balik.
• Fitur pratinjau memiliki fungsionalitas terbatas dan tidak dimaksudkan untuk penggunaan produksi.
• Microsoft mungkin mengubah nama dan parameter pratinjau untuk alat MCP. Hindari dependensi yang dikodekan secara permanen. Microsoft mempertahankan dukungan skenario.
• Fitur pratinjau tunduk pada ketentuan penggunaan tambahan Microsoft.

Ikhtisar

ID Server	URL tingkat penyewa	Nama tampilan	Ruang lingkup	Deskripsi
mcp_TeamsServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_TeamsServer	Teams	McpServers.Teams.All	Alat Microsoft Teams untuk mengelola chat, saluran, serta pengguna atau pesan di dalamnya. Gunakan McP Server ini untuk operasi Teams seperti membuat, memperbarui, dan mengambil obrolan dan pesan obrolan, mengelola tim dan saluran, dan melakukan tugas administratif yang terkait dengan tugas-tugas ini.

Alat chat

mcp_graph_chat_addChatMember

Titik Akhir:POST /v1.0/chats/{chat-id}/members

Menambahkan anggota ke obrolan dengan menggunakan user@odata.bind, @odata.type, dan peran opsional (anggota, pemilik). Mengembalikan kode kesalahan 409 jika anggota sudah ada, kode kesalahan 400 untuk referensi pengguna yang tidak valid, atau kode kesalahan 403 jika kebijakan membatasi penambahan.

Parameter yang diperlukan: chat-id, @odata.type, user@odata.bind, roles

mcp_graph_chat_createChat

Titik Akhir:POST /v1.0/chats

Buat chat Teams baru dengan chatType (oneOnOne harus terdiri dari tepat dua peserta, grup harus terdiri dari lebih dari dua peserta) serta anggota. Mengembalikan 400 jika oneOnOne memiliki jumlah anggota yang salah, 409 jika peserta yang sama sudah memiliki obrolan, atau 403 jika pemanggil tidak memiliki hak.

Parameter yang diperlukan:chatType, anggota

mcp_graph_chat_deleteChat

Titik Akhir:DELETE /v1.0/chats/{chat-id}

Menghapus sementara obrolan. Mengembalikan 403 jika izin hilang atau 404 jika sudah dihapus. Kebijakan retensi penyewa mengatur operasi ini.

Parameter yang diperlukan: chat-id

mcp_graph_chat_deleteChatMessage

Titik Akhir:POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

Menghapus pesan obrolan secara sementara. Mengembalikan 403 tanpa Chat.ReadWrite, 404 untuk ID yang tidak valid, dan mungkin tetap menyimpan pesan tersebut demi kepatuhan.

Parameter yang diperlukan: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

Titik Akhir:GET /v1.0/chats/{chat-id}

Mengambil obrolan berdasarkan ID. Mengembalikan metadata seperti jenis dan topik. Mengembalikan 404 jika obrolan tidak ada atau tidak terlihat, atau 403 jika izin ditolak.

Parameter yang diperlukan: chat-id

mcp_graph_chat_getChatMessage

Titik Akhir:GET /v1.0/chats/{chat-id}/messages/{message-id}

Mengambil pesan obrolan berdasarkan ID. Mengembalikan 404 jika pesan tidak ada atau disembunyikan, atau 403 tanpa hak yang tepat.

Parameter yang diperlukan: chat-id, message-id

mcp_graph_chat_listChatMembers

Titik Akhir:GET /v1.0/chats/{chat-id}/members

Menampilkan peserta chat. Mengembalikan peran (anggota, pemilik, atau tamu). Mengembalikan 403 tanpa izin baca atau 404 jika obrolan tidak ditemukan.

Parameter yang diperlukan: chat-id

mcp_graph_chat_listChatMessages

Titik Akhir:GET /v1.0/chats/{chat-id}/messages

Mencantumkan pesan dalam obrolan dengan opsional $top, , $filterdan $orderby. Mengembalikan hasil halaman. Kepatuhan mungkin menyembunyikan konten. Kesalahan mencakup 400 untuk kueri yang tidak valid dan 429 untuk pelambatan.

Parameter yang diperlukan: chat-id

Parameter Opsional:$top, $filter, $orderby

mcp_graph_chat_listChats

Titik Akhir:GET /v1.0/chats

Mendaftarkan obrolan untuk pemanggil dengan opsi $top, $filter, $expand, dan $orderby. Mengembalikan hanya obrolan yang terlihat; obrolan tersembunyi atau sistem mungkin dikecualikan. Mengembalikan 400 untuk ekspresi pengurutan yang tidak valid.

Parameter Opsional:$top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

Titik Akhir:POST /v1.0/chats/{chat-id}/messages

Mengirim pesan teks biasa baru dalam chat. Harus memiliki chat-id dan body.content yang tidak kosong; hanya teks yang didukung. Mungkin mengembalikan 429 untuk pembatasan laju, 403 jika izin tidak ada, atau 404 jika percakapan tidak valid. Bukan idempotent—avoid percobaan ulang secara membabi buta.

Parameter yang diperlukan: chat-id, body

mcp_graph_chat_updateChat

Titik Akhir:PATCH /v1.0/chats/{chat-id}

Memperbarui properti obrolan, seperti topik untuk obrolan grup saja. Gagal dengan 400 jika digunakan pada obrolan satu lawan satu, 403 jika tidak memiliki izin, atau 404 jika obrolan tidak ditemukan.

Parameter yang diperlukan: id obrolan, topik

mcp_graph_chat_updateChatMessage

Titik Akhir:PATCH /v1.0/chats/{chat-id}/messages/{message-id}

Memperbarui pesan obrolan dengan konten teks biasa baru. Beberapa pesan sistem atau kepatuhan memblokir pengeditan. Operasi mengembalikan 403 atau 400 jika pengeditan tidak diizinkan, atau 409 jika terjadi konflik.

Parameter yang diperlukan: chat-id, message-id

Alat Kanal dan Tim

mcp_graph_teams_addChannelMember

Titik Akhir:POST /v1.0/teams/{team-id}/channels/{channel-id}/members

Menambahkan anggota ke saluran privat atau bersama dengan menggunakan user@odata.bind, @odata.type, dan peran opsional (pemilik atau kosong). Gagal di saluran standar. Mengembalikan 409 jika anggota sudah ada, dan 403 jika tidak memiliki izin.

Parameter yang diperlukan: team-id, channel-id, , displayNameroles, , user@odata.bind@odata.type

mcp_graph_teams_createChannel

Titik Akhir:POST /v1.0/teams/{team-id}/channels

Membuat saluran dalam tim dengan displayName, deskripsi opsional, membershipType (standar, pribadi, bersama), dan anggota opsional. Saluran privat atau bersama memerlukan anggota eksplisit. Duplikat atau keanggotaan yang tidak valid menyebabkan 400 atau 409.

Parameter yang diperlukan: id-tim, displayName

Parameter Opsional: deskripsi, membershipType, anggota

mcp_graph_teams_createPrivateChannel

Titik Akhir:POST /v1.0/teams/{team-id}/channels

Membuat saluran privat dengan mengatur membershipType ke private. Anda harus menyertakan anggota saat membuat saluran, dan daftar anggota harus memiliki setidaknya satu pemilik. Mengembalikan 400 jika anggota hilang, 409 untuk nama duplikat, atau 403 jika pemanggil tidak memiliki izin.

Parameter yang diperlukan: id tim, displayName, anggota

mcp_graph_teams_getChannel

Titik Akhir:GET /v1.0/teams/{team-id}/channels/{channel-id}

Mengambil saluran dengan $select dan $filter opsional. Mengembalikan 404 jika saluran tidak ditemukan atau pemanggil tidak memiliki akses, 403 jika izin tidak mencukup, atau 400 untuk filter yang tidak didukung.

Parameter yang diperlukan: team-id, channel-id

Parameter Opsional:$select, $filter

mcp_graph_teams_getTeam

Titik Akhir:GET /v1.0/teams/{team-id}

Mengambil properti tim secara opsional dengan $select dan $expand. Mengembalikan 403 atau 404 jika tim tidak dapat diakses.

Parameter yang diperlukan: id-tim

Parameter Opsional:$select, $expand

mcp_graph_teams_listChannelMembers

Titik Akhir:GET /v1.0/teams/{team-id}/channels/{channel-id}/members

Mencantumkan semua anggota saluran Microsoft Teams tertentu. Mengembalikan metadata tentang setiap anggota, seperti identitas, peran, dan status keanggotaan. Informasi ini berguna untuk mengaudit partisipasi saluran, memverifikasi keanggotaan sebelum pembaruan peran, atau memastikan kepatuhan.

Parameter yang diperlukan: team-id, channel-id

Parameter Opsional:$top, $expand

mcp_graph_teams_listChannelMessages

Titik Akhir:GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Menampilkan daftar pesan di saluran. Gunakan parameter opsional $top dan $expand untuk menyesuaikan hasil. Misalnya, gunakan $expand untuk menyertakan balasan. Penomoran halaman ditangani melalui @odata.nextLink. Mengembalikan 403 jika tidak memiliki izin baca atau 400 jika opsi kueri tidak valid.

Parameter yang diperlukan: team-id, channel-id

Parameter Opsional:$top, $expand

mcp_graph_teams_listChannels

Titik Akhir:GET /v1.0/teams/{team-id}/allChannels

Menampilkan daftar saluran dalam tim. Gunakan parameter opsional $select atau $filter untuk menyesuaikan hasil. Mengembalikan saluran privat dan bersama hanya jika penelepon adalah anggota. Gagal dengan 403 jika pemanggil tidak memiliki hak baca atau 400 pada kueri OData yang tidak valid.

Parameter yang diperlukan: id-tim

Parameter Opsional:$select, $filter

mcp_graph_teams_listTeams

Titik Akhir:GET /v1.0/users/{user-id}/joinedTeams

Mencantumkan tim gabungan dari pengguna tertentu. Hanya mengembalikan keanggotaan pengguna tersebut, bukan keanggotaan semua tim tenant. Mengembalikan 403 jika pemanggil tidak dapat mengkueri pengguna atau 404 jika ID tidak valid.

Parameter yang diperlukan: id pengguna

mcp_graph_teams_postChannelMessage

Titik Akhir:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

Memposting pesan teks biasa ke saluran. Memerlukan team-id, channel-id, dan body.content. Mengembalikan 403 tanpa ChannelMessage.Send, 404 jika saluran tidak ditemukan, atau 400 jika konten hilang.

Parameter yang diperlukan: team-id, channel-id, body

mcp_graph_teams_balasPesanSaluran

Titik Akhir:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

Membalas pesan di saluran dengan menggunakan body.content. Hanya teks biasa yang didukung. Mengembalikan 404 jika pesan induk tidak ditemukan, 403 tanpa hak, atau 400 untuk konten yang tidak valid.

Parameter yang diperlukan: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

Titik Akhir:PATCH /teams/{team-id}/channels/{channel-id}

Memperbarui saluran dengan displayName atau deskripsi baru. Pembatasan mungkin berlaku untuk saluran khusus seperti Umum. Mengembalikan 403 tanpa hak, 409 pada nama duplikat, atau 400 untuk input yang tidak valid.

Parameter yang diperlukan: team-id, channel-id

Parameter Opsional: displayName, deskripsi

mcp_graph_teams_updateChannelMember

Titik Akhir:PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

Memperbarui peran anggota dalam channel privat atau bersama dengan mengubah perannya. Saluran standar mewarisi peran dari tim dan biasanya menolak pembaruan. Mengembalikan 400 jika dicoba pada saluran standar, 403 jika tidak sah, atau 404 jika anggota tidak ditemukan.

Parameter yang diperlukan: id tim, id saluran, id keanggotaan, peran

Operasi yang Didukung

• Manajemen obrolan (membuat, membaca, memperbarui, menghapus)
• Operasi pesan (kirim, ambil, edit, hapus)
• Manajemen saluran (membuat, mengonfigurasi, mencantumkan)
• Manajemen anggota (tambahkan, perbarui, daftar)
• Operasi tim (ambil, daftar)

Fitur utama

• Dukungan penuh untuk operasi membuat, membaca, memperbarui, dan menghapus (CRUD) pada obrolan dan saluran.
• Dukungan untuk saluran privat, bersama, dan standar.
• Utas pesan dan balasan.
• Manajemen peran anggota.
• Dukungan kueri OData untuk pemfilteran dan paginasi.