Lihat Akun

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.

• "Tampilkan detail akun Contoso"
• "Buka akun Petualangan Berhasil"
• "Lihat akun Fabrikam"
• "Tunjukkan saya akun Northwind Traders"
• "Apa detail untuk akun Litware?"
• "Buka akun ini"

Yang akan Anda lihat di obrolan

Asisten menampilkan formulir akun interaktif sebagai komponen app-in-chat. Formulir menampilkan bidang akun seperti nama, industri, alamat, nomor telepon, email, dan bidang kustom apa pun yang dikonfigurasi pada formulir.

Tips

• Anda dapat menggunakan nama akun atau GUID untuk membuka akun tertentu.
• Jika asisten mengatakan beberapa akun cocok, coba "daftar akun", lalu pilih salah satu yang Anda inginkan.
• Untuk ringkasan teks singkat, bukan formulir lengkap, ucapkan "ringkas akun ini" atau "memberi tahu saya tentang Contoso".

Tip

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

Apa yang terjadi selanjutnya

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

• "Ringkas akun ini"
• "Tampilkan kontak di akun ini"
• "Perbarui nomor telepon di akun ini"
• "Daftar kasus untuk akun ini"

Apakah ini mengubah data?

Tidak, melihat akun tidak mengubah data.

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

• Tinjau semua detail akun
• Mengedit bidang yang didukung sebaris
• Buka formulir akun lengkap di Dynamics 365
• Lanjutkan bekerja dengan akun 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 Akun
Nama alat internal	get_account
Kegunaan	Membuka tampilan formulir lengkap dari satu rekaman akun CRM dengan pengeditan sebaris

Perilaku alat

Membuka tampilan formulir lengkap dari satu rekaman akun CRM dengan pengeditan sebaris. Menerima GUID atau nama akun dan menyelesaikan nama unik secara otomatis. Menampilkan error saat beberapa akun cocok dengan nama; digunakan list_accounts 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 akun atau nama akun untuk dicari. Ketika nama disediakan, alat menyelesaikannya di sisi server. Jika beberapa akun cocok, kesalahan ditampilkan yang mengarahkan pengguna ke list_accounts 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 akun aplikasi-dalam-obrolan interaktif.

Alat MCP ini didukung oleh Aplikasi MCP.

Jenis respons

Formulir interaktif (tampilan detail)

Formulir menampilkan bidang akun seperti yang ditentukan oleh formulir sistem yang dipilih, termasuk nama akun, industri, alamat, telepon, email, dan bidang khusus.

Catatan perutean

Gunakan get_account untuk:

• "buka akun X", "tampilkan detail akun", "lihat Contoso"
• Setiap prompt yang menyebutkan akun tertentu dan ingin melihat formulirnya

Jangan gunakan get_account saat prompt secara eksplisit mengatakan:

• "Daftar" atau "tampilkan akun saya" - rute ke list_accounts
• "Ringkas" atau "penjelasan kepada saya tentang" perusahaan - rute ke summarize_account
• Entitas generik dengan nama logis - rute ke get_entity_record

Alat terkait

Perangkat	Hubungan
list_accounts	Mencantumkan akun; digunakan untuk mendisambiguasi saat beberapa cocok dengan nama
summarize_account	Ringkasan teks AI dari konteks akun
update_entity_record	Memperbarui bidang pada catatan akun
get_contact	Membuka formulir kontak; sering digunakan bersama detail akun
get_entity_record	Detail entitas umum untuk jenis entitas non-akun

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.