Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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.
- Nama kontak
Hasil muncul dalam daftar kontak interaktif di dalam obrolan.
Coba petunjuk seperti
- "Tampilkan kontak saya"
- "Mencantumkan kontak aktif saya"
- "Tampilkan kontak di Contoso"
- "Mencantumkan kontak yang tidak aktif"
- "Tampilkan kontak yang ditetapkan untuk saya"
- "Temukan Jordan Reyes"
- "Daftar semua kontak"
- "Tampilkan kontak di Fabrikam"
Yang akan Anda lihat di obrolan
Asisten menampilkan daftar kontak interaktif sebagai komponen app-in-chat. Daftar ini menunjukkan kontak yang cocok dengan detail penting seperti nama, email, telepon, perusahaan, dan jabatan.
Tips
- Ucapkan "kontak saya" atau "ditugaskan kepada saya" untuk hanya melihat kontak yang Anda miliki.
- Gunakan kata status seperti aktif atau tidak aktif untuk memfilter hasil.
- Gunakan nama perusahaan untuk menemukan kontak di organisasi tertentu, misalnya "tampilkan kontak di Contoso".
- Gabungkan filter dengan mengatakan sesuatu seperti "tampilkan kontak aktif saya di Fabrikam".
- Jika Anda menginginkan ringkasan teks dari kontak, ucapkan "rangkum kontak Jordan Reyes" sebagai gantinya.
Tip
Setelah daftar kontak muncul, Anda dapat mengajukan pertanyaan tindak lanjut tentang kontak apa pun yang ditampilkan. Misalnya, "buka kontak pertama" atau "ringkas Jordan Reyes."
Apa yang terjadi selanjutnya
Setelah daftar muncul, Anda dapat melanjutkan dengan petunjuk seperti:
- "Buka kontak pertama"
- "Ringkas kontak ini"
- "Tampilkan akun untuk kontak ini"
- "Perbarui alamat email kontak ini"
Apakah ini mengubah data?
Tidak, mencantumkan kontak tidak mengubah data.
Daftar kontak hanya baca. Tindakan tindak lanjut dari daftar, seperti memperbarui bidang, dapat mengubah data. Asisten meminta konfirmasi sebelum membuat perubahan.
Apa yang dapat Anda lakukan dari komponen app-in-chat
Dari daftar kontak di obrolan, Anda dapat:
- Memindai dan meninjau kontak yang cocok dalam kisi yang dapat diurutkan
- Pilih kontak untuk melihat detail selengkapnya
- Buka formulir kontak lengkap di Dynamics 365
- Perbarui bidang yang didukung sebaris jika tersedia
- Lanjutkan bekerja dengan kontak 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 Kontak |
| Nama alat internal | list_contacts |
| Kegunaan | Mencantumkan kontak pelanggan yang difilter berdasarkan status, perusahaan induk, pemilik, atau pencarian nama dan merendernya dalam pengalaman app-in-chat bergaya kisi interaktif |
Perilaku alat
Mencantumkan kontak pelanggan yang difilter berdasarkan status, perusahaan induk, pemilik, atau pencarian nama dan merendernya dalam pengalaman app-in-chat bergaya kisi interaktif. Parameter melakukan search contains-match terhadap nama kontak.
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
Search
| Input | Deskripsi | Required |
|---|---|---|
| — | string teks bebas. Melakukan contains-match terhadap nama kontak. | No |
Company
| Input | Deskripsi | Required |
|---|---|---|
| — | Filter berdasarkan nama perusahaan induk (berisi kecocokan). Gunakan saat pengguna menentukan perusahaan atau organisasi. | No |
Status
| Input | Deskripsi | Required |
|---|---|---|
active, inactive |
active atau inactive. Memfilter berdasarkan kode status kontak. |
No |
Cakupan kepemilikan
| Input | Deskripsi | Required |
|---|---|---|
assignedToMe |
assignedToMe (Boolean). Jika true, cakupan menghasilkan kontak yang dimiliki oleh pengguna saat ini. |
No |
Batas hasil
| Input | Deskripsi | Required |
|---|---|---|
top |
top (bilangan bulat). Jumlah kontak maksimum untuk dikembalikan. Default ke 10, maks 200. |
No |
Filter Tambahan
| Input | Deskripsi | Required |
|---|---|---|
additionalFilter |
additionalFilter (peta nilai kunci). Kondisi filter OData arbitrer digabungkan dengan AND. |
No |
Respons dan perilaku UI
Alat ini merender kisi kontak aplikasi-dalam-obrolan interaktif.
Alat MCP ini didukung oleh Aplikasi MCP.
Jenis respons
Kisi interaktif (tampilan daftar)
Kisi menampilkan nama kontak, email, telepon, perusahaan, dan jabatan. Pengguna dapat memilih baris untuk menelusuri detail kontak atau mengambil tindakan tindak lanjut melalui obrolan.
Catatan perutean
Gunakan list_contacts untuk:
- "Kontak Saya", "Kontak yang Ditetapkan untuk Saya", "Kontak Aktif Saya"
- Pemfilteran berbasis status (aktif, tidak aktif)
- Pemfilteran berbasis perusahaan
- Pencarian nama kontak
Jangan gunakan list_contacts saat prompt secara eksplisit mengatakan:
-
Kontak tertentu berdasarkan nama untuk tampilan detail - rute ke
get_contact -
"Ringkas" kontak (orang) - rute ke
summarize_contact -
Penelusuran teks bebas di beberapa jenis entitas - rute ke
search_entities -
Asosiasi bidang pencarian - rute ke
search_lookup_records
Alat terkait
| Perangkat | Hubungan |
|---|---|
get_contact |
Membuka formulir kontak lengkap untuk kontak yang dipilih |
summarize_contact |
Menghasilkan ringkasan kontak bertenaga AI |
list_accounts |
Mencantumkan akun; sering digunakan bersama penjelajahan kontak |
search_entities |
Pencarian teks bebas di semua jenis entitas |
search_lookup_records |
Mencari rekaman untuk asosiasi bidang pencarian |
list_entity_records |
Kisi entitas generik untuk jenis entitas tanpa alat daftar khusus |
Klasifikasi mutasi data
Titik masuk baca-saja dengan potensi mutasi hilir.
Daftar itu sendiri tidak mengubah data. Tindakan tindak lanjut dari kisi (memperbarui, mengedit bidang) dapat memicu operasi tulis melalui alat terpisah.