การอ้างอิงปฏิทิน (ตัวอย่าง)

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_CalendarTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_CalendarTools		 ปฏิทิน เครื่องมือสําหรับการดําเนินการปฏิทิน เช่น การสร้าง อัปเดต ดึงข้อมูลกิจกรรม จัดการคําเชิญ และตรวจสอบความพร้อมใช้งาน

เครื่องมือที่พร้อมใช้งาน

mcp_CalendarTools_graph_acceptEvent

ยอมรับคําเชิญของเหตุการณ์ที่ระบุในปฏิทินของผู้ใช้

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

  • eventId: ID ของเหตุการณ์ที่จะยอมรับ

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

  • userId: ID ผู้ใช้หรือ userPrincipalName
  • ข้อคิดเห็น: ข้อความทางเลือกที่รวมอยู่ในการตอบกลับ
  • sendResponse: ไม่ว่าจะส่งการตอบกลับไปยังผู้จัดหรือไม่

mcp_CalendarTools_graph_cancelEvent

ยกเลิกเหตุการณ์ในปฏิทินของผู้ใช้ที่ระบุ และแจ้งให้ผู้เข้าร่วมประชุมทราบ

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

  • eventId: ตัวระบุที่ไม่ซ้ํากันของเหตุการณ์ที่จะยกเลิก

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

  • userId: ID ผู้ใช้หรือ userPrincipalName
  • ข้อคิดเห็น: ข้อความยกเลิกที่เป็นทางเลือก

mcp_CalendarTools_graph_createEvent

สร้างเหตุการณ์ปฏิทินใหม่ในปฏิทินของผู้ใช้ที่ระบุ สนับสนุนเหตุการณ์ที่เป็นกิจวัตรและการประชุมแบบออนไลน์

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

  • เรื่อง: หัวเรื่องหรือชื่อเรื่องของเหตุการณ์ (ไม่เป็นทางการ)
  • start: เริ่มประทับเวลาด้วย dateTime และ timeZone
  • end: สิ้นสุดประทับเวลาด้วย dateTime และ timeZone
  • attendees_addresses: อาร์เรย์ของที่อยู่อีเมลผู้เข้าร่วม

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

  • userId: ID ผู้ใช้หรือ userPrincipalName
  • เนื้อความ: เนื้อความเหตุการณ์ที่มี contentType (ข้อความ/HTML) และเนื้อหา
  • ตําแหน่งที่ตั้ง: ตําแหน่งที่ตั้งที่มี displayName
  • attendees_types: บทบาทที่เข้าร่วมประชุม (จําเป็น ไม่บังคับ ทรัพยากร)
  • attendees_names: ชื่อที่แสดงของผู้เข้าร่วมประชุม
  • การเกิดซ้ำ: รูปแบบและช่วงของการเกิดซ้ำ
  • isOnlineMeeting: ตั้งค่าเป็น จริง สําหรับการประชุมแบบออนไลน์
  • onlineMeetingProvider: teamsForBusiness, skypeForBusinessskypeForConsumer
  • allowNewTimeProposals: อนุญาตให้มีข้อเสนอเวลา (ค่าเริ่มต้น: จริง)
  • transactionId: Idempotence ตัวระบุ

mcp_CalendarTools_graph_declineEvent (ปฏิเสธเหตุการณ์ในปฏิทิน)

ปฏิเสธคําเชิญเหตุการณ์ที่ระบุในปฏิทินของผู้ใช้

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

  • eventId: รหัสของกิจกรรมที่จะปฏิเสธ

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

  • userId: ID ผู้ใช้หรือ userPrincipalName

  • ข้อคิดเห็น: ข้อความเพิ่มเติมในการตอบกลับ

  • sendResponse: ต้องการส่งการตอบกลับหรือไม่

mcp_CalendarTools_graph_deleteEvent

ลบเหตุการณ์จากปฏิทินของผู้ใช้ที่ระบุ

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

  • eventId: ตัวระบุที่ไม่ซ้ํากันของเหตุการณ์ที่จะลบ

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

  • userId: ID ผู้ใช้หรือ userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

แนะนําเวลาการประชุมและตําแหน่งที่ตั้งตามการจัดประชุมและความพร้อมใช้งานของผู้เข้าร่วม

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

  • meetingDuration: ระยะเวลาการประชุม (ตัวอย่างเช่น 'PT1H')

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

  • userId: ID ผู้จัด หรือ userPrincipalName
  • attendees_addresses: ที่อยู่อีเมลของผู้เข้าร่วมประชุม
  • attendees_types: ชนิดผู้เข้าร่วม
  • attendees_names: ชื่อที่แสดงของผู้เข้าร่วมประชุม
  • timeConstraint: ช่วงเวลาที่พร้อมใช้งานร่วมกับ timeslots และ activityDomain
  • locationConstraint: ตัวเลือกตําแหน่งที่ตั้ง
  • maxCandidates: คําแนะนําสูงสุด
  • isOrganizerOptional: ค่าสถานะว่าผู้จัดเป็นตัวเลือกหรือไม่
  • returnSuggestionReasons: รวมเหตุผล
  • minimumAttendeePercentage: ค่าเกณฑ์การเข้าร่วมต่ําสุด

mcp_CalendarTools_graph_getEvent

รับเหตุการณ์ปฏิทินเดียวจากปฏิทินของผู้ใช้ที่ระบุ

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

  • eventId: ตัวระบุที่ไม่ซ้ํากันของเหตุการณ์

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

  • userId: ID ผู้ใช้หรือ userPrincipalName
  • เลือก: พารามิเตอร์คิวรี OData \$select
  • ขยาย: OData \$expand สําหรับคุณสมบัติการนําทาง

mcp_CalendarTools_graph_getSchedule

รับกําหนดการว่าง/ไม่ว่างสําหรับผู้ใช้ รายชื่อการแจกจ่าย หรือทรัพยากร

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

  • กําหนดการ: ที่อยู่ SMTP ของผู้ใช้หรือแหล่งข้อมูล
  • startTime: เวลาเริ่มต้นด้วย dateTime และ timeZone
  • endTime: เวลาสิ้นสุดด้วย dateTime และ timeZone

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

  • userId: ID ผู้ใช้หรือ userPrincipalName
  • availabilityViewInterval: ความยาวของช่วงเวลาเป็นนาที

mcp_CalendarTools_graph_listCalendarView

เรียกใช้ปฏิทินที่เกิดขึ้นภายในช่วงเวลาที่ระบุสําหรับผู้ใช้

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

  • startDateTime: การเริ่มต้นของช่วงเวลา (ISO 8601)
  • endDateTime: สิ้นสุดช่วงเวลา (ISO 8601)

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

  • userId: ID ผู้ใช้หรือ userPrincipalName
  • ด้านบน: จํานวนสูงสุดของเหตุการณ์
  • orderby: อนุประโยค ORDER BY

mcp_CalendarTools_graph_listEvents

เรียกใช้รายการของเหตุการณ์จากปฏิทินของผู้ใช้ที่ระบุ

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

  • userId: ID ผู้ใช้หรือ userPrincipalName
  • startDateTime: การเริ่มต้นของช่วงเวลา (ISO 8601)
  • endDateTime: สิ้นสุดช่วงเวลา (ISO 8601)
  • ด้านบน: จํานวนสูงสุดของเหตุการณ์
  • filter: คิวรีตัวกรอง OData
  • orderby: ลําดับ OData ตามคิวรี

mcp_CalendarTools_graph_updateEvent

อัปเดตเหตุการณ์ปฏิทินที่มีอยู่ในปฏิทินของผู้ใช้ที่ระบุ

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

  • eventId: ตัวระบุที่ไม่ซ้ํากันของเหตุการณ์

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

  • userId: ID ผู้ใช้หรือ userPrincipalName
  • เรื่อง: เรื่องที่อัปเดตแล้ว
  • เนื้อความ: เนื้อความที่อัปเดตแล้ว
  • start: เวลาเริ่มต้นที่ปรับปรุงแล้ว
  • สิ้นสุด: เวลาสิ้นสุดที่อัปเดต
  • ตําแหน่งที่ตั้ง: ตําแหน่งที่อัปเดตแล้ว
  • attendees_addresses: อัปเดตอีเมลผู้เข้าร่วม
  • attendees_types: ชนิดผู้เข้าร่วมที่อัปเดตแล้ว
  • attendees_names: ชื่อผู้เข้าร่วมที่อัปเดตแล้ว
  • isCancelled: ตั้งค่าเป็นจริงเพื่อยกเลิก
  • การเกิดซ้ำ: รูปแบบการเกิดซ้ำที่อัปเดตแล้ว

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

การจัดการเหตุการณ์

  • สร้าง อ่าน อัปเดต และลบเหตุการณ์
  • ยอมรับ ปฏิเสธ และยกเลิกคําเชิญ
  • สนับสนุนกิจกรรมที่เกิดซ้ํา
  • การเชื่อมต่อกับการประชุมออนไลน์ (Teams, Skype)

ความพร้อมใช้งานและการจัดกําหนดการ

  • ดูตารางเวลาว่าง/ไม่ว่าง
  • ค้นหาเวลานัดพบพร้อมตรวจสอบความพร้อมให้บริการ
  • มุมมองปฏิทินพร้อมการกรองช่วงเวลา
  • การวิเคราะห์ความพร้อมของผู้เข้าร่วม

การจัดการผู้เข้าร่วม

  • จัดการผู้เข้าร่วมที่จำเป็น ผู้เข้าร่วมแบบไม่บังคับ และผู้เข้าร่วมที่เป็นทรัพยากร
  • สนับสนุนข้อเสนอเรื่องเวลา
  • ติดตามการตอบกลับ
  • รองรับรายชื่อผู้แจกจ่าย

รูปแบบการเกิดซ้ำ

  • รูปแบบรายวัน รายสัปดาห์ รายเดือน และรายปี
  • การเกิดซ้ําแบบสัมบูรณ์และสัมพัทธ์
  • วันที่สิ้นสุดหรือจํานวนการเกิดขึ้น
  • ข้อกําหนดวันในสัปดาห์และเดือน

การประชุมแบบออนไลน์

  • การบูรณาการกับ Microsoft Teams เพื่อธุรกิจ
  • การสนับสนุนสําหรับ Skype สําหรับธุรกิจ
  • การสนับสนุนสําหรับ Skype (สําหรับการใช้งานส่วนบุคคล)
  • การสร้างลิงก์การประชุมโดยอัตโนมัติ

หมายเหตุ

  • ประทับเวลาทั้งหมดใช้รูปแบบ UTC/ISO 8601 กับโซนเวลา
  • MCP ปฏิทินต้องอาศัย UserprofileMCP ในการค้นหาผู้ใช้ในองค์กร
  • ที่อยู่อีเมลต้องเป็นรูปแบบที่ถูกต้อง
  • อาร์เรย์ที่ผู้เข้าร่วม (ที่อยู่ ชนิด ชื่อ) ต้องอยู่ในลําดับเดียวกัน
  • การประชุมแบบออนไลน์จําเป็นต้องใช้ isOnlineMeeting=true และ onlineMeetingProvider
  • การเกิดขึ้นประจําต้องการทั้งออบเจกต์ลักษณะและช่วง
  • โซนเวลาควรสอดคล้องกันในเวลาเริ่มต้นและสิ้นสุด
  • TransactionId idempotentเปิดใช้งานการสร้างเหตุการณ์
  • Last updated on