Memahami Tindakan dalam Botpress
Tindakan dalam Botpress ialah fungsi bahagian pelayan yang dilaksanakan oleh bot semasa aliran perbualan. Mereka mempunyai kuasa untuk mengubah keadaan perbualan, menghantar mesej tersuai, melaksanakan kod arbitrari (seperti memanggil API atau menyimpan data) dan banyak lagi. Pada asasnya, tindakan adalah fungsi JavaScript biasa yang bermaksud bahawa mereka boleh melakukan hampir apa sahaja dalam batasan platform.
Apabila tindakan digunakan oleh Pengurus Dialog (DM), ia menerima beberapa hujah yang menyediakan konteks kepada fungsi tersebut. Argumen ini termasuk atribut pengguna, pembolehubah sesi, pembolehubah sementara, pembolehubah peringkat bot, peristiwa pengguna terkini dalam perbualan, argumen yang diluluskan daripada Pembina Aliran Visual dan vm kotak pasir yang mengandungi beberapa pembolehubah persekitaran.
Mendaftar Tindakan Baharu
Untuk menambah tindakan bot tersuai, anda perlu mencipta fail JavaScript (.js) dan meletakkannya dalam data/global/tindakan folder dalam projek Botpress anda. Malangnya, tiada cara untuk menambah tindakan baharu secara pemrograman semasa masa jalan. Menggunakan ulasan JavaDoc dalam kod anda, anda boleh memberikan maklumat yang bermakna tentang tindakan seperti nama, perihalan, hujah dan nilai lalainya. Anda juga boleh menyembunyikan tindakan dalam editor aliran dengan menambahkan bendera @hidden true dalam ulasan JavaDoc.
Cara Membuat Tindakan Tersuai dalam Botpress
Berikut ialah beberapa langkah yang boleh anda ikuti untuk membuat tindakan tersuai dalam Botpress:
Langkah 1: Buat Bot Anda dan Tambah Nod
Untuk bermula, buat bot baharu dalam Botpress. Setelah bot anda dibuat, tambahkan nod baharu pada aliran perbualan.
Langkah 2: Tambahkan Mesej yang Sesuai pada Nod Anda
Dalam nod yang baru dibuat, tambahkan mesej yang diperlukan untuk memudahkan pertukaran kandungan dengan pengguna. Sebagai contoh, anda boleh menambah mesej teks untuk menyambut pengguna dan meminta nama mereka.
Langkah 3: Buka Kod Laksana dari Bar Sisi
Navigasi ke bar sisi dalam Botpress Flow Builder dan buka 'Editor kod'. Di sinilah anda boleh membina dan mentadbir tindakan tersuai anda.
Langkah 4: Klik pada Butang 'Tambah Tindakan'.
Dalam bahagian 'Lakukan Kod', klik pada butang 'Tambah Tindakan'. Tindakan ini membuka tetingkap 'Buat tindakan_legasi baharu'.
Langkah 5: Tentukan Nama untuk Fail dan Klik pada Butang Hantar
Dalam tetingkap 'Buat action_legacy baharu', berikan nama yang bermakna untuk fail tindakan tersuai anda; contohnya, customAction.js. Setelah anda menentukan nama, klik pada butang 'Serah'. Ini mencipta fail 'customAction.js'.
Langkah 6: Tulis Kod Tersuai Anda
Buka fail 'customAction.js' yang baru dibuat. Di dalam fail, anda akan melihat kod boilerplate yang dijana untuk tindakan baharu. Berikan penerangan yang bermakna untuk tindakan tersuai anda menggunakan ulasan yang sesuai.
Sekarang, tulis kod tersuai anda dalam fungsi. Kod ini mentakrifkan gelagat tindakan tersuai anda. Anda boleh menggunakan JavaScript untuk melaksanakan pelbagai tugas seperti membuat panggilan API, mengakses pangkalan data atau mengendalikan logik yang kompleks.
Langkah 7: Ubah Suai Nod Anda untuk Menggunakan Tindakan Tersuai
Kembali ke Botpress Flow Builder dan ubah suai nod di mana anda ingin mencetuskan tindakan tersuai anda. Tambahkan kad 'Execute Code' pada nod.
Langkah 8: Pilih Nama Tindakan Tersuai Anda dan Tentukan Parameter Tindakan
Dalam kad 'Lakukan Kod', anda akan melihat senarai lungsur turun yang mengandungi nama semua tindakan tersuai anda. Pilih nama tindakan tersuai anda daripada senarai. Jika tindakan tersuai anda memerlukan sebarang parameter, anda boleh menentukannya dalam bahagian 'Parameter' pada kad 'Lakukan Kod'.
Langkah 9: Jadikan Bot Anda Melakukan Tindakan
Akhir sekali, tambahkan kad lain pada nod untuk menjadikan bot anda melakukan tindakan tersuai. Anda boleh menggunakan pembolehubah yang disimpan dalam acara tersebut (dinyatakan dalam kad 'Lakukan Kod') untuk mengakses hasil tindakan tersuai anda dan memasukkannya dalam respons bot.
Contoh Tindakan Tersuai
Katakan anda mahu chatbot anda memberikan maklumat cuaca semasa untuk lokasi tertentu. Anda boleh membuat tindakan tersuai yang memanggil API cuaca dan mengembalikan data cuaca.
const aksios = memerlukan ( 'axios' );const getWeather = async ( pengguna , session, args) => {
lokasi const = args.location || 'New York' ;
const apiKey = 'kunci_api_cuaca_anda' ;
const apiUrl = `https://api.weatherapi.com/v1/current.json?key=${apiKey}&q=${lokasi}`;
cuba {
respons const = tunggu axios.get(apiUrl);
const weatherData = respons.data;
return `Cuaca semasa di ${location} ialah ${weatherData.current.condition.text} dengan suhu ${weatherData.current.temp_c}°C.`;
} tangkap (ralat) {
kembali 'Maaf, saya boleh \' t ambil maklumat cuaca pada masa ini. Sila cuba sebentar lagi.' ;
}
};
kembali getWeather( pengguna , sesi, args);
Tindakan ini mengambil hujah tertentu termasuk pengguna, sesi dan hujah yang menyediakan konteks dan data untuk tindakan itu berfungsi. Dalam contoh ini, tindakan tersuai 'getWeather' menjadikan lokasi sebagai hujah atau lalai kepada 'New York' jika tidak disediakan. Tindakan itu memanggil API Cuaca menggunakan Axios, mengambil data cuaca dan mengembalikan mesej yang mengandungi keadaan cuaca dan suhu.
Kelebihan Tindakan Tersuai
Tindakan tersuai dalam Botpress menawarkan beberapa kelebihan yang meningkatkan keupayaan dan kefungsian chatbot anda:
- Mereka memanjangkan fungsi chatbot melebihi keupayaan terbina dalam.
- Mereka mencipta interaksi yang disesuaikan untuk pengalaman pengguna yang lebih baik.
- Mereka mengambil data masa nyata daripada API untuk respons dinamik.
- Mereka berintegrasi dengan sistem dan pangkalan data bahagian belakang.
- Mereka mengendalikan senario rumit dengan kod tersuai.
- Mereka menggunakan semula tindakan merentas chatbot dan aliran.
- Mereka melaksanakan pengendalian dan pengelogan ralat tersuai.
- Mereka mengoptimumkan tugas intensif sumber.
- Mereka memanfaatkan perkhidmatan luaran untuk penskalaan.
- Mereka mengakses dan berkongsi tindakan tersuai pra-bina.
Kesimpulan
Tindakan tersuai dalam Botpress memanjangkan keupayaan chatbot, memperibadikan interaksi dan menyepadukan API luaran. Pembangun mencipta fungsi JavaScript sebelah pelayan dan menggunakan fungsi tersebut daripada Botpress Flow Builder. Tindakan ini menawarkan kebolehgunaan semula kod, prestasi yang dipertingkatkan dan kebolehskalaan yang menjadikan chatbots lebih serba boleh dan alatan berkuasa. Memanfaatkan tindakan tersuai dalam Botpress menghasilkan pengalaman chatbot yang inovatif dan menarik.