Lihat Kontak

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 dari kontak tertentu langsung di obrolan.

Apa fungsinya

Asisten membuka formulir kontak terperinci untuk orang yang Anda beri nama atau tentukan dengan ID. Anda dapat melihat semua bidang kontak, mengedit bidang yang didukung sebaris, dan menavigasi ke formulir lengkap di Dynamics 365.

Jika Anda memberikan nama kontak dan beberapa kontak cocok, asisten akan memberi tahu Anda dan menyarankan untuk menggunakan "daftar kontak" untuk menemukan kontak yang tepat.

Coba petunjuk seperti

• "Buka kontak Jordan Reyes"
• "Tunjukkan padaku Scarlett Hughes"
• "Lihat detail kontak untuk Alex Johnson"
• "Buka formulir kontak untuk Maria Garcia"
• "Apa detailnya untuk Jordan?"
• "Tampilkan kontak ini"

Yang akan Anda lihat di obrolan

Asisten menampilkan formulir kontak interaktif sebagai komponen app-in-chat. Formulir menampilkan bidang kontak seperti nama, email, telepon, perusahaan, jabatan, dan bidang kustom apa pun yang dikonfigurasi pada formulir.

Tips

• Anda dapat menggunakan nama kontak atau GUID untuk membuka kontak tertentu.
• Jika asisten mengatakan beberapa kontak cocok, coba "daftar kontak", lalu pilih salah satu yang Anda inginkan.
• Untuk ringkasan teks singkat, bukan formulir lengkap, ucapkan "rangkum kontak Jordan Reyes."
• Untuk detail perusahaan induk, ucapkan "buka akun" diikuti dengan nama perusahaan.

Tip

Setelah formulir kontak muncul, Anda dapat mengajukan pertanyaan tindak lanjut seperti "ringkas kontak ini" atau "daftar kasus untuk kontak ini".

Apa yang terjadi selanjutnya

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

• "Ringkas kontak ini"
• "Tampilkan akun untuk kontak ini"
• "Daftar kasus untuk kontak ini"
• "Perbarui alamat email pada kontak ini"

Apakah ini mengubah data?

Tidak, melihat kontak tidak mengubah data.

Formulir kontak 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 kontak di obrolan, Anda dapat:

• Tinjau semua detail kontak
• Mengedit bidang yang didukung sebaris
• Buka formulir kontak lengkap di Dynamics 365
• 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	Lihat Kontak
Nama alat internal	get_contact
Kegunaan	Membuka tampilan formulir lengkap dari satu rekaman kontak CRM dengan pengeditan sebaris

Perilaku alat

Membuka tampilan formulir lengkap dari satu rekaman kontak CRM dengan pengeditan sebaris. Menerima GUID atau nama kontak dan menyelesaikan nama unik secara otomatis. Mengembalikan kesalahan saat beberapa kontak cocok dengan nama; digunakan list_contacts untuk mendisambiguasi.

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

Pengidentifikasi rekaman

Input	Deskripsi	Required
recordId	recordId (string, wajib). GUID kontak atau nama kontak untuk dicari. Ketika nama disediakan, alat menyelesaikannya di sisi server. Jika beberapa kontak cocok, kesalahan akan ditampilkan yang mengarahkan pengguna ke list_contacts untuk disambiguasi.	Yes

Pemilihan formulir

Input	Deskripsi	Required
formId	formId (string, opsional). GUID formulir sistem untuk digunakan untuk rendering. Default ke formulir utama utama saat dihilangkan.	No

Respons dan perilaku UI

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

Alat MCP ini didukung oleh Aplikasi MCP.

Jenis respons

Formulir interaktif (tampilan detail)

Formulir menampilkan bidang kontak seperti yang ditentukan oleh formulir sistem yang dipilih, termasuk nama lengkap, email, telepon, perusahaan, jabatan, dan bidang khusus.

Catatan perutean

Gunakan get_contact untuk:

• "buka kontak X", "tampilkan detail kontak", "lihat Jordan Reyes"
• Setiap prompt yang menyebutkan kontak tertentu dan ingin melihat formulir mereka

Jangan gunakan get_contact saat prompt secara eksplisit mengatakan:

• "Daftar" atau "tampilkan kontak saya" - rute ke list_contacts
• "Ringkas" kontak - rute ke summarize_contact
• Entitas generik dengan nama logis - rute ke get_entity_record

Alat terkait

Perangkat	Hubungan
list_contacts	Mencantumkan kontak; digunakan untuk mendisambiguasi saat beberapa cocok dengan nama
summarize_contact	Ringkasan teks AI tentang konteks kontak dan riwayat kasus
update_entity_record	Memperbarui bidang pada rekaman kontak
get_account	Membuka formulir akun; sering digunakan bersama detail kontak
get_entity_record	Detail entitas generik untuk jenis entitas non-kontak

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.