Referensi email (pratinjau)

Note

Artikel ini menjelaskan fitur yang digunakan pada agen atau alur agen yang didukung oleh harness standar.

Important

Ini adalah fitur pratinjau.

• Microsoft merilis fitur pratinjau sebelum rilis resmi sehingga pelanggan bisa mendapatkan akses awal dan memberikan umpan balik.
• Fitur pratinjau memiliki fungsionalitas terbatas dan tidak dimaksudkan untuk penggunaan produksi.
• Microsoft mungkin mengubah nama dan parameter pratinjau untuk alat MCP. Hindari dependensi yang dikodekan secara permanen. Microsoft mempertahankan dukungan skenario.
• Fitur pratinjau tunduk pada ketentuan penggunaan tambahan Microsoft.

Note

Alat Microsoft 365 MCP khusus aplikasi (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User, dan Word) hanya ditujukan untuk keperluan kompatibilitas mundur dan tidak boleh digunakan di lingkungan produksi atau proyek baru. Untuk proyek baru yang memerlukan akses ke sumber daya Microsoft 365, gunakan Work IQ MCP dengan harness GitHub Copilot. Untuk informasi lebih lanjut, lihat Work IQ MCP di Copilot Studio.

Overview

ID Server	URL tingkat Penyewa	Nama tampilan	Description
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	Mail	Alat untuk operasi email Microsoft Graph, termasuk membuat, mengirim, membalas, dan mengelola pesan email.

Alat yang tersedia

mcp_MailTools_graph_mail_createMessage

Buat email draf. Mendukung HTML dengan mengatur body.body.contentType = "HTML".

Parameter yang diperlukan:

• subjek: Subjek pesan
• toRecipients: Larik penerima yang berisi alamat email
• isi: Isi pesan dengan contentType (Teks/HTML) dan konten

Parameter opsional:

• preferHtml: Atur ke true untuk konten HTML
• header: Header tambahan opsional

mcp_MailTools_graph_mail_deleteMessage

Menghapus pesan dari kotak surat pengguna yang sedang masuk.

Parameter yang diperlukan:

• id: ID Pesan

Parameter opsional:

• If-Match: Opsional ETag untuk pengendalian konkurensi

mcp_MailTools_graph_mail_getMessage

Mendapatkan pesan berdasarkan ID dari kotak surat pengguna yang masuk. Gunakan preferHtml untuk meminta isi HTML.

Parameter yang diperlukan:

• id: ID Pesan

Parameter opsional:

• pilih: Klausa pilih OData
• perluas: Klausa perluas OData
• preferHtml: Format isi HTML permintaan
• header: Header HTTP opsional

mcp_MailTools_graph_mail_listSent

Mencantumkan pesan dalam item terkirim.

Parameter opsional:

• filter: Filter OData
• pencarian: Kueri pencarian
• orderby: Urutkan ekspresi
• atas: Jumlah item yang akan dikembalikan
• pilih: Bidang yang akan dikembalikan

mcp_MailTools_graph_mail_reply

Kirim balasan ke pesan yang sudah ada. Mendukung HTML melalui preferHtml atau headers.

Parameter yang diperlukan:

• id: ID Pesan untuk membalas

Parameter opsional:

• komentar: Teks balasan
• pesan: Penggantian pesan opsional
• preferHtml: Mengaktifkan pemformatan HTML
• header: Header HTTP opsional

mcp_MailTools_graph_mail_replyAll

Kirim balas ke semua untuk pesan yang ada. Mendukung HTML melalui preferHtml atau headers.

Parameter yang diperlukan:

• id: ID Pesan untuk balas ke semua

Parameter opsional:

• komentar: Teks balasan
• pesan: Penggantian pesan opsional
• preferHtml: Mengaktifkan pemformatan HTML
• header: Header HTTP opsional

mcp_MailTools_graph_mail_searchMessages

Cari pesan Outlook menggunakan Microsoft Graph Search API dengan kueri bergaya Keyword Query Language (KQL).

Parameter yang diperlukan:

• permintaan: Larik permintaan pencarian dengan parameter entityTypes, kueri, dari, dan ukuran

Mendukung pencarian konten pesan, subjek, isi, dan lampiran

mcp_MailTools_graph_mail_sendDraft

Kirim pesan draf yang sudah ada dengan ID.

Parameter yang diperlukan:

• id: ID pesan draf untuk dikirim

mcp_MailTools_graph_mail_sendMail

Kirim email sebagai pengguna yang masuk.

Parameter yang diperlukan:

• Pesan: Objek pesan dengan subjek, toRecipients, dan isi
• subjek: Subjek email
• toRecipients: Penerima utama
• isi: Isi email dengan contentType (Teks/HTML) dan konten

Parameter opsional:

• ccRecipients: Penerima salinan karbon
• bccRecipients: Penerima salinan karbon buta
• saveToSentItems: Simpan ke pesan terkirim (default: true)
• preferHtml: Perenderan HTML paksa
• header: Header HTTP tambahan opsional

10. mcp_MailTools_graph_mail_updateMessage

Memperbarui properti pesan yang dapat diubah, seperti subjek, isi, dan kategori.

Parameter yang diperlukan:

• id: ID Pesan

Parameter opsional:

• subjek: Subjek baru
• isi: Isi pesan baru
• kategori: Kategori pesan
• kepentingan: Rendah, Normal, atau Tinggi
• If-Match:ETag untuk kontrol konkurensi

Fitur utama

Komposisi email

• Membuat draf dan mengirim email
• Dukungan HTML dan teks biasa
• Penerima Untuk, CC, dan BCC
• Opsi pemformatan kaya

Manajemen email

• Mendapatkan, memperbarui, dan menghapus pesan.
• Fungsionalitas balas dan balas semua.
• Manajemen draf.
• Pengaturan kategori dan prioritas.

Pencarian dan pemfilteran

• Pencarian pesan bergaya KQL.
• Dukungan kueri OData.
• Cari dalam subjek, isi, dan lampiran.
• Penomoran halaman dan pemfilteran.

Sentitems

• Mencantumkan pesan terkirim.
• Opsi untuk menyimpan ke item terkirim.
• Memfilter dan mencari item terkirim.

Notes

• Semua operasi menggunakan Microsoft Graph Mail API.
• Konten HTML memerlukan contentType = "HTML" di badan.
• preferHtml header meminta format isi HTML.
• Pencarian menggunakan Microsoft Graph Search API dengan kueri KQL.
• Pesan draf dapat dibuat, diperbarui, dan dikirim secara terpisah.
• ETag dukungan untuk kontrol konkurensi pada pembaruan.