Perbarui 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 ingin mengubah nilai bidang pada rekaman Dataverse apa pun langsung dari obrolan.

Apa fungsinya

Asisten memperbarui satu atau beberapa bidang pada rekaman yang Anda tentukan. Ini berfungsi untuk semua jenis entitas, termasuk akun, kontak, peluang, prospek, dan tabel kustom. Anda memberi tahu asisten rekaman mana yang akan diperbarui dan bidang apa yang harus diubah, dan menerapkan pembaruan secara langsung di Dynamics 365.

Untuk pembaruan khusus kasus, asisten menggunakan alat pembaruan kasus khusus yang memiliki validasi yang lebih kaya. Alat ini adalah penggantian tujuan umum untuk semua jenis entitas lainnya.

Coba petunjuk seperti

• "Perbarui nomor telepon di akun Contoso"
• "Ubah jabatan Jordan menjadi Insinyur Senior"
• "Tetapkan perkiraan pendapatan pada kesempatan ini menjadi 50000"
• "Perbarui alamat email pada kontak ini"
• "Ubah status pada prospek ini menjadi memenuhi syarat"
• "Atur bidang deskripsi pada rekaman ini"

Yang akan Anda lihat di obrolan

Asisten menampilkan rekaman yang diperbarui sebagai formulir interaktif dalam obrolan, menampilkan bidang setelah pembaruan diterapkan.

Tips

• Spesifik tentang bidang mana yang harus diubah dan apa nilai baru yang seharusnya.
• Asisten meminta konfirmasi sebelum menerapkan pembaruan.
• Anda dapat memperbarui beberapa kolom dalam satu permintaan, misalnya "mengubah telepon ke 555-0100 dan kota ke Seattle".
• Untuk pembaruan kasus, jelaskan saja perubahan secara alami. Asisten memilih alat yang tepat.

Tip

Setelah pembaruan diterapkan, asisten menampilkan rekaman yang diperbarui sehingga Anda dapat memverifikasi perubahan.

Apa yang terjadi selanjutnya

Setelah pembaruan diterapkan, Anda dapat melanjutkan dengan petunjuk seperti:

• "Tampilkan rekaman ini lagi"
• "Perbarui bidang lain"
• "Daftar rekaman untuk jenis entitas ini"
• "Buka rekaman ini di Dynamics 365"

Apakah ini mengubah data?

Ya, ini memperbarui data data data Dataverse.

Asisten menerapkan perubahan bidang langsung ke rekaman Dataverse. Asisten meminta konfirmasi sebelum membuat perubahan.

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

Dari formulir rekaman yang diperbarui di obrolan, Anda dapat:

• Konfirmasikan bahwa pembaruan diterapkan dengan benar
• Meninjau nilai bidang rekaman saat ini
• Lanjutkan bekerja dengan rekaman dalam obrolan menggunakan petunjuk tindak lanjut

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	Perbarui Catatan Entitas
Nama alat internal	update_entity_record
Kegunaan	Memperbarui satu atau beberapa bidang pada rekaman entitas Dataverse apa pun dengan GUID

Perilaku alat

Memperbarui satu atau beberapa bidang pada rekaman entitas Dataverse apa pun dengan GUID. Gunakan saat alat pembaruan khusus domain (seperti update_case) tidak mencakup bidang atau entitas yang diminta, atau saat entitas tidak memiliki alat pembaruan khusus. Berfungsi untuk akun, kontak, peluang, prospek, tabel kustom, dan entitas Dataverse lainnya.

Annotations

Annotation	Nilai	Meaning
readOnlyHint	false	Alat ini memodifikasi data.
destructiveHint	false	Alat ini memperbarui data tanpa perilaku 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	Description	Required
entityLogicalName	entityLogicalName (string, wajib). Nama logis entitas Dataverse (misalnya account, contact, ). opportunity	Yes

Pengidentifikasi rekaman

Input	Description	Required
recordId	recordId (string, wajib). GUID rekaman untuk diperbarui.	Yes

Pembaruan lapangan

Input	Description	Required
fields	fields (peta nilai kunci, diperlukan). Peta nama logis bidang ke nilai baru. Contoh: { "telephone1": "555-0100", "jobtitle": "Senior Engineer" }.	Yes

Respons dan perilaku UI

Alat ini merender formulir aplikasi-dalam-obrolan interaktif yang menunjukkan catatan yang diperbarui.

Alat MCP ini didukung oleh Aplikasi MCP.

Jenis respons

Formulir interaktif (tampilan detail)

Formulir menampilkan rekaman setelah pembaruan diterapkan.

Catatan perutean

Gunakan update_entity_record untuk:

• Memperbarui bidang pada jenis entitas apa pun tanpa alat pembaruan khusus
• Memperbarui kolom yang tidak tercakup dalam alat pembaruan khusus domain

Jangan gunakan update_entity_record ketika:

• Memperbarui bidang kasus - lebih suka update_case untuk bidang khusus kasus
• Menghapus catatan - rute ke delete_entity_record

Alat terkait

Perangkat	Hubungan
get_entity_record	Melihat rekaman sebelum atau sesudah memperbarui
get_account	Melihat catatan akun sebelum atau sesudah memperbarui
get_contact	Melihat rekaman kontak sebelum atau sesudah memperbarui
delete_entity_record	Menghapus rekaman alih-alih memperbaruinya
update_case	Alat pembaruan kasus khusus dengan logika khusus kasus

Klasifikasi mutasi data

Operasi tulis (non-destruktif, idempoten).

Alat ini memodifikasi data. Pembaruan diterapkan langsung ke rekaman Dataverse. Operasinya idempoten; Panggilan berulang dengan input yang sama menghasilkan hasil yang sama.