Edit Draf Email

Note

Alat ini tersedia secara default di server MCP berikut: Dynamics 365 Customer Service. Alat dan contoh dalam dokumentasi ini menggambarkan kemampuan saat ini. Nama alat, deskripsi, parameter, format respons, dan fungsionalitas yang tersedia dapat berubah seiring waktu.
Saat Anda membuat agen, integrasi, atau logika orkestrasi, jangan membuat kode keras pada nama alat, struktur parameter, metadata alat, atau skema respons tertentu. Sebagai gantinya, rancang solusi Anda untuk menemukan dan menggunakan alat yang tersedia saat runtime.
Seiring berkembangnya platform, Microsoft dapat menambahkan, menghapus, mengganti nama, atau memodifikasi alat dan metadata alat. Mendesain terhadap kemampuan daripada pengidentifikasi alat tertentu membantu menjaga kompatibilitas di seluruh pembaruan layanan.

Gunakan kemampuan ini ketika Anda memiliki draf email yang Anda mulai sebelumnya dan ingin melanjutkan dari bagian terakhir yang Anda tinggalkan. Asisten membuka draf yang ada dalam formulir tulis sehingga Anda dapat melanjutkan pengeditan, lalu menyimpan atau mengirimkannya.

Apa fungsinya

Asisten menemukan draf email terbaru Anda pada kasus (atau draf tertentu yang Anda rujuk) dan membukanya di formulir tulis. Subjek, isi, penerima, dan konteks kasus dimuat dari draf yang disimpan. Setiap pengeditan yang Anda buat memperbarui catatan draf yang sama - tidak ada draf duplikat yang dibuat.

Coba petunjuk seperti

• "Buka draf email saya"
• "Edit draf pada kasus ini"
• "Lanjutkan draf email saya"
• "Buka draf terbaru"
• "Edit draf saya untuk kasus CAS-01010-A0A0A0"
• "Lanjutkan mengerjakan draf saya"

Yang akan Anda lihat di obrolan

Asisten menampilkan formulir penulisan email sebagai komponen app-in-chat, yang telah diisi sebelumnya dengan subjek, isi, dan penerima draf yang ada. Anda dapat melanjutkan pengeditan dari bagian terakhir yang Anda tinggalkan.

Tips

• Jika Anda memiliki beberapa draf, tentukan mana yang satu dengan menyebutkan kasus atau topik.
• Hanya draf Anda sendiri yang ditampilkan - Anda tidak dapat mengedit draf agen lain.
• Hanya draf yang belum terkirim yang dapat dibuka dengan cara ini. Jika email sudah terkirim, gunakan "lihat email" sebagai gantinya.
• Menyimpan memperbarui catatan draf yang sama - itu tidak akan membuat duplikat.

Tip

Jika Anda ingin memulai email baru alih-alih mengedit draf yang ada, katakan "draf email baru".

Apa yang terjadi selanjutnya

Setelah draf dibuka, Anda dapat melanjutkan dengan petunjuk seperti:

• "Kirim sekarang"
• "Simpan draf"
• "Tambahkan paragraf tentang resolusi"
• "Ubah topik pembicaraan"

Apakah ini mengubah data?

Langkah ini membuka draf yang ada, tetapi tidak mengubah data dengan sendirinya.

Menyimpan atau mengirim email dari formulir penulisan memperbarui rekaman draf di Dynamics 365.

Apa yang dapat Anda lakukan dari komponen app-in-chat

Dari formulir penulisan di obrolan, Anda dapat:

• Mengedit subjek dan isi email
• Menambahkan atau menghapus penerima
• Simpan draf yang diperbarui
• Kirim email secara langsung
• Buka formulir email lengkap di Dynamics 365

Prasyarat

Alat ini membutuhkan hal-hal berikut:

• Fitur email Copilot

Pelajari selengkapnya di Kelola fitur Copilot di Customer Service.

Ringkasan alat

Harta benda	Nilai
Nama yang menghadap pengguna	Edit Draf Email
Nama alat internal	edit_email_draft
Kegunaan	Membuka draf email yang ada dalam formulir tulis sehingga pengguna dapat melanjutkan pengeditan

Perilaku alat

Membuka draf email yang ada dalam formulir tulis sehingga pengguna dapat melanjutkan pengeditan. Memuat subjek, isi, penerima, dan catatan mengenai dari Dataverse dan mengisi formulir terlebih dahulu. Operasi Simpan dan Kirim memperbarui rekaman draf yang sama — tidak ada draf duplikat yang dibuat. Menolak email non-draf (statecode != 0).

Annotations

Annotation	Nilai	Meaning
readOnlyHint	true	Microsoft 365 Copilot melewati prompt konfirmasi. Widget mengelola persistensi.
destructiveHint	Belum diatur	Tidak berlaku (membuka draf yang ada untuk diedit).
idempotentHint	Belum diatur	Tidak berlaku (setiap panggilan membuka sesi penulisan).
openWorldHint	Belum diatur	Menggunakan default (kueri Dataverse).

Konsep masukan

Draf spesifik

Input	Description	Required
activityId	activityId (GUID aktivitas email dari draf untuk dibuka). Gunakan saat pengguna mereferensikan draf tertentu, seperti mengklik tombol Edit pada baris draf di linimasa. Memberlakukan pemeriksaan kesetaraan pemilik.	No

Draf terbaru yang tercatat

Input	Description	Required
entityId, entityType, incident	entityId (catatan induk GUID, biasanya kasus), entityType (nama logis entitas, default ke incident). Mengembalikan draf yang paling baru dimodifikasi yang dimiliki oleh pengguna saat ini pada rekaman tersebut.	No

Eksklusivitas timbal balik

Input	Description	Required
activityId, entityId	activityId dan entityId saling eksklusif — melewati keduanya ditolak oleh pawang. Tepat satu harus diatur.	No

Respons dan perilaku UI

Alat ini merender formulir penulisan email interaktif.

Alat MCP ini didukung oleh aplikasi MCP.

Jenis respons

Komponen interaktif (app-in-chat)

Formulir penulisan memuat konten draf yang ada — subjek, isi, penerima, dan konteks terkait — untuk dilanjutkan diedit.

Catatan perutean

Gunakan edit_email_draft untuk:

• "Buka draf saya", "lanjutkan draf saya", "edit draf"
• Mengklik tombol Edit pensil pada baris draf di timeline
• "Buka draf terbaru pada kasus X"

Jangan gunakan edit_email_draft ketika:

• Pengguna ingin menulis email baru — gunakan draft_email
• Pengguna ingin melihat email yang diterima atau dikirim (bukan draf) — gunakan view_email
• Pengguna ingin segera mengirim email — gunakan send_email

Alat terkait

Perangkat	Hubungan
draft_email	Membuat draf email baru (sesi penulisan baru)
send_email	Segera mengirim email tanpa tinjauan penulisan
view_email	Menampilkan email yang diterima atau dikirim hanya-baca
get_activity_timeline	Menampilkan linimasa aktivitas tempat draf muncul

Klasifikasi mutasi data

Titik masuk baca-saja dengan potensi mutasi hilir.

Alat ini ditandai readOnlyHint: true. Widget tulis mengelola operasi penyimpanan dan pengiriman — pembaruan diterapkan ke rekaman draf yang sama di Dataverse saat pengguna memilih Simpan atau Kirim.