Lihat 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 melihat detail lengkap rekaman tertentu untuk jenis entitas Dataverse apa pun yang tidak memiliki perintah tampilan khusus sendiri.

Apa fungsinya

Asisten membuka tampilan formulir terperinci untuk rekaman yang Anda tentukan. Anda dapat melihat semua bidang rekaman, mengedit bidang yang didukung sebaris, dan menavigasi ke formulir lengkap di Dynamics 365. Ini berfungsi untuk semua jenis entitas, termasuk peluang, prospek, item antrean, dan tabel kustom.

Untuk akun, kontak, dan kasus, asisten menggunakan alat khusus dengan perilaku yang lebih kaya. Alat ini adalah penggantian untuk yang lainnya.

Coba petunjuk seperti

• "Peluang terbuka untuk kesepakatan Contoso"
• "Tampilkan detail utama untuk Maria Garcia"
• "Melihat rekaman item antrean"
• "Buka catatan janji temu ini"
• "Tunjukkan rekaman entitas kustom"
• "Lihat tugas ini"

Yang akan Anda lihat di obrolan

Asisten menampilkan formulir rekaman interaktif sebagai komponen aplikasi-dalam-obrolan. Formulir menunjukkan bidang rekaman sebagaimana ditentukan oleh konfigurasi formulir sistem Dynamics 365.

Tips

• Anda dapat menggunakan nama rekaman atau GUID untuk membuka rekaman tertentu.
• Anda perlu menentukan jenis entitas, misalnya "peluang terbuka untuk Project Alpha".
• Untuk akun, ucapkan "buka akun Contoso". Untuk kontak, ucapkan "buka kontak Jordan". Untuk kasus, ucapkan "kasus terbuka CAS-01010-A0A0A0".

Tip

Setelah formulir rekaman muncul, Anda dapat mengajukan pertanyaan tindak lanjut seperti "perbarui catatan ini" atau "hapus catatan ini".

Apa yang terjadi selanjutnya

Setelah formulir rekaman muncul, Anda dapat melanjutkan dengan petunjuk seperti:

• "Perbarui kolom pada rekaman ini"
• "Hapus rekaman ini"
• "Daftar lebih banyak catatan seperti ini"
• "Cari rekaman terkait"

Apakah ini mengubah data?

Tidak, melihat rekaman tidak mengubah data.

Formulir rekaman hanya baca secara default. Pengeditan sebaris dari formulir dapat mengubah data. Asisten meminta konfirmasi sebelum membuat perubahan.

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

Dari formulir rekaman dalam obrolan, Anda dapat:

• Tinjau semua bidang formulir rekaman
• Mengedit bidang yang didukung sebaris
• Buka formulir rekaman lengkap di Dynamics 365
• 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	Lihat Catatan Entitas
Nama alat internal	get_entity_record
Kegunaan	Mengambil satu rekaman untuk entitas Dataverse apa pun dalam tampilan detail berbasis formulir dengan pengeditan sebaris

Perilaku alat

Mengambil satu rekaman untuk entitas Dataverse apa pun dalam tampilan detail berbasis formulir dengan pengeditan sebaris. Gunakan untuk jenis entitas yang tidak tercakup dalam get_account, get_contact, atau get_case, seperti peluang, prospek, atau tabel kustom.

Annotations

Annotation	Nilai	Meaning
readOnlyHint	Belum diatur	Baca-saja dalam praktik; Alat ini tidak memodifikasi data secara langsung.
destructiveHint	Belum diatur	Tidak berlaku (alat baca-saja).
idempotentHint	Belum diatur	Tidak berlaku (alat baca-saja).
openWorldHint	Belum diatur	Menggunakan default (kueri Dataverse).

Konsep masukan

Jenis entitas

Input	Description	Required
entityLogicalName	entityLogicalName (string, wajib). Nama logis entitas Dataverse.	Yes

Pengidentifikasi rekaman

Input	Description	Required
recordId	recordId (string, wajib). Catat GUID atau nama utama untuk dicari.	Yes

Pemilihan formulir

Input	Description	Required
formId	formId (string, opsional). GUID formulir sistem untuk digunakan untuk rendering.	No

Respons dan perilaku UI

Alat ini merender formulir entitas aplikasi-dalam-obrolan interaktif.

Alat MCP ini didukung oleh Aplikasi MCP.

Jenis respons

Formulir interaktif (tampilan detail)

Formulir menampilkan bidang rekaman seperti yang ditentukan oleh formulir sistem yang dipilih.

Catatan perutean

Gunakan get_entity_record untuk:

• Jenis entitas apa pun tanpa alat detail khusus
• "buka [jenis entitas] [nama]", "tampilkan detail [jenis entitas]"

Jangan gunakan get_entity_record saat prompt secara eksplisit mengatakan:

• Akun - rute ke get_account
• Kontak - rute ke get_contact
• Kasus - rute ke get_case
• Catatan "Daftar" - rute ke list_entity_records

Alat terkait

Perangkat	Hubungan
list_entity_records	Mencantumkan rekaman untuk jenis entitas yang sama
update_entity_record	Memperbarui bidang pada rekaman entitas apa pun
delete_entity_record	Menghapus rekaman entitas apa pun
get_account	Alat detail akun khusus
get_contact	Alat detail kontak khusus
get_case	Alat detail casing khusus

Klasifikasi mutasi data

Titik masuk baca-saja dengan potensi mutasi hilir.

Tampilan formulir itu sendiri tidak mengubah data. Pengeditan sebaris memicu operasi tulis melalui update_entity_record.