Buat Catatan

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 menambahkan catatan ke kasus, akun, atau rekaman lainnya. Catatan adalah entri teks bentuk bebas yang muncul di timeline rekaman.

Apa fungsinya

Asisten membuat catatan (anotasi) dan melampirkannya ke rekaman yang Anda tentukan. Catatan muncul di linimasa aktivitas rekaman bersama email, panggilan telepon, dan tugas. Catatan berguna untuk merekam pengamatan internal, interaksi pelanggan, atau pengingat tindak lanjut.

Coba petunjuk seperti

• "Tambahkan catatan ke kasus ini"
• "Catat catatan yang dipanggil kembali pelanggan"
• "Simpan catatan yang mengatakan kami perlu menindaklanjuti"
• "Tambahkan catatan: menghubungi pelanggan melalui telepon, masalahnya adalah login SSO"
• "Catat catatan di akun ini"
• "Catatan: pelanggan mengonfirmasi solusi berhasil"

Apa yang Anda lihat di chat

Asisten menampilkan linimasa aktivitas sebagai komponen app-in-chat, disegarkan untuk menampilkan catatan yang baru dibuat dalam konteks dengan aktivitas lain pada rekaman.

Tips

• Cukup ketik konten catatan secara alami - asisten membuat catatan dengan teks Anda.
• Anda dapat menyertakan judul dengan mengatakan sesuatu seperti "tambahkan catatan berjudul 'Diperlukan tindak lanjut' dengan teks..."
• Catatan berbeda dengan tugas. Jika Anda memerlukan item tindakan yang dapat dilacak dengan tanggal jatuh tempo, ucapkan "buat tugas".
• Catatan dilampirkan ke konteks catatan saat ini. Jika Anda perlu menambahkan catatan ke rekaman yang berbeda, tentukan yang mana.

Tip

Setelah membuat catatan, Anda dapat memperbaruinya nanti dengan mengatakan "perbarui catatan" atau "perbaiki kesalahan ketik di catatan saya".

Apa yang terjadi selanjutnya

Setelah catatan dibuat, Anda dapat melanjutkan dengan perintah seperti:

• "Tambahkan catatan lain"
• "Buat tugas tindak lanjut"
• "Tampilkan linimasa"
• "Draf email ke pelanggan"

Apakah ini mengubah data?

Yes. Ini membuat catatan.

Catatan baru (anotasi) dibuat di Dynamics 365 dan dilampirkan ke rekaman. Asisten meminta konfirmasi sebelum membuat catatan.

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

Dari linimasa dalam obrolan, Anda dapat:

• Melihat catatan baru Anda bersama aktivitas lainnya
• 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	Buat Catatan
Nama alat internal	create_note
Kegunaan	Membuat catatan (anotasi) pada rekaman Dynamics 365

Perilaku alat

Membuat catatan (anotasi) pada rekaman Dynamics 365. Anotasi adalah entri teks bentuk bebas yang dilampirkan ke linimasa rekaman. Gunakan saat pengguna meminta untuk menambahkan catatan, mencatat catatan, atau menyimpan teks sebagai catatan pada kasus, akun, atau entitas lainnya. Untuk tugas, email, panggilan telepon, atau janji temu, gunakan create_activity sebagai gantinya — itu adalah aktivitas linimasa, bukan anotasi.

Annotations

Annotation	Nilai	Meaning
readOnlyHint	false	Alat ini membuat data — Microsoft 365 Copilot meminta konfirmasi.
destructiveHint	false	Membuat catatan bersifat aditif, bukan merusak.
idempotentHint	false	Setiap panggilan membuat catatan baru — tidak aman untuk dicoba lagi.
openWorldHint	Belum diatur	Menggunakan default (kueri Dataverse).

Konsep masukan

Konteks rekaman

Input	Deskripsi	Required
entityId,entityType,incident,account	entityId (rekam GUID untuk melampirkan catatan, diperlukan), entityType (nama logis entitas seperti incident atau account).	Yes

Catatan konten

Input	Deskripsi	Required
notetext, subject	notetext (teks isi catatan, wajib), subject (judul pendek opsional untuk catatan).	Beragam

Respons dan perilaku UI

Alat ini merender linimasa aktivitas untuk mengonfirmasi catatan dibuat.

Alat MCP ini didukung oleh aplikasi MCP.

Jenis respons

Komponen interaktif (app-in-chat)

Widget linimasa diperbarui untuk menampilkan catatan yang baru dibuat di umpan aktivitas.

Catatan perutean

Gunakan create_note untuk:

• "Tambahkan catatan", "catat catatan", "simpan catatan"
• Anotasi teks bentuk bebas yang dilampirkan ke rekaman

Jangan gunakan create_note ketika:

• Pengguna ingin membuat tugas, panggilan telepon, janji temu, atau email — gunakan create_activity
• Pengguna ingin memperbarui catatan yang ada — gunakan update_note
• Pengguna ingin melihat garis waktu — gunakan get_activity_timeline

Alat terkait

Perangkat	Hubungan
update_note	Memperbarui teks catatan yang ada
create_activity	Membuat aktivitas linimasa (tugas, panggilan telepon, janji temu, email)
get_activity_timeline	Mengambil linimasa aktivitas lengkap untuk rekaman

Klasifikasi mutasi data

Tulis / mutasi.

Alat ini membuat rekaman anotasi baru di Dataverse. Microsoft 365 Copilot meminta pengguna untuk konfirmasi sebelum berjalan.