Referensi email (pratinjau)

Note

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

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.

Ikhtisar

ID Server	URL tingkat penyewa	Nama tampilan	Deskripsi
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 balasan-semua ke pesan yang sudah 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, from, dan size

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: Memaksa penyajian HTML
• 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
• Untuk, CC, dan penerima 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.