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

หมายเหตุ

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

สำคัญ

คุณลักษณะนี้เป็นคุณลักษณะพรีวิว

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

หมายเหตุ

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

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

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

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

mcp_graph_chat_createChat

Endpoint: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_ลบข้อความแชท

Endpoint: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

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

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

พารามิเตอร์ที่จำเป็น: แชท-ไอดี, รหัสข้อความ

mcp_graph_chat_listChatMembers

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

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

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

mcp_graph_chat_listChatMessages

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

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

พารามิเตอร์ที่ต้องการ: chat-id

พารามิเตอร์เสริม:$top , $filter, $orderby

mcp_graph_chat_listChats

Endpoint: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

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

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

พารามิเตอร์ที่จําเป็น: แชท-ไอดี, หัวข้อ

mcp_graph_chat_updateChatMessage

Endpoint: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

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

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

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

พารามิเตอร์เสริม: description, membershipType, members

mcp_graph_teams_createPrivateChannel

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

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

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

mcp_graph_teams_getChannel

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

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

พารามิเตอร์ที่ต้องการ: team-id, channel-id

พารามิเตอร์เสริม:$select$filter

mcp_graph_teams_getTeam

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

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

พารามิเตอร์ที่ต้องการ: team-id

พารามิเตอร์เสริม:$select$expand

mcp_graph_teams_listChannelMembers

Endpoint: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

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

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

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

พารามิเตอร์เสริม:$select$filter

mcp_graph_teams_listTeams

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

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

พารามิเตอร์ที่ต้องการ: user-id

mcp_graph_teams_postChannelMessage

Endpoint: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

Endpoint: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, คําอธิบาย

mcp_graph_teams_updateChannelMember

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

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

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

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

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

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

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