Cari 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 mencari rekaman di satu atau beberapa jenis entitas menggunakan kata kunci atau bahasa alami.

Apa fungsinya

Asisten mencari rekaman Dynamics 365 menggunakan metode pencarian terbaik yang tersedia. Jika pencarian relevansi diaktifkan di lingkungan Anda, hasil diberi peringkat berdasarkan relevansi. Jika tidak, asisten kembali ke pencarian pencocokan substring.

Anda dapat mencari di semua jenis entitas sekaligus, atau mempersempit pencarian ke jenis entitas tertentu seperti akun, kontak, atau peluang.

Coba petunjuk seperti

• "Cari Contoso di semua entitas"
• "Temukan catatan yang cocok dengan masalah printer"
• "Cari akun untuk Fabrikam"
• "Cari catatan tentang pemadaman jaringan"
• "Peluang pencarian untuk Project Alpha"
• "Temukan semua catatan yang menyebutkan penagihan"

Yang akan Anda lihat di obrolan

Asisten menampilkan daftar teks rekaman yang cocok langsung dalam percakapan obrolan. Setiap hasil menunjukkan nama rekaman dan jenis entitas. Tidak ada widget interaktif untuk kemampuan ini.

Tips

• Anda dapat mencari di beberapa jenis entitas sekaligus, misalnya "cari akun dan kontak untuk Contoso".
• Untuk daftar akun berdasarkan status atau pemilik, gunakan "daftar akun". Penelusuran lebih baik untuk pencarian berbasis kata kunci.
• Untuk penelusuran khusus kasus, ucapkan "kasus penelusuran" untuk pengalaman yang lebih ditargetkan.
• Teks pencarian dibatasi hingga 500 karakter.
• Asisten memberi tahu Anda apakah menggunakan pencarian relevansi atau pencocokan substring.

Tip

Setelah hasil pencarian muncul, Anda dapat mengajukan pertanyaan tindak lanjut seperti "buka hasil pertama" atau "tampilkan detail untuk Contoso".

Apa yang terjadi selanjutnya

Setelah hasil pencarian muncul, Anda dapat melanjutkan dengan petunjuk seperti:

• "Buka hasil pertama"
• "Tampilkan detail untuk rekaman ini"
• "Ringkas akun ini"
• "Cari lagi dengan kata kunci yang berbeda"

Apakah ini mengubah data?

Tidak, pencarian tidak mengubah data.

Pencarian bersifat baca-saja. Tindakan tindak lanjut dari hasil, seperti memperbarui atau menghapus rekaman, dapat mengubah data.

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	Cari Catatan Entitas
Nama alat internal	search_entities
Kegunaan	Mencari data Dataverse menggunakan metode pencarian terbaik yang tersedia (pencarian relevansi saat diaktifkan, atau penggantian pencocokan substring OData)

Perilaku alat

Mencari rekaman Dataverse menggunakan metode pencarian terbaik yang tersedia (pencarian relevansi saat diaktifkan, atau penggantian pencocokan substring OData). Mendukung semua jenis entitas dan mengembalikan hasil peringkat relevansi jika tersedia. Ini adalah alat teks saja tanpa widget app-in-chat.

Annotations

Annotation	Nilai	Meaning
readOnlyHint	true	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

Cakupan entitas (tunggal)

Input	Description	Required
entityLogicalName	entityLogicalName (string, opsional). Jenis entitas tunggal untuk dicari. Diabaikan jika entityLogicalNames disediakan.	No

Cakupan entitas (beberapa)

Input	Description	Required
entityLogicalNames	entityLogicalNames (array string, opsional). Beberapa jenis entitas untuk dicari secara bersamaan. Lebih diutamakan daripada entityLogicalName.	No

Cari teks

Input	Description	Required
searchText	searchText (string, wajib, maksimal 500 karakter). Bahasa alami atau kueri pencarian kata kunci.	Yes

Batas hasil

Input	Description	Required
top	top (bilangan bulat, opsional). Hasil maksimum per jenis entitas. Default ke pengaturan ukuran halaman organisasi.	No

Respons dan perilaku UI

Alat ini mengembalikan respons teks saja tanpa komponen app-in-chat.

Alat MCP ini didukung oleh Aplikasi MCP.

Jenis respons

Daftar teks rekaman yang cocok

Respons mencakup rekaman yang cocok dengan nama utama, jenis entitas, dan skor relevansinya. Tingkat pencarian (relevansi atau OData berisi) ditunjukkan.

Catatan perutean

Gunakan search_entities untuk:

• Pencarian teks bebas atau kata kunci di semua jenis entitas
• Penggantian pencarian generik saat tidak ada alat khusus
• Pencarian lintas entitas saat jenis entitas tidak ditentukan

Jangan gunakan search_entities saat prompt secara eksplisit mengatakan:

• Kasus penelusuran - rute ke search_cases (mesin yang sama, tercakup ke insiden)
• Daftar akun - rute ke list_accounts
• Daftar kontak - rute ke list_contacts
• Asosiasi bidang pencarian - rute ke search_lookup_records
• Narasi garis waktu yang dihasilkan AI - rute ke summarize_entity_timeline atau get_case_highlights

Alat terkait

Perangkat	Hubungan
search_cases	Mesin pencari yang sama, dicakup ke entitas kasus
search_lookup_records	Mencari rekaman untuk asosiasi bidang pencarian
list_accounts	Daftar akun khusus dengan filter
list_contacts	Daftar kontak khusus dengan filter
list_entity_records	Kisi entitas generik untuk menjelajahi rekaman
get_entity_record	Membuka satu detail rekaman dari hasil pencarian

Klasifikasi mutasi data

Read-only.

Alat ini tidak mengubah data. Ini melakukan kueri pencarian terhadap Dataverse.