Formulir Quick-Create Kegiatan

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 bidang apa yang tersedia pada formulir aktivitas sebelum membuat aktivitas. Ini berguna ketika Anda ingin mengetahui informasi apa yang dapat Anda sertakan pada tugas, panggilan telepon, atau janji temu.

Apa fungsinya

Asisten mengambil tata letak formulir untuk jenis aktivitas tertentu dan menampilkan bidang, bagian, dan opsi yang tersedia. Ini memberi tahu Anda informasi apa yang dapat Anda isi saat membuat jenis aktivitas tersebut. Misalnya, formulir tugas menampilkan bidang seperti subjek, tanggal jatuh tempo, dan prioritas, sedangkan formulir panggilan telepon menampilkan bidang seperti nomor telepon, arah, dan durasi.

Coba petunjuk seperti

• "Bidang apa yang dapat saya tetapkan pada tugas?"
• "Tunjukkan bidang formulir panggilan telepon"
• "Bidang apa yang tersedia pada janji temu?"
• "Seperti apa formulir tugasnya?"

Yang akan Anda lihat di obrolan

Asisten menampilkan tata letak formulir sebagai komponen app-in-chat dalam widget linimasa, menampilkan bidang dan opsi yang tersedia untuk jenis aktivitas yang diminta.

Tips

• Ini paling berguna ketika Anda ingin mengetahui dengan tepat detail apa yang dapat Anda tangkap sebelum membuat aktivitas.
• Anda tidak perlu menggunakan ini sebelum membuat aktivitas - Anda selalu dapat mengatakan "buat tugas" secara langsung dan asisten memandu Anda melalui bidang yang diperlukan.
• Bidang yang tersedia dapat bervariasi tergantung pada konfigurasi Dynamics 365 organisasi Anda.

Tip

Jika Anda sudah tahu aktivitas apa yang ingin Anda buat, lewati langkah ini dan ucapkan "buat tugas" atau "catat panggilan telepon" secara langsung.

Apa yang terjadi selanjutnya

Setelah melihat bidang formulir, Anda dapat melanjutkan dengan petunjuk seperti:

• "Buat tugas dengan bidang tersebut"
• "Mencatat panggilan telepon"
• "Jadwalkan janji temu"

Apakah ini mengubah data?

Tidak, melihat bidang formulir tidak mengubah data.

Ini hanya menampilkan tata letak formulir dan bidang yang tersedia. Membuat aktivitas adalah langkah terpisah.

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

Dari formulir pembuatan cepat di obrolan, Anda dapat:

• Isi detail aktivitas (subjek, deskripsi, tanggal jatuh tempo, prioritas)
• Pilih jenis aktivitas (tugas, panggilan telepon, janji temu)
• Simpan aktivitas baru langsung dari formulir tanpa membuka Dynamics 365
• Lanjutkan bekerja di obrolan segera setelah menyimpan

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	Formulir Quick-Create Kegiatan
Nama alat internal	get_activity_quick_create_form
Kegunaan	Mengembalikan metadata formulir pembuatan cepat (bagian, bidang, kumpulan opsi) untuk jenis aktivitas Dynamics 365

Perilaku alat

Mengembalikan metadata formulir pembuatan cepat (bagian, bidang, kumpulan opsi) untuk jenis aktivitas Dynamics 365. Widget get_activity_timeline memanggil ini untuk merender formulir dinamis untuk membuat aktivitas. Gunakan saat pengguna secara eksplisit menanyakan bidang apa yang tersedia pada jenis aktivitas tertentu di organisasi mereka.

Annotations

Annotation	Nilai	Meaning
readOnlyHint	true	Alat ini hanya mengembalikan metadata - tidak ada data yang dimodifikasi.
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

Jenis aktivitas

Input	Description	Required
activityType	activityType (wajib - nama logis jenis aktivitas, misalnya phonecall, task, appointment, atau jenis aktivitas yang disediakan penyewa).	Yes

Mengenai konteks

Input	Description	Required
regardingId,entityId,regardingType,entityType	regardingId atau entityId (rekam GUID), regardingType atau entityType (nama logis entitas). Kedua pasangan penamaan diterima. Opsional - menyediakan konteks untuk rendering formulir.	No

Respons dan perilaku UI

Alat ini merender metadata formulir dalam widget timeline aktivitas.

Alat MCP ini didukung oleh Aplikasi MCP.

Jenis respons

Komponen interaktif (app-in-chat)

Widget menampilkan tata letak formulir pembuatan cepat dengan bidang, bagian, dan kumpulan opsi untuk jenis aktivitas yang diminta.

Catatan perutean

Gunakan get_activity_quick_create_form untuk:

• "Bidang apa yang dapat saya tetapkan pada [jenis aktivitas]?"
• Penggunaan widget internal - widget timeline memanggil ini untuk merender formulir dinamis

Jangan gunakan get_activity_quick_create_form ketika:

• Pengguna ingin membuat aktivitas secara langsung - gunakan create_activity
• Pengguna ingin melihat timeline - gunakan get_activity_timeline

Alat terkait

Perangkat	Hubungan
create_activity	Membuat aktivitas menggunakan bidang yang ditentukan oleh metadata formulir ini
get_activity_timeline	Menampilkan linimasa dan menghosting formulir pembuatan cepat

Klasifikasi mutasi data

Read-only.

Alat ini hanya mengembalikan metadata formulir. Tidak ada data yang dimodifikasi.