ข้อมูลอ้างอิง Teams (พรีวิว)

Note

บทความนี้อธิบายคุณสมบัติที่ใช้ในเอเจนต์หรือการไหลของเอเจนต์ที่ขับเคลื่อนโดยฮาร์เนสมาตรฐาน

Important

นี่เป็นฟีเจอร์ตัวอย่าง

• Microsoft เผยแพร่ฟีเจอร์ตัวอย่างก่อนการเปิดตัวอย่างเป็นทางการเพื่อให้ลูกค้าสามารถเข้าถึงและให้ข้อเสนอแนะได้ก่อน
• ฟีเจอร์ตัวอย่างมีฟังก์ชันการทํางานที่จํากัดและไม่เหมาะสําหรับการใช้งานด้านการผลิต
• Microsoft อาจเปลี่ยนชื่อและพารามิเตอร์ของเครื่องมือ MCP รุ่นตัวอย่าง หลีกเลี่ยงการพึ่งพาแบบฮาร์ดโค้ด Microsoft ยังคงรองรับสถานการณ์การใช้งาน
• ฟีเจอร์ตัวอย่างจะขึ้นอยู่กับMicrosoft ข้อกําหนดการใช้เพิ่มเติม

Note

เครื่องมือ MCP Microsoft 365 เฉพาะสําหรับแอปพลิเคชัน (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User และ Word) มีไว้เพื่อความเข้ากันได้ย้อนหลังเท่านั้น และไม่ควรใช้ในสภาพแวดล้อมการผลิตหรือโครงการใหม่ สําหรับโครงการใหม่ที่ต้องการเข้าถึงทรัพยากร Microsoft 365 ให้ใช้ Work IQ MCP ร่วมกับ GitHub Copilot harness สําหรับข้อมูลเพิ่มเติม ดูที่ Work IQ MCP ใน Copilot Studio

Overview

ID ของเซิร์ฟเวอร์	URL ระดับผู้เช่า	ชื่อที่แสดง	ขอบเขต	คำอธิบาย
mcp_TeamsServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_TeamsServer	ทีม	McpServers.Teams.All	เครื่องมือ Microsoft Teams สําหรับจัดการแชท ช่องทาง และผู้ใช้หรือข้อความภายในแชทเหล่านั้น ใช้เซิร์ฟเวอร์ MCP นี้สําหรับการดําเนินงานของ Teams เช่นการสร้าง การอัปเดต และการดึงข้อมูลการสนทนาและการสนทนา การจัดการทีมและช่อง และการดําเนินงานการดูแลระบบที่เกี่ยวข้องกับงานเหล่านี้

เครื่องมือแชท

mcp_graph_chat_addChatMember

ปลาย ทาง:POST /v1.0/chats/{chat-id}/members

เพิ่มสมาชิกลงในแชทโดยใช้ user@odata.bind, @odata.type และบทบาทที่เลือกได้ (สมาชิก, เจ้าของ) แสดงรหัสข้อผิดพลาด 409 ถ้าเป็นสมาชิกอยู่แล้ว รหัสข้อผิดพลาด 400 สําหรับการอ้างอิงผู้ใช้ที่ไม่ถูกต้อง หรือรหัสข้อผิดพลาด 403 ถ้านโยบายจํากัดการเพิ่ม

พารามิเตอร์ที่จําเป็น: chat-id, @odata.type, user@odata.bind, บทบาท

mcp_graph_chat_createChat

ปลาย ทาง:POST /v1.0/chats

สร้างแชทกับ chatType Teams ใหม่ (oneOnOne ต้องมีผู้เข้าร่วมสองรายอย่างแน่นอน กลุ่มต้องมีสมาชิกมากกว่าสองคน) และสมาชิก ส่งกลับ 400 หาก oneOnOne มีจำนวนสมาชิกไม่ถูกต้อง, 409 หากผู้เข้าร่วมชุดเดิมมีแชทอยู่แล้ว หรือ 403 หากผู้เรียกไม่มีสิทธิ์

พารามิเตอร์ที่จําเป็น:chatType, สมาชิก

mcp_graph_chat_deleteChat

ปลาย ทาง:DELETE /v1.0/chats/{chat-id}

ลบการสนทนาแบบนุ่มนวล แสดง 403 ถ้าสิทธิ์หายไป หรือ 404 ถ้าถูกลบไปแล้ว นโยบายการเก็บรักษาผู้เช่าจะควบคุมการดําเนินการนี้

พารามิเตอร์ที่จําเป็น: chat-id

mcp_graph_chat_ลบข้อความแชท

ปลาย ทาง:POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

