Daftar / Cari Email

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.

• "Tunjukkan email tentang kegagalan login"
• "Temukan email dari Sarah"
• "Daftar email tentang kasus ini"
• "Tampilkan email terbaru"
• "Temukan email dengan pertanyaan penagihan subjek"
• "Tampilkan email dari pelanggan"
• "Periksa kotak masuk saya"
• "Tampilkan email dari minggu lalu"

Apa yang Anda lihat di chat

Jika satu email cocok, asisten akan membukanya langsung sebagai tampilan email. Jika beberapa email cocok, asisten akan menampilkan kisi pilihan dengan subjek, pengirim, dan tanggal email. Pilih email dari daftar untuk melihat konten lengkapnya.

Tips

• Pencarian berdasarkan subjek berfungsi bahkan ketika email memiliki awalan "RE:" atau "FWD:" - itu dilucuti secara otomatis.
• Ucapkan "email tentang kasus ini" untuk hanya melihat email yang ditautkan ke kasus saat ini.
• Jika Anda mencari email tertentu dan mendapatkan beberapa hasil, persempit pencarian Anda dengan menambahkan detail lainnya seperti pengirim atau rentang tanggal.
• Tanpa kriteria pencarian, Anda akan melihat 10 email terbaru.

Tip

Setelah menemukan email dalam daftar, pilih untuk melihat konten lengkapnya. Kemudian Anda dapat membalas, meneruskan, atau menautkannya ke kasus.

Apa yang terjadi selanjutnya

Setelah menemukan email, Anda dapat melanjutkan dengan petunjuk seperti:

• "Buka email pertama"
• "Lihat email dari Sarah"
• "Balas email itu"
• "Tautkan email ini ke kasus"
• "Buat kasus dari email ini"

Apakah ini mengubah data?

No. Mencari email tidak mengubah data.

Ini hanya mencari dan menampilkan data email. Tindakan yang Anda lakukan setelah menemukan email, seperti membalas, meneruskan, dan menautkan, dapat mengubah data.

Apa yang dapat Anda lakukan dari komponen app-in-chat

Dari daftar email di obrolan, Anda dapat:

• Menelusuri email dengan subjek, pengirim, tanggal, dan arah (masuk/keluar)
• Pilih email untuk membaca konten lengkapnya di penampil email
• Membuka email di Dynamics 365
• Gunakan perintah tindak lanjut untuk memfilter berdasarkan tanggal, pengirim, atau menautkan email ke kasus

Prasyarat

Alat ini membutuhkan hal-hal berikut:

• Email

Pelajari lebih lanjut di Mengonfigurasi email.

Ringkasan alat

Harta benda	Nilai
Nama yang menghadap pengguna	Daftar / Cari Email
Nama alat internal	list_emails
Kegunaan	Mencari aktivitas email Dynamics 365 berdasarkan subjek atau pengirim dengan deduplikasi rantai balasan otomatis

Perilaku alat

Mencari aktivitas email Dynamics 365 berdasarkan subjek atau pengirim dengan deduplikasi rantai balasan otomatis. RE:/FWD: awalan dihapus dan email terbaru per utas disimpan. Satu kecocokan mengembalikan widget lengkap secara view_email langsung; beberapa kecocokan mengembalikan kisi pilihan untuk disambiguasi. Tanpa filter, mengembalikan 10 email terbaru.

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

Pencarian subjek

Input	Description	Required
subject	subject (pencocokan parsial, tidak peka huruf besar/kecil — RE:/FWD: awalan dihapus secara otomatis).	No

Filter pengirim

Input	Description	Required
from	from (kecocokan sebagian pada nama tampilan atau alamat email pengirim).	No

Cakupan data

Input	Description	Required
entityId, entityType, incident	entityId (GUID kasus atau rekaman untuk cakupan hasil ke), entityType (nama logis entitas, default ke incident). Lulus entityId setiap kali pengguna bertanya tentang email dari kasus tertentu.	No

Batas hasil

Input	Description	Required
top	top (utas email unik maksimum untuk dikembalikan setelah deduplikasi, default ke 10).	No

Rentang tanggal

Input	Description	Required
dateFrom, dateTo	dateFrom dan dateTo (tanggal ISO 8601 untuk membatasi jendela waktu).	No

Respons dan perilaku UI

Alat ini merender kisi pemilihan email interaktif atau tampilan email tunggal.

Alat MCP ini didukung oleh aplikasi MCP.

Jenis respons

Komponen interaktif (app-in-chat)

Pencocokan tunggal: mengembalikan widget lengkap view_email secara langsung. Beberapa kecocokan: mengembalikan kisi pilihan — tunggu pengguna memilih, lalu memanggil view_email dengan activityId yang dipilih. Tidak ada hasil: mengembalikan status kosong.

Catatan perutean

Gunakan list_emails untuk:

• "Tunjukkan email dari [orang]", "temukan email tentang [topik]"
• Setiap kali Anda membutuhkan email tetapi tidak memiliki activityId
• Mencari email yang dikirim dan diterima
• Mencari email yang menjangkau kasus tertentu melalui entityId

Jangan gunakan list_emails ketika:

• Pengguna sudah memiliki activityId dan ingin membacanya — gunakan view_email
• Pengguna ingin melihat linimasa aktivitas lengkap (bukan hanya email) — gunakan get_activity_timeline

Alat terkait

Perangkat	Hubungan
view_email	Membuka email tertentu berdasarkan activityId (dipanggil setelah pemilihan dari kisi)
draft_email	Menulis email baru
get_activity_timeline	Menampilkan semua jenis aktivitas pada rekaman, bukan hanya email
link_email_to_case	Menautkan email yang ditemukan melalui pencarian ke kasus
create_case_from_email	Membuat kasus dari email yang ditemukan

Klasifikasi mutasi data

Read-only.

Alat ini hanya mencari dan menampilkan data email. Tidak ada data yang dimodifikasi.