Perbarui Kasus

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 bidang pada kasus dukungan, seperti prioritas, judul, deskripsi, atau detail lainnya.

Apa fungsinya

Asisten memperbarui satu atau beberapa bidang pada rekaman kasus. Anda dapat mengubah tingkat prioritas menggunakan bahasa sederhana, atau memperbarui bidang kasus lain dengan menentukan apa yang ingin Anda ubah. Asisten mengonfirmasi bidang mana yang diperbarui setelah perubahan diterapkan.

Coba petunjuk seperti

  • "Tetapkan prioritas CAS-01010-A0A0A0 ke tinggi"
  • "Ubah judul kasus ini menjadi Masalah login"
  • "Perbarui deskripsi kasus ini"
  • "Tetapkan prioritas ke rendah"
  • "Tandai kasus ini sebagai menunggu detailnya"
  • "Ubah pelanggan pada kasus CAS-01010-A0A0A0"

Apa yang Anda lihat di chat

Asisten mengonfirmasi pembaruan dengan respons teks yang mencantumkan bidang yang diubah. Tidak ada komponen interaktif yang ditampilkan untuk tindakan ini.

Tips

  • Anda dapat merujuk ke kasus dengan nomor kasusnya (misalnya, CAS-01010-A0A0A0) atau membiarkan asisten menggunakan kasus yang sudah Anda kerjakan.
  • Untuk perubahan prioritas, gunakan "tinggi", "normal", atau "rendah".
  • Anda dapat memperbarui beberapa bidang dalam satu permintaan.
  • Jika Anda ingin menutup kasus, gunakan "tutup kasus ini" sebagai gantinya - itu adalah tindakan terpisah dengan catatan resolusi.

Tip

Buka kasus terlebih dahulu dengan "tunjukkan saya kasus CAS-01010-A0A0A0" untuk meninjau kolom saat ini sebelum memperbarui.

Apa yang terjadi selanjutnya

Setelah memperbarui, Anda dapat melanjutkan dengan petunjuk seperti:

  • "Tunjukkan kasus ini"
  • "Ringkas kasus ini"
  • "Apa status SLA pada kasus ini?"
  • "Tetapkan ulang kasus ini ke Alex"

Apakah ini mengubah data?

Yes. Ini mengubah data.

Rekaman kasus diperbarui di Dynamics 365. Perubahan segera berlaku.

Prasyarat

Alat ini membutuhkan hal-hal berikut:

  • Peran perwakilan layanan pelanggan

Ringkasan alat

Harta benda Nilai
Nama yang menghadap pengguna Perbarui Kasus
Nama alat internal update_case
Kegunaan Memperbarui satu atau beberapa bidang pada kasus dukungan

Perilaku alat

Memperbarui satu atau beberapa bidang pada kasus dukungan. Mendukung pintasan yang diketik untuk bidang umum seperti prioritas, dan peta generik fields untuk nama logis Dataverse sewenang-wenang untuk memperbarui nilai termasuk judul, deskripsi, pelanggan, dan alasan status.

Annotations

Annotation Nilai Meaning
readOnlyHint false Alat ini memodifikasi data.
destructiveHint false Pembaruan tidak merusak (bidang ditimpa, tidak dihapus).
idempotentHint true Memanggil dengan input yang sama menghasilkan hasil yang sama.
openWorldHint Belum diatur Menggunakan default (kueri Dataverse).

Konsep masukan

Pengenal kasus

Input Description Required
incidentId, caseNumber incidentId (GUID) atau caseNumber (misalnya CAS-01010-A0A0A0). Setidaknya satu diperlukan. Ketika caseNumber disediakan, server menyelesaikannya menjadi GUID. Yes

Pintasan prioritas

Input Description Required
priority,high,normal,low priority(enum: high, , normal). low Parameter kenyamanan untuk pembaruan bidang yang paling umum. No

Bidang arbitrer

Input Description Required
fields fields (catatan nama logis Dataverse ke pasangan nilai). Digunakan oleh widget formulir untuk pengeditan sebaris masing-masing kolom, atau untuk bidang apa pun yang tidak tercakup dalam pintasan yang diketik. No

Respons dan perilaku UI

Alat MCP ini didukung oleh aplikasi MCP.

Jenis respons

Konfirmasi teks

Alat ini mengembalikan konfirmasi teks dari bidang yang diperbarui. Tidak ada komponen interaktif yang dirender.

Catatan perutean

Gunakan update_case untuk:

  • Setiap perubahan bidang pada rekaman kasus (prioritas, judul, deskripsi, alasan status, kolom kustom)
  • Pengeditan sebaris dari widget formulir kasus

Jangan gunakan update_case ketika:

  • Menutup/menyelesaikan kasus - rute ke close_case (menggunakan tindakan Dataverse CloseIncident)
  • Menetapkan ulang kasus - rute ke reassign_case (menangani transfer kepemilikan dan catatan serah terima)
  • Memperbarui entitas non-huruf besar - rute ke update_entity_record
Perangkat Hubungan
get_case Membuka formulir kasus untuk diperiksa sebelum mengedit
close_case Menyelesaikan dan menutup kasus (menggunakan CloseIncident, bukan pembaruan bidang)
reassign_case Menetapkan ulang kasus ke pengguna, tim, atau antrean lain
list_cases Mencantumkan kasus untuk menemukan kasus yang akan diperbarui
summarize_case Membuka kasus dengan ringkasan AI untuk triase sebelum mengedit

Klasifikasi mutasi data

Tulis / mutasi.

Memperbarui satu atau beberapa bidang pada rekaman kasus di Dataverse. Operasinya idempoten - memanggil dengan input yang sama menghasilkan hasil yang sama.