Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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.
Kemampuan ini digunakan secara internal oleh formulir pembuatan templat email untuk menyimpan templat baru Anda ke Dynamics 365.
Apa fungsinya
Saat Anda mengklik Simpan dalam formulir pembuatan templat email (dibuka oleh "buat templat email"), asisten membuat rekaman templat di Dynamics 365. Templat yang disimpan mencakup nama, subjek, isi, deskripsi, jenis templat, bahasa, dan tingkat izin (pribadi atau seluruh organisasi) yang Anda tetapkan dalam formulir.
Anda tidak memanggil ini secara langsung. Ini berjalan secara otomatis saat Anda menyimpan dari formulir pembuatan template.
Coba petunjuk seperti
- "Buat templat email baru" (membuka formulir; Simpan memicu tindakan ini)
- "Buat template yang disebut 'Customer Follow-Up'"
- "Membuat templat email untuk penutupan kasus"
Yang akan Anda lihat di obrolan
Asisten mengonfirmasi bahwa templat berhasil disimpan dan mengembalikan ID templat baru. Jika ada masalah (seperti kolom wajib tidak ada), Anda akan melihat pesan kesalahan yang menjelaskan apa yang perlu diperbaiki.
Tips
- Nama templat (judul) diperlukan. Pastikan Anda mengisinya sebelum menyimpan.
- Templat pribadi hanya dapat dilihat oleh Anda. Atur izin ke Organisasi untuk dibagikan dengan tim Anda.
- Bahasa defaultnya adalah bahasa Inggris (1033). Ubah kode bahasa jika Anda membuat templat dalam bahasa lain.
- Jika penyimpanan gagal, periksa apakah semua bidang yang diperlukan telah diisi dan coba lagi.
Apa yang terjadi selanjutnya
Setelah templat disimpan, Anda dapat melanjutkan dengan petunjuk seperti:
- "Terapkan templat itu pada kasus ini"
- "Merekomendasikan templat untuk kasus ini"
- "Buat template lain"
- "Draf email untuk kasus ini"
Apakah ini mengubah data?
Yes. Menyimpan templat membuat rekaman templat email baru di Dynamics 365.
Templat disimpan secara permanen dan tersedia untuk digunakan di masa mendatang dalam alur kerja komposisi email.
Prasyarat
Alat ini membutuhkan hal-hal berikut:
- Peran penulis templat
Pelajari lebih lanjut di Mengonfigurasi email.
Ringkasan alat
| Harta benda | Nilai |
|---|---|
| Nama yang menghadap pengguna | Simpan Templat Email |
| Nama alat internal | save_email_template |
| Kegunaan | Membuat rekaman templat email baru di Dynamics 365 |
Perilaku alat
Membuat rekaman templat email baru di Dynamics 365. Dipanggil dari create_email_template widget saat pengguna mengklik Simpan. Tidak dimaksudkan untuk pemanggilan langsung oleh agen - widget mengelola alur penyimpanan.
Annotations
| Annotation | Nilai | Meaning |
|---|---|---|
readOnlyHint |
false |
Alat ini membuat data - Microsoft 365 Copilot meminta konfirmasi. |
destructiveHint |
false |
Membuat templat bersifat tambahan, bukan merusak. |
idempotentHint |
false |
Setiap panggilan membuat templat baru - tidak aman untuk dicoba lagi. |
openWorldHint |
Belum diatur | Menggunakan default (kueri Dataverse). |
Konsep masukan
Identitas templat
| Input | Description | Required |
|---|---|---|
title |
title (nama templat, wajib). |
Yes |
Content
| Input | Description | Required |
|---|---|---|
subject, body, description |
subject (baris subjek email), body (HTML isi email), description (deskripsi templat opsional). |
No |
Classification
| Input | Description | Required |
|---|---|---|
templateTypeCode |
templateTypeCode (Nilai daftar pilihan kode templattypekode Dataverse, misalnya 112 untuk Kasus), languageCode (LCID, misalnya 1033 untuk bahasa Inggris - default ke 1033). |
No |
Izin
| Input | Description | Required |
|---|---|---|
isPersonal |
isPersonal (true = Pengguna pribadi/pemilik saja, false = Organisasi/bersama - default ke true). |
No |
Respons dan perilaku UI
Jenis respons
Teks saja
Tidak ada komponen interaktif yang dirender. Alat ini mengembalikan ID templat baru sebagai konfirmasi.
Catatan perutean
Gunakan save_email_template untuk:
- Hanya penggunaan widget internal - dipanggil saat pengguna mengklik Simpan di formulir pembuatan template
Jangan gunakan save_email_template secara langsung:
- Untuk membuka formulir pembuatan template - gunakan
create_email_template - Agen tidak boleh memanggil alat ini secara langsung - itu dipanggil oleh widget
Alat terkait
| Perangkat | Hubungan |
|---|---|
create_email_template |
Membuka widget formulir templat (hulu - panggilan save_email_template saat Simpan) |
recommend_email_templates |
Mencantumkan templat yang ada |
apply_email_template |
Menerapkan templat yang ada ke kasus |
Klasifikasi mutasi data
Tulis / mutasi.
Alat ini membuat rekaman templat email baru di Dataverse. M365 Copilot meminta konfirmasi pengguna sebelum eksekusi.