ลบข้อความแชทแบบนุ่มนวล ส่งกลับ 403 โดยไม่มี Chat.ReadWrite404 สําหรับ ID ที่ไม่ถูกต้องและอาจยังคงรักษาข้อความสําหรับการปฏิบัติตามกฎระเบียบ

พารามิเตอร์ที่จําเป็น: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

ปลาย ทาง:GET /v1.0/chats/{chat-id}

ดึงข้อมูลแชทด้วย ID แสดงเมตาดาต้า เช่น ชนิดและหัวข้อ แสดง 404 หากไม่มีแชทหรือไม่สามารถมองเห็นได้ หรือแสดง 403 หากมีการปฏิเสธสิทธิ์

พารามิเตอร์ที่จําเป็น: chat-id

mcp_graph_chat_getChatMessage

ปลาย ทาง:GET /v1.0/chats/{chat-id}/messages/{message-id}

เรียกใช้ข้อความแชทตาม ID แสดงค่า 404 ถ้าข้อความไม่มีอยู่ หรือถูกซ่อน หรือ 403 โดยไม่มีสิทธิ์ที่เหมาะสม

พารามิเตอร์ที่จําเป็น: chat-id, message-id

mcp_graph_chat_listChatMembers

ปลาย ทาง:GET /v1.0/chats/{chat-id}/members

แสดงรายการผู้เข้าร่วมในแชท ส่งคืนบทบาท (สมาชิก, เจ้าของ หรือผู้เยี่ยมชม) ส่งกลับ 403 โดยไม่มีสิทธิ์ในการอ่านหรือ 404 หากไม่พบการสนทนา

พารามิเตอร์ที่จําเป็น: chat-id

mcp_graph_chat_listChatMessages

ปลาย ทาง:GET /v1.0/chats/{chat-id}/messages

แสดงรายการข้อความในแชทพร้อมตัวเลือก $top, $filterและ$orderby ส่งกลับผลลัพธ์แบบแบ่งหน้า การปฏิบัติตามกฎระเบียบอาจซ่อนเนื้อหา ข้อผิดพลาดได้แก่ 400 สำหรับการสอบถามที่ไม่ถูกต้อง และ 429 สำหรับการควบคุมปริมาณการใช้

พารามิเตอร์ที่จําเป็น: chat-id

พารามิเตอร์ตัวเลือก:$top, $filter$orderby

mcp_graph_chat_listChats

ปลาย ทาง:GET /v1.0/chats

แสดงรายการแชทสําหรับผู้โทรที่เลือก$topได้ , $filter, $expandและ$orderby แสดงเฉพาะการสนทนาที่มองเห็นได้เท่านั้น การสนทนาที่ซ่อนไว้หรือระบบอาจถูกแยกออก แสดง 400 สําหรับนิพจน์การเรียงลําดับที่ไม่ถูกต้อง

พารามิเตอร์ตัวเลือก:$top, $orderby, , $expand$filter

mcp_graph_chat_postMessage

ปลาย ทาง:POST /v1.0/chats/{chat-id}/messages

โพสต์ข้อความธรรมดาใหม่ในแชท ต้องการ chat-id และ nonempty body.content; รองรับเฉพาะข้อความเท่านั้น อาจส่งกลับ 429 สําหรับการจํากัดผลลัพธ์ 403 หากการอนุญาตหายไป หรือ 404 หากการแชทไม่ถูกต้อง ไม่ใช่ idempotent—avoid การลองใหม่แบบไม่ตรวจสอบก่อน

พารามิเตอร์ที่จําเป็น: chat-id, body

mcp_graph_chat_updateChat

ปลาย ทาง:PATCH /v1.0/chats/{chat-id}

อัปเดตคุณสมบัติการสนทนา เช่น หัวข้อสําหรับการสนทนากลุ่มเท่านั้น ล้มเหลวด้วย 400 หากใช้ในการแชทแบบตัวต่อตัว, 403 โดยไม่มีสิทธิ์หรือ 404 หากไม่พบการสนทนา

พารามิเตอร์ที่จําเป็น: chat-id, topic

mcp_graph_chat_updateChatMessage

ปลาย ทาง:PATCH /v1.0/chats/{chat-id}/messages/{message-id}

อัปเดตข้อความแชทด้วยเนื้อหาข้อความธรรมดาใหม่ ระบบหรือข้อความการปฏิบัติตามกฎระเบียบบางอย่างบล็อกการแก้ไข การดําเนินการจะส่งกลับ 403 หรือ 400 ถ้าการแก้ไขไม่ได้รับอนุญาต หรือ 409 สําหรับข้อขัดแย้ง

พารามิเตอร์ที่จําเป็น: chat-id, message-id

เครื่องมือของแชนเนลและทีม

mcp_graph_teams_addChannelMember

ปลาย ทาง:POST /v1.0/teams/{team-id}/channels/{channel-id}/members

เพิ่มสมาชิกไปยังช่องทางส่วนตัวหรือช่องทางที่ใช้ร่วมกันโดยใช้ user@odata.bind@odata.type และบทบาทที่เลือกได้ (เจ้าของหรือว่างเปล่า) ล้มเหลวบนแชนเนลมาตรฐาน ส่งกลับ 409 ถ้าเป็นสมาชิกอยู่แล้ว และ 403 หากไม่มีสิทธิ์

พารามิเตอร์ที่จําเป็น: team-id, channel-id, displayName, roles, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

ปลาย ทาง:POST /v1.0/teams/{team-id}/channels

สร้างช่องในทีมที่มี displayNameคําอธิบาย membershipType ทางเลือก (มาตรฐาน ส่วนตัว แชร์) และสมาชิกทางเลือก ช่องส่วนตัวหรือช่องที่แชร์จําเป็นต้องมีสมาชิกที่ชัดเจน การซ้ําหรือการเป็นสมาชิกที่ไม่ถูกต้องทําให้เกิด 400 หรือ 409

พารามิเตอร์ที่จําเป็น: team-id, displayName

พารามิเตอร์ตัวเลือก: คําอธิบาย ประเภทสมาชิก สมาชิก

mcp_graph_teams_createPrivateChannel

ปลาย ทาง:POST /v1.0/teams/{team-id}/channels

สร้างช่องส่วนตัวโดยการตั้งค่าmembershipTypeเป็นprivate คุณต้องมีสมาชิกเมื่อคุณสร้างช่อง และรายการสมาชิกต้องมีเจ้าของอย่างน้อยหนึ่งคน แสดง 400 ถ้าสมาชิกหายไป 409 สําหรับชื่อที่ซ้ํากัน หรือ 403 ถ้าผู้เรียกไม่มีสิทธิ์

พารามิเตอร์ที่จําเป็น: team-id, displayName, members

mcp_graph_teams_getChannel

ปลาย ทาง:GET /v1.0/teams/{team-id}/channels/{channel-id}

ดึงข้อมูลช่องพร้อม $select และ $filter ที่เป็นตัวเลือก แสดง 404 ถ้าไม่พบช่อง หรือผู้เรียกไม่สามารถเข้าถึง 403 ถ้าสิทธิ์ไม่เพียงพอ หรือ 400 สําหรับตัวกรองที่ไม่รองรับ

พารามิเตอร์ที่จําเป็น: team-id, channel-id

พารามิเตอร์ตัวเลือก:$select, $filter

mcp_graph_teams_getTeam

ปลาย ทาง:GET /v1.0/teams/{team-id}

เรียกใช้คุณสมบัติของทีมด้วย ตัวเลือก $select และ$expand ส่งกลับ 403 หรือ 404 ถ้าไม่สามารถเข้าถึงทีมได้

พารามิเตอร์ที่จําเป็น: team-id

พารามิเตอร์ตัวเลือก:$select, $expand

mcp_graph_teams_listChannelMembers

ปลาย ทาง:GET /v1.0/teams/{team-id}/channels/{channel-id}/members

แสดงรายการสมาชิกทั้งหมดของช่อง Microsoft Teams ที่เฉพาะเจาะจง ส่งกลับเมตาดาต้าเกี่ยวกับสมาชิกแต่ละราย เช่น ข้อมูลประจําตัว บทบาท และสถานะการเป็นสมาชิก ข้อมูลนี้มีประโยชน์สําหรับการตรวจสอบการเข้าร่วมแชนเนล ตรวจสอบการเป็นสมาชิกก่อนอัปเดตบทบาท หรือยืนยันการปฏิบัติตามกฎระเบียบ

พารามิเตอร์ที่จําเป็น: team-id, channel-id

พารามิเตอร์ตัวเลือก:$top, $expand

mcp_graph_teams_listChannelMessages

ปลาย ทาง:GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

แสดงรายการข้อความในช่อง ใช้พารามิเตอร์เสริม $top และ $expand เพื่อปรับแต่งผลลัพธ์ ตัวอย่างเช่น ใช้ $expand เพื่อรวมข้อความตอบกลับ การจัดแบ่งหน้าถูกจัดการผ่าน @odata.nextLink แสดง 403 โดยไม่มีสิทธิ์ในการอ่านหรือ 400 สําหรับตัวเลือกคิวรีที่ไม่ถูกต้อง

พารามิเตอร์ที่จําเป็น: team-id, channel-id

พารามิเตอร์ตัวเลือก:$top, $expand

mcp_graph_teams_listChannels

ปลาย ทาง:GET /v1.0/teams/{team-id}/allChannels

แสดงรายการช่องในทีม ใช้พารามิเตอร์ที่เลือกได้ $select หรือ $filter เพื่อปรับแต่งผลลัพธ์ ส่งกลับช่องส่วนตัวและช่องที่แชร์เฉพาะเมื่อผู้โทรเป็นสมาชิกเท่านั้น ล้มเหลวด้วย 403 ถ้าผู้โทรไม่มีสิทธิ์ในการอ่านหรือ 400 บนคิวรี OData ที่ไม่ถูกต้อง

พารามิเตอร์ที่จําเป็น: team-id

พารามิเตอร์ตัวเลือก:$select, $filter

mcp_graph_teams_listTeams

ปลาย ทาง:GET /v1.0/users/{user-id}/joinedTeams

แสดงรายการทีมที่เข้าร่วมของผู้ใช้ที่ระบุ ส่งกลับเฉพาะสมาชิกของผู้ใช้รายนั้น ไม่ใช่ทีมผู้เช่าทั้งหมด แสดงค่า 403 ถ้าผู้เรียกไม่สามารถสอบถามผู้ใช้หรือ 404 ถ้า ID ไม่ถูกต้อง

พารามิเตอร์ที่จําเป็น: user-id

mcp_graph_teams_postChannelMessage

ปลาย ทาง:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

โพสต์ข้อความธรรมดาไปยังช่อง จําเป็นต้องมี team-id, channel-id และ body.content แสดง 403 โดยไม่มี ChannelMessage.Send ซึ่งเป็น 404 ถ้าไม่พบช่อง หรือ 400 ถ้าเนื้อหาหายไป

พารามิเตอร์ที่จําเป็น: team-id, channel-id, body

mcp_graph_teams_replyToChannelMessage

ปลาย ทาง:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

การตอบกลับข้อความในแชนเนลโดยใช้ body.content รองรับเฉพาะข้อความธรรมดาเท่านั้น แสดง 404 ถ้าไม่พบข้อความหลัก 403 ที่ไม่มีสิทธิ์ หรือ 400 สําหรับเนื้อหาที่ไม่ถูกต้อง

พารามิเตอร์ที่จําเป็น: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

ปลาย ทาง:PATCH /teams/{team-id}/channels/{channel-id}

อัปเดตช่องด้วยคําอธิบายใหม่ displayName หรือ ข้อจํากัดอาจนําไปใช้กับช่องพิเศษ เช่น ทั่วไป แสดง 403 โดยไม่มีสิทธิ์ 409 ในชื่อที่ซ้ํากัน หรือ 400 สําหรับการป้อนค่าที่ไม่ถูกต้อง

พารามิเตอร์ที่จําเป็น: team-id, channel-id

พารามิเตอร์ตัวเลือก: displayName, description

mcp_graph_teams_updateChannelMember

ปลาย ทาง:PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

อัปเดตบทบาทของสมาชิกในช่องส่วนตัวหรือช่องที่แชร์โดยการเปลี่ยนบทบาท ช่องมาตรฐานสืบทอดบทบาทจากทีม และโดยปกติแล้วจะปฏิเสธการอัปเดต แสดง 400 ถ้าพยายามบนช่องมาตรฐาน 403 ถ้าไม่ได้รับอนุญาต หรือ 404 ถ้าไม่พบสมาชิก

พารามิเตอร์ที่จําเป็น: team-id, channel-id, membership-id, roles

การดำเนินการที่รองรับ

• การจัดการการสนทนา (สร้าง อ่าน อัปเดต ลบ)
• การดําเนินการข้อความ (ส่ง เรียกใช้ แก้ไข ลบ)
• การจัดการช่องทาง (สร้าง กําหนดค่า รายการ)
• การจัดการสมาชิก (เพิ่ม อัปเดต รายการ)
• การดำเนินการของทีม (ดึงข้อมูล รายการ)

คุณลักษณะสำคัญ

• การดําเนินการสร้าง อ่าน อัปเดต และลบ (CRUD) เต็มรูปแบบสําหรับการสนทนาและแชนเนล
• รองรับช่องส่วนตัว ที่ใช้งานร่วมกัน และช่องมาตรฐาน
• การเธรดข้อความและการตอบกลับ
• การจัดการบทบาทสมาชิก
• การสนับสนุนคิวรี OData สําหรับการกรองและการแบ่งหน้า