Hapus Catatan Entitas

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 saat Anda perlu menghapus rekaman secara permanen dari Dynamics 365, seperti catatan, email, tugas, atau entitas lainnya.

Apa fungsinya

Asisten menghapus rekaman tertentu dari Dynamics 365. Ini berfungsi untuk semua jenis entitas, termasuk catatan, email, panggilan telepon, tugas, janji temu, dan entitas kustom. Asisten meminta konfirmasi sebelum menghapus.

Important

Ini adalah penghapusan keras. Tidak ada membatalkan. Setelah catatan dihapus, catatan tersebut tidak dapat dipulihkan.

Coba petunjuk seperti

• "Hapus catatan ini"
• "Hapus catatan email"
• "Hapus aktivitas panggilan telepon"
• "Hapus tugas ini"
• "Hapus janji temu"
• "Hapus catatan ini"

Yang akan Anda lihat di obrolan

Asisten mengonfirmasi bahwa rekaman telah dihapus dengan pesan konfirmasi dalam obrolan.

Tips

• Asisten selalu meminta konfirmasi sebelum menghapus.
• Pastikan Anda memiliki catatan yang benar sebelum mengonfirmasi. Penghapusan tidak dapat dibatalkan.
• Anda harus memiliki hak istimewa hapus pada jenis entitas di Dynamics 365.
• Jika Anda ingin menonaktifkan catatan alih-alih menghapusnya, ucapkan "nonaktifkan catatan ini".

Tip

Jika Anda tidak yakin untuk menghapusnya, lihat catatan terlebih dahulu dengan mengatakan "tampilkan catatan ini" untuk mengonfirmasi bahwa itu adalah catatan yang benar.

Apa yang terjadi selanjutnya

Setelah rekaman dihapus, Anda dapat melanjutkan dengan petunjuk seperti:

• "Daftar rekaman untuk jenis entitas ini"
• "Buat catatan baru"
• "Tunjukkan kasus saya"

Apakah ini mengubah data?

Ya, ini menghapus data secara permanen.

Rekaman dihapus dari Dynamics 365 dan tidak dapat dipulihkan. Asisten meminta konfirmasi sebelum melanjutkan.

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

Setelah penghapusan, komponen menunjukkan konfirmasi. Tidak ada tindakan lebih lanjut yang tersedia pada rekaman yang dihapus.

Prasyarat

Alat ini tersedia di server MCP Dynamics 365 Customer Service. Lihat catatan ketersediaan di bagian atas halaman ini untuk detailnya. Tidak diperlukan konfigurasi tambahan.

Ringkasan alat

Harta benda	Nilai
Nama yang menghadap pengguna	Hapus Catatan Entitas
Nama alat internal	delete_entity_record
Kegunaan	Menghapus rekaman Dataverse berdasarkan nama logis entitas dan ID rekaman

Perilaku alat

Menghapus rekaman Dataverse berdasarkan nama logis entitas dan ID rekaman. Berfungsi untuk catatan, email, panggilan telepon, tugas, janji temu, dan jenis entitas lainnya. Ini adalah penghapusan keras tanpa pembatalan. Pengguna harus memiliki hak istimewa penghapusan pada entitas pemilik rekaman.

Annotations

Annotation	Nilai	Meaning
readOnlyHint	false	Alat ini memodifikasi data.
destructiveHint	true	Alat ini melakukan penghapusan keras.
idempotentHint	true	Panggilan berulang dengan input yang sama memiliki efek akhir yang sama.
openWorldHint	Belum diatur	Menggunakan default (kueri Dataverse).

Konsep masukan

Jenis entitas

Input	Deskripsi	Required
entityLogicalName	entityLogicalName (string, wajib). Nama logis entitas Dataverse (misalnya annotation, email, , taskphonecallappointment, ).	Yes

Pengidentifikasi rekaman

Input	Deskripsi	Required
recordId	recordId (string, wajib). GUID rekaman untuk dihapus.	Yes

Respons dan perilaku UI

Alat ini merender konfirmasi di komponen app-in-chat.

Alat MCP ini didukung oleh Aplikasi MCP.

Jenis respons

Pesan konfirmasi

Tanggapan mengonfirmasi bahwa catatan telah dihapus. Catatan yang dihapus tidak dapat dipulihkan.

Catatan perutean

Gunakan delete_entity_record untuk:

• Perintah apa pun yang secara eksplisit meminta untuk menghapus, menghapus, atau membuang rekaman
• Tindakan hapus sebaris dari widget kisi atau formulir

Jangan gunakan delete_entity_record ketika:

• Menutup kasus - rute ke close_case
• Menonaktifkan catatan - gunakan update_entity_record untuk mengatur kode status
• Memperbarui atau mengedit - rute ke update_entity_record

Alat terkait

Perangkat	Hubungan
get_entity_record	Melihat rekaman sebelum menghapus
update_entity_record	Perbarui rekaman alih-alih menghapus
create_note	Membuat catatan; hapus membalikkan tindakan ini
create_activity	Membuat aktivitas; hapus membalikkan tindakan ini

Klasifikasi mutasi data

Operasi tulis (destruktif, idempoten).

Alat ini melakukan penghapusan keras pada data Dataverse. Tidak ada membatalkan. Operasinya idempoten; Menghapus catatan yang sudah dihapus tidak memiliki efek tambahan.