Daftar 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 menelusuri rekaman untuk jenis entitas Dataverse apa pun yang tidak memiliki perintah daftar khususnya sendiri, seperti peluang, prospek, item antrean, atau tabel kustom.

Apa fungsinya

Asisten menampilkan daftar rekaman untuk jenis entitas yang Anda tentukan. Anda dapat mencari berdasarkan nama dan membatasi jumlah hasil. Ini adalah alat daftar rekaman tujuan umum yang berfungsi untuk semua jenis entitas di lingkungan Dynamics 365 Anda.

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

Coba petunjuk seperti

  • "Tampilkan semua item antrean"
  • "Daftar peluang"
  • "Daftar prospek"
  • "Tampilkan rekaman entitas kustom saya"
  • "Telusuri peluang terbuka"
  • "Cantumkan semua janji temu"
  • "Tampilkan catatan tugas"

Yang akan Anda lihat di obrolan

Asisten menampilkan daftar rekaman interaktif sebagai komponen app-in-chat. Daftar ini menunjukkan rekaman yang cocok dengan nama utama dan kolom kuncinya.

Tips

  • Anda perlu menentukan jenis entitas, misalnya "daftar peluang" atau "tampilkan prospek".
  • Gunakan nama untuk mencari rekaman tertentu, misalnya "daftar peluang untuk Project Alpha".
  • Untuk akun, ucapkan "daftar akun". Untuk kontak, ucapkan "daftar kontak". Untuk kasus, ucapkan "daftar kasus".
  • Jumlah hasil maksimum adalah 200.

Tip

Setelah daftar catatan muncul, Anda dapat mengajukan pertanyaan tindak lanjut tentang catatan apa pun yang ditampilkan. Misalnya, "buka rekaman pertama" atau "perbarui rekaman ini".

Apa yang terjadi selanjutnya

Setelah daftar muncul, Anda dapat melanjutkan dengan petunjuk seperti:

  • "Buka rekaman pertama"
  • "Tampilkan detail untuk rekaman ini"
  • "Perbarui kolom pada rekaman ini"
  • "Hapus rekaman ini"

Apakah ini mengubah data?

Tidak, catatan daftar tidak mengubah data.

Daftar rekaman hanya baca. Tindakan tindak lanjut dari daftar, seperti memperbarui atau menghapus rekaman, dapat mengubah data. Asisten meminta konfirmasi sebelum membuat perubahan.

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

Dari daftar rekaman di obrolan, Anda dapat:

  • Memindai dan meninjau rekaman yang cocok dalam kisi yang dapat diurutkan
  • Pilih rekaman untuk melihat detail selengkapnya
  • 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 Daftar Catatan Entitas
Nama alat internal list_entity_records
Kegunaan Mengambil rekaman untuk entitas Dataverse apa pun dalam kisi yang dapat diurutkan dan dapat difilter

Perilaku alat

Mengambil rekaman untuk entitas Dataverse apa pun dalam kisi yang dapat diurutkan dan dapat difilter. Gunakan untuk jenis entitas yang tidak memiliki alat daftar khusus, seperti peluang, prospek, item antrean, atau tabel kustom. Untuk jenis entitas inti (akun, kontak, kasus, pengetahuan), gunakan alat daftar bernama sebagai gantinya.

Annotations

Annotation Nilai Meaning
readOnlyHint Belum diatur Baca-saja dalam praktik; Alat ini tidak memodifikasi data.
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 (misalnya opportunity, lead, ). queueitem Yes
Input Description Required
search search (string, opsional). Pencarian teks bebas di seluruh atribut nama utama entitas. No

Batas hasil

Input Description Required
top top (bilangan bulat, opsional). Catatan maksimum untuk dikembalikan. Default ke setelan ukuran halaman organisasi (25 kecuali admin mengubahnya), maks 200. No

Respons dan perilaku UI

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

Alat MCP ini didukung oleh Aplikasi MCP.

Jenis respons

Kisi interaktif (tampilan daftar)

Kisi menampilkan rekaman dengan nama utama dan kolom kuncinya. Pengguna dapat memilih baris untuk menelusuri detail rekaman melalui get_entity_record.

Catatan perutean

Gunakan list_entity_records untuk:

  • Jenis entitas apa pun tanpa alat daftar khusus (peluang, prospek, item antrean, tabel kustom)
  • "daftar [jenis entitas]" di mana [jenis entitas] bukan akun, kontak, kasus, pengetahuan, atau evaluasi

Jangan gunakan list_entity_records saat prompt secara eksplisit mengatakan:

  • Akun - rute ke list_accounts
  • Kontak - rute ke list_contacts
  • Kasus - rute ke list_cases
  • Artikel pengetahuan - rute ke search_knowledge_articles
  • Evaluasi - rute ke list_evaluations
  • Pencarian teks bebas di seluruh entitas - rute ke search_entities
  • Tampilan formulir satu rekaman - rute ke get_entity_record
Perangkat Hubungan
get_entity_record Membuka tampilan formulir untuk satu rekaman dari kisi
update_entity_record Memperbarui bidang pada rekaman entitas apa pun
delete_entity_record Menghapus rekaman entitas apa pun
search_entities Pencarian teks bebas di seluruh jenis entitas
list_accounts Daftar akun khusus dengan filter khusus akun
list_contacts Daftar kontak khusus dengan filter khusus kontak
list_cases Daftar kasus khusus dengan filter khusus kasus

Klasifikasi mutasi data

Titik masuk baca-saja dengan potensi mutasi hilir.

Daftar itu sendiri tidak mengubah data. Tindakan tindak lanjut dari kisi (memperbarui, menghapus) dapat memicu operasi tulis melalui alat terpisah.

  • Last updated on