Bagikan melalui


Mengirim acara atau aktivitas

Microsoft Copilot Studio menyediakan dua simpul yang memungkinkan Anda mengirim aktivitas non-pesan: Kirim Peristiwa, dan Kirim Aktivitas. Jenis simpul ini dibahas di bagian berikut.

Cuplikan layar penambahan simpul Tingkat Lanjut, termasuk opsi Kirim peristiwa dan Kirim aktivitas.

Mengirim acara

Simpul Kirim Peristiwa dirancang untuk mengirim aktivitas Peristiwa. Aktivitas acara dikirim dari copilot dan dapat dicegat dan digunakan oleh saluran, yang memutuskan apakah dan bagaimana menggunakan aktivitas tersebut. Saat mengirim acara, Anda memberinya nama dan kemudian Anda dapat menetapkan nilai pada acara tersebut. Nilai ini dapat dalam format apa pun: nilai literal primitif, referensi variabel, atau Power Fx rumus. Nilai akan diserialisasikan sebagai JSON dan ditambahkan ke aktivitas keluar.

Cuplikan layar yang menunjukkan menu pengaturan untuk simpul aktivitas Peristiwa.

Penggunaan node ini meliputi:

  • Anda dapat mengonfigurasi kontrol obrolan web kustom untuk menangani peristiwa yang dikirim dari copilot. Misalnya, Anda dapat mencari acara yang kembali dari kopilot dan mengambil tindakan di halaman tersebut. Sampel 04.api/c.incoming-activity-event di Microsoft Bot Framework repositori sampel Obrolan Web di GitHub menunjukkan cara kerja penanganan peristiwa.
  • AudioCodes menggunakan aktivitas acara untuk memungkinkan Anda mengontrol layanan. Misalnya, memulai atau menghentikan perekaman panggilan. Untuk informasi tambahan, lihat Merekam panggilan.

Mengirim jenis aktivitas lainnya

Selain aktivitas peristiwa, Anda dapat mengirim aktivitas jenis lain menggunakan simpul aktivitas kirim. Umumnya, penggunaan node ini bersifat lanjutan – karenanya berada dalam subkategori lanjutan. Jenis aktivitas yang dapat Anda kirim adalah bagian dari aktivitas yang ditawarkan di Bot Framework Kelas Skema - ActivityTypes. Saat menggunakan simpul ini, Anda memilih jenis aktivitas dan kemudian secara opsional mengatur nama atau nilai.

Jenis yang umum adalah:

  • Mengetik – Mengirim aktivitas pengetikan, yang dapat dipilih saluran untuk diambil dan menampilkan indikator pengetikan pada klien.
  • Penundaan – Dapat digunakan untuk memberikan penundaan antar pesan. Misalnya: mengirim pesan, lalu mengirim aktivitas penundaan, diikuti dengan pesan lain. Untuk pengguna akhir, mereka melihat pesan pertama, diikuti dengan jeda, lalu pesan kedua. Dalam hal ini, "Nilai" diatur ke jumlah penundaan milidetik. Untuk detailnya, lihat Bidang ActivityTypes.Delay.
  • Panggil/Panggil Respons – Umumnya digunakan untuk Microsoft Teams. Pengguna membuat topik dengan pemicu Panggil untuk mencegat Panggilan masuk dari Teams, dan menggunakan aktivitas Panggilan Respons untuk mengirim Respons yang sesuai kembali ke Teams.
  • penyerahan – Memungkinkan pengguna mengirim aktivitas penyerahan dengan kontrol eksplisit atas nilai. Penyerahan digunakan untuk beberapa saluran eksternal, seperti AudioCode.

Cuplikan layar yang menunjukkan simpul aktivitas Panggil dengan daftar dropdown Jenis.