Catatan Pembaruan

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 memperbaiki kesalahan ketik, menambahkan informasi, atau merevisi catatan yang ada pada kasus atau rekaman lainnya.

Apa fungsinya

Asisten menemukan catatan yang ada berdasarkan pengidentifikasinya dan memperbarui teks dengan konten baru Anda. Catatan yang diperbarui menggantikan versi sebelumnya di timeline rekaman. Ini berguna untuk memperbaiki kesalahan atau menambahkan detail ke catatan yang Anda buat sebelumnya.

Coba petunjuk seperti

• "Perbaiki kesalahan ketik di catatan saya"
• "Perbarui catatan untuk mengatakan bahwa pelanggan mengonfirmasi solusinya"
• "Ubah catatan pada kasus ini"
• "Revisi catatan terakhir saya"
• "Perbarui teks catatan untuk menyertakan nomor telepon baru"

Yang akan Anda lihat di obrolan

Asisten menampilkan linimasa aktivitas sebagai komponen app-in-chat, disegarkan untuk menampilkan konten catatan yang diperbarui.

Tips

• Asisten perlu tahu catatan mana yang akan diperbarui. Jika ada beberapa catatan, tentukan berdasarkan konten atau judul.
• Anda dapat mengucapkan "perbarui catatan" dan kemudian memberikan teks baru, atau menyertakan semuanya dalam satu perintah.
• Hanya catatan yang Anda miliki yang dapat diperbarui.
• Jika Anda ingin menambahkan catatan yang benar-benar baru alih-alih mengedit yang sudah ada, katakan "tambahkan catatan".

Tip

Lihat linimasa terlebih dahulu untuk melihat catatan yang ada, lalu beri tahu asisten mana yang akan diperbarui.

Apa yang terjadi selanjutnya

Setelah catatan diperbarui, Anda dapat melanjutkan dengan petunjuk seperti:

• "Tampilkan linimasa"
• "Tambahkan catatan lain"
• "Draf email ke pelanggan"
• "Apa lagi yang perlu dilakukan dalam kasus ini?"

Apakah ini mengubah data?

Ya, ini memperbarui catatan yang ada.

Teks catatan diganti dengan konten baru yang Anda berikan. Asisten meminta konfirmasi sebelum melakukan perubahan.

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

Dari linimasa dalam obrolan, Anda dapat:

• Lihat catatan yang diperbarui dalam konteks
• Jelajahi linimasa aktivitas lengkap
• Pilih aktivitas apa pun untuk melihat detailnya
• Buka formulir rekaman lengkap di Dynamics 365

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	Catatan Pembaruan
Nama alat internal	update_note
Kegunaan	Memperbarui teks catatan yang ada (anotasi) di Dynamics 365 dengan GUID anotasinya

Perilaku alat

Memperbarui teks catatan yang ada (anotasi) di Dynamics 365 dengan GUID anotasinya. Gunakan saat pengguna ingin memperbaiki kesalahan ketik, merevisi, atau mengubah catatan yang ada. Dapat annotationId diperoleh dari get_activity_timeline tanggapan.

Annotations

Annotation	Nilai	Meaning
readOnlyHint	false	Alat ini memodifikasi data - Microsoft 365 Copilot meminta konfirmasi.
destructiveHint	false	Memperbarui catatan menggantikan konten tetapi tidak merusak.
idempotentHint	true	Memanggil dengan input yang sama menghasilkan hasil yang sama - aman untuk dicoba lagi.
openWorldHint	Belum diatur	Menggunakan default (kueri Dataverse).

Konsep masukan

Pengidentifikasi catatan

Input	Description	Required
annotationId	annotationId (GUID anotasi untuk memperbarui, diperlukan). Dapatkan dari get_activity_timeline.	Yes

Konten yang diperbarui

Input	Description	Required
notetext, subject	notetext (teks isi catatan yang diperbarui, wajib), subject (judul yang diperbarui opsional).	Beragam

Respons dan perilaku UI

Alat ini merender linimasa aktivitas untuk mengonfirmasi catatan telah diperbarui.

Alat MCP ini didukung oleh Aplikasi MCP.

Jenis respons

Komponen interaktif (app-in-chat)

Widget linimasa disegarkan untuk menampilkan konten catatan yang diperbarui.

Catatan perutean

Gunakan update_note untuk:

• "Perbaiki catatan", "perbarui catatan", "revisi catatan"
• Setiap pengeditan pada teks atau judul anotasi yang ada

Jangan gunakan update_note ketika:

• Pengguna ingin membuat catatan baru - gunakan create_note
• Pengguna ingin memperbarui aktivitas timeline (tugas, panggilan telepon, dll.) - gunakan create_activity dengan activityId

Alat terkait

Perangkat	Hubungan
create_note	Membuat catatan baru pada rekaman
get_activity_timeline	Mengambil garis waktu termasuk catatan (sumber annotationId)
create_activity	Membuat aktivitas linimasa (bukan anotasi)

Klasifikasi mutasi data

Tulis / mutasi.

Alat ini memperbarui rekaman anotasi yang ada di Dataverse. M365 Copilot meminta konfirmasi pengguna sebelum eksekusi. Operasinya idempoten - mencoba kembali dengan input yang sama menghasilkan hasil yang sama.