ข้อมูลอ้างอิงเมล Work IQ (พรีวิว)

สําคัญ

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

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

ภาพรวม

ID ของเซิร์ฟเวอร์	URL ระดับผู้เช่า	ชื่อที่แสดง	คำอธิบาย
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	เวิร์ก IQ เมล	เซิร์ฟเวอร์ MCP ที่มีเครื่องมือจดหมาย Microsoft Graph

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

mcp_MailTools_graph_mail_createMessage

สร้างอีเมลแบบร่าง สนับสนุน HTML โดยการตั้งค่าbody.body.contentType = "HTML"

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

• ชื่อเรื่อง: ชื่อเรื่องของข้อความ
• toRecipients: อาร์เรย์ของผู้รับที่มีที่อยู่อีเมล
• ส่วนข้อความ: เนื้อหาข้อความที่มีประเภทเนื้อหา (ข้อความ/HTML) และเนื้อหา

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

• preferHtml: ตั้งค่าเป็นจริงสําหรับเนื้อหา HTML
• เฮดเดอร์: ส่วนหัวเพิ่มเติมที่เป็นตัวเลือก

mcp_MailTools_graph_mail_deleteMessage

ลบข้อความจากกล่องจดหมายของผู้ใช้ที่ลงชื่อเข้าใช้

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

• id: ID ข้อความ

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

• If-Match: ไม่บังคับ ETag สำหรับการควบคุมการทำงานพร้อมกัน

mcp_MailTools_graph_mail_getMessage

รับข้อความตาม ID จากกล่องจดหมายของผู้ใช้ที่ลงชื่อเข้าใช้ ใช้ preferHtml เพื่อร้องขอเนื้อความ HTML

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

• id: ID ข้อความ

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

• เลือก: คำสั่งเลือก OData
• ขยาย: ส่วนคําสั่งขยาย OData
• preferHtml: ร้องขอรูปแบบเนื้อความ HTML
• ส่วนหัว: ส่วนหัว HTTP ที่เป็นตัวเลือก

มคพ_เครื่องมือจดหมาย_กราฟ_รายการจดหมาย_ส่งแล้ว

แสดงข้อความในรายการที่ส่ง

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

• กรอง: ตัวกรอง OData
• ค้น: ค้นหาคิวรี
• orderby: นิพจน์การเรียงลําดับ
• สูงสุด: จำนวนรายการที่จะส่งคืน
• เลือก: เขตข้อมูลที่จะส่งกลับ

mcp_MailTools_graph_mail_reply

ส่งข้อความตอบกลับไปยังข้อความที่มีอยู่ สนับสนุน HTML ผ่าน preferHtml หรือheaders

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

• id: ID ข้อความที่จะตอบกลับ

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

• ติชม: ข้อความตอบกลับ
• ข้อความ: การยกเลิกข้อความที่สามารถเลือกได้
• preferHtml: เปิดใช้งานการจัดรูปแบบ HTML
• ส่วนหัว: ส่วนหัว HTTP ที่เป็นตัวเลือก

mcp_MailTools_graph_mail_replyAll

ส่งการตอบกลับทั้งหมดไปยังข้อความที่มีอยู่ สนับสนุน HTML ผ่าน preferHtml หรือheaders

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

• id: ID ข้อความเพื่อใช้ตอบกลับทั้งหมด

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

• ติชม: ข้อความตอบกลับ
• ข้อความ: การยกเลิกข้อความที่สามารถเลือกได้
• preferHtml: เปิดใช้งานการจัดรูปแบบ HTML
• ส่วนหัว: ส่วนหัว HTTP ที่เป็นตัวเลือก

mcp_MailTools_graph_mail_searchMessages

ค้นหาข้อความ Outlook โดยใช้ Search API ของ Microsoft Graph ด้วยคิวรีแบบภาษาคิวรีคีย์เวิร์ด (KQL)

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

• คำขอ: อาร์เรย์ของคำขอค้นหาที่มี entityTypes, พารามิเตอร์ query, from และ size

สนับสนุนการค้นหาเนื้อหาข้อความ เรื่อง เนื้อความ และสิ่งที่แนบมา

mcp_MailTools_graph_mail_sendDraft

ส่งร่างข้อความที่มีอยู่โดยใช้ ID

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

• id: ไอดีข้อความร่างที่จะส่ง

mcp_MailTools_graph_mail_sendMail

ส่งอีเมลเป็นผู้ใช้ที่ลงชื่อเข้าใช้

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

• ข้อความ: วัตถุข้อความที่มีชื่อเรื่อง และ toRecipientsเนื้อความ
• ชื่อเรื่อง: ชื่อเรื่องอีเมล
• toRecipients: ผู้รับหลัก
• เนื้อหา: เนื้อหาอีเมลที่มีประเภทเนื้อหา (ข้อความ/HTML) และรายละเอียดเนื้อหา

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

• ccRecipients: ผู้รับสําเนาถึง
• bccRecipients: ผู้รับสําเนาลับถึง
• saveToSentItems: บันทึกเพื่อส่งรายการ (ค่าเริ่มต้น: true)
• preferHtml: บังคับให้แสดง HTML
• ส่วนหัว: ส่วนหัว HTTP เพิ่มเติมที่เป็นตัวเลือก

10. mcp_MailTools_graph_mail_updateMessage

ปรับปรุงคุณสมบัติที่เสถียรของข้อความ เช่น หัวเรื่อง เนื้อความ และประเภทของข้อความ

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

• id: ID ข้อความ

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

• ชื่อเรื่อง: เรื่องใหม่
• ข้อความ: ข้อความใหม่
• ประเภท: ประเภทข้อความ
• ความสําคัญ: ต่ํา ปกติ หรือสูง
• If-Match:ETag สำหรับการควบคุมการทำงานพร้อมกัน

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

องค์ประกอบอีเมล

• สร้างแบบร่างและส่งอีเมล
• สนับสนุน HTML และข้อความธรรมดา
• ผู้รับถึง, สําเนาถึง และสำเนาลับถึง
• ตัวเลือกการจัดรูปแบบที่หลากหลาย

การจัดการอีเมล

• รับ อัปเดต และลบข้อความ
• ฟังก์ชันการตอบกลับและตอบกลับทั้งหมด
• การจัดการฉบับร่าง
• การตั้งค่าหมวดหมู่และความสําคัญ

ค้นหาและกรอง

• การค้นหาข้อความสไตล์ KQL
• การสนับสนุนคิวรี OData
• ค้นหาทั่วทั้งหัวเรื่อง เนื้อความ และสิ่งที่แนบมา
• การแบ่งหน้าและการกรอง

Sentitems

• แสดงรายการข้อความที่ส่งแล้ว
• ตัวเลือกในการบันทึกไปยังรายการที่ส่งแล้ว
• กรองและค้นหารายการที่ส่ง

บันทึกย่อ

• การดําเนินการทั้งหมดใช้ Microsoft Graph Mail API
• เนื้อหา HTML จําเป็นต้อง contentType = "HTML" อยู่ในเนื้อความ
• preferHtml header ระบุให้ใช้รูปแบบเนื้อหาแบบ HTML
• การค้นหาใช้ Microsoft Graph Search API กับคิวรี KQL
• ข้อความร่างสามารถสร้าง อัปเดต และส่งแยกจากกันได้
• ETag รองรับการควบคุมการทำงานพร้อมกันสำหรับการอัปเดต