การอ้างอิงอีเมล (ตัวอย่าง)

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_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	ไปรษณีย์	เครื่องมือสําหรับการดําเนินงานอีเมลของ 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 รองรับการควบคุมการทำงานพร้อมกันสำหรับการอัปเดต