Daftar 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.

Gunakan kemampuan ini saat Anda ingin menemukan akun pelanggan, meninjaunya di obrolan, dan mengambil tindakan tanpa meninggalkan percakapan.

Apa fungsinya

Asisten menampilkan daftar akun yang cocok dengan filter Anda. Anda dapat memfilter berdasarkan:

  • Apakah akun ditetapkan kepada Anda
  • Status akun (aktif atau tidak aktif)
  • Kota
  • Nama akun

Hasil muncul dalam daftar akun interaktif di dalam obrolan.

Coba petunjuk seperti

  • "Tampilkan akun aktif saya"
  • "Mencantumkan akun saya"
  • "Tampilkan akun di Seattle"
  • "Mencantumkan akun yang tidak aktif"
  • "Tampilkan akun yang ditetapkan kepada saya"
  • "Temukan akun Contoso"
  • "Mencantumkan semua akun"
  • "Tampilkan akun industri teknologi"

Yang akan Anda lihat di obrolan

Asisten menampilkan daftar akun interaktif sebagai komponen app-in-chat. Daftar ini menunjukkan akun yang cocok dengan detail penting seperti nama akun, industri, kota, telepon, dan email.

Tips

  • Ucapkan "akun saya" atau "ditetapkan kepada saya" untuk hanya melihat akun yang Anda miliki.
  • Gunakan kata status seperti aktif atau tidak aktif untuk memfilter hasil.
  • Gabungkan filter dengan mengucapkan sesuatu seperti "tampilkan akun aktif saya di Seattle".
  • Gunakan nama perusahaan untuk menelusuri akun tertentu.
  • Jika Anda menginginkan ringkasan lengkap perusahaan, ucapkan "memberi tahu saya tentang Contoso". Itu menggunakan alat yang berbeda.

Tip

Setelah daftar akun muncul, Anda dapat mengajukan pertanyaan tindak lanjut tentang akun apa pun yang ditampilkan. Misalnya, "buka akun pertama" atau "ringkas Contoso".

Apa yang terjadi selanjutnya

Setelah daftar muncul, Anda dapat melanjutkan dengan petunjuk seperti:

  • "Buka akun pertama"
  • "Ringkas akun ini"
  • "Tampilkan kontak di akun ini"
  • "Perbarui nomor telepon di akun ini"

Apakah ini mengubah data?

Tidak, mencantumkan akun tidak mengubah data.

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

  • Memindai dan meninjau akun yang cocok dalam kisi yang dapat diurutkan
  • Pilih akun untuk melihat detail selengkapnya
  • Buka formulir akun lengkap di Dynamics 365
  • Perbarui bidang yang didukung sebaris jika tersedia
  • 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 Daftar Akun
Nama alat internal list_accounts
Kegunaan Mencantumkan akun pelanggan yang difilter berdasarkan pencarian status, kota, pemilik, atau nama dan merendernya dalam pengalaman app-in-chat bergaya kisi interaktif

Perilaku alat

Mencantumkan akun pelanggan yang difilter berdasarkan pencarian status, kota, pemilik, atau nama dan merendernya dalam pengalaman app-in-chat bergaya kisi interaktif. Parameter melakukan search contains-match terhadap nama akun.

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

Input Description Required
— string teks bebas. Melakukan kecocokan berisi terhadap nama akun. No

Kota

Input Description Required
address1_city Filter berdasarkan address1_city (berisi kecocokan). Gunakan saat pengguna menentukan lokasi geografis. No

Status

Input Description Required
active, inactive active atau inactive. Memfilter berdasarkan kode status akun. No

Cakupan kepemilikan

Input Description Required
assignedToMe assignedToMe (Boolean). Jika true, cakupan menghasilkan akun yang dimiliki oleh pengguna saat ini. No

Batas hasil

Input Description Required
top top (bilangan bulat). Jumlah maksimum akun yang akan dikembalikan. Default ke 10, maks 200. No

Filter Tambahan

Input Description Required
additionalFilter additionalFilter (peta nilai kunci). Kondisi filter OData arbitrer digabungkan dengan AND, menggunakan sintaks objek odata-query Filter<T> . No

Respons dan perilaku UI

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

Alat MCP ini didukung oleh Aplikasi MCP.

Jenis respons

Kisi interaktif (tampilan daftar)

Kisi menampilkan nama akun, industri, kota, telepon, dan email. Pengguna dapat memilih baris untuk menelusuri detail akun atau mengambil tindakan tindak lanjut melalui obrolan.

Catatan perutean

Gunakan list_accounts untuk:

  • "Akun Saya", "Akun yang Ditetapkan untuk Saya", "Akun Aktif Saya"
  • Pemfilteran berbasis status (aktif, tidak aktif)
  • Pemfilteran berbasis kota
  • Pencarian nama akun

Jangan gunakan list_accounts saat prompt secara eksplisit mengatakan:

  • Akun tertentu berdasarkan nama untuk tampilan detail - rute ke get_account
  • "Memberi tahu saya tentang" atau "meringkas" perusahaan - rute ke summarize_account
  • Penelusuran teks bebas di beberapa jenis entitas - rute ke search_entities
  • Asosiasi bidang pencarian - rute ke search_lookup_records
Perangkat Hubungan
get_account Membuka formulir akun lengkap untuk akun yang dipilih
summarize_account Menghasilkan ringkasan akun yang didukung AI
list_contacts Mencantumkan kontak, sering digunakan bersama penjelajahan akun
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.

  • Last updated on