Memahami Tipe Data untuk Variabel
Sebelum kita mendalami aspek praktis penggunaan variabel, mari kita kenali berbagai tipe data yang tersedia di Botpress.
- Rangkaian: String digunakan untuk menyimpan teks yang dapat terdiri dari huruf, angka, atau karakter khusus. Mereka biasanya digunakan untuk menyimpan nama pengguna atau pesan yang dihasilkan AI.
- Boolean: Boolean hanya dapat menampung dua nilai – benar atau salah. Mereka ideal untuk menyimpan informasi biner seperti apakah pengguna adalah pelanggan yang kembali atau apakah pengguna ingin menanyakan hal lain.
- Nomor: Seperti namanya, variabel bilangan digunakan untuk menyimpan nilai numerik yang dapat berupa bilangan bulat atau bilangan dengan tempat desimal. Mereka berguna untuk menyimpan nomor telepon, kode area, dan data numerik lainnya.
- Tanggal: Variabel Tanggal menggunakan format tanggal/waktu ISO 8601. Ini mewakili satu tanggal atau tanggal dan waktu.
- Obyek: Variabel objek adalah kumpulan pasangan nilai kunci yang mirip dengan kamus atau peta. Mereka berguna untuk menyimpan struktur data kompleks seperti profil pengguna atau hasil panggilan API.
- Himpunan: Array digunakan untuk menyimpan kumpulan variabel serupa. Mereka dapat menyimpan string atau objek, menjadikannya serbaguna untuk berbagai kasus penggunaan seperti menyimpan pesan masa lalu pengguna atau memberikan opsi yang dapat dipilih oleh pengguna.
- Jumlah: Ini adalah variabel dengan serangkaian pilihan terbatas yang telah ditentukan sebelumnya. Mereka cocok untuk skenario seperti menyimpan hari dalam seminggu atau item yang tersedia di menu makanan.
- Pola: Variabel pola menggunakan Ekspresi Reguler (Regex) untuk menyimpan pola khusus yang dapat digunakan untuk mencocokkan kata atau angka tertentu. Mereka berguna untuk menyimpan nomor rekening atau nomor penerbangan.
Memahami Lingkup Variabel
Berbagai jenis variabel disertakan dalam Botpress, dan variabel tersebut bervariasi bergantung pada lokasi variabel tersebut dapat diakses dalam alur chatbot Anda. Mari kita jelajahi berbagai cakupan variabel, mulai dari yang paling terbatas hingga yang paling luas:
Variabel Alur Kerja
Variabel ini ditentukan dan digunakan dalam satu alur kerja atau yang sama. Mereka sangat baik untuk aliran sekali pakai seperti menyimpan keluaran tugas AI, jawaban pengguna atas pertanyaan, atau mengatur data dari panggilan API.
Langkah-langkah berikut dapat diikuti untuk membuat variabel alur kerja:
Langkah 1. Pilih alur kerja yang sesuai di menu “Explorer”.
Langkah 2. Mengklik dua kali pada area kosong di editor alur kerja akan membuka panel Inspektur.
Langkah 3. Tentukan nama variabel, pilih tipe data variabel, dan klik tombol “Tambah” untuk membuat variabel.
Anda dapat menambahkan nilai default (awal) ke variabel Anda dari bagian “Pengaturan Tambahan”.
Variabel Alur Kerja Input dan Output
Untuk bertukar informasi, alur kerja mungkin memiliki variabel masukan dan keluaran. Input digunakan untuk menerima informasi dari sumber eksternal atau alur kerja lainnya, sedangkan output memberikan informasi ke sumber eksternal atau alur kerja lainnya. Hal ini memungkinkan komunikasi dan pertukaran data yang lebih fleksibel di dalam bot.
Langkah-langkah berikut dapat diikuti untuk menandai variabel masukan:
Langkah 1. Buat variabel di dalam alur kerja.
Langkah 2. Pilih variabel dengan mengklik node entri alur kerja di panel Inspektur.
Langkah-langkah berikut dapat diikuti untuk menandai variabel keluaran:
Langkah 1. Buat variabel di dalam alur kerja.
Langkah 2. Pilih variabel dengan mengklik simpul keluar alur kerja di panel Inspektur.
Variabel Sesi
Semua alur dapat mengakses variabel ini, tetapi hanya untuk satu percakapan. Mereka ideal untuk menyimpan data yang digunakan sepanjang percakapan seperti riwayat obrolan, item yang dikumpulkan di keranjang belanja virtual, atau data sementara dari panggilan API.
Untuk membuat variabel sesi, Anda dapat menulis kode berikut:
sesi.nama variabel = 'Hallo teman-teman!' ;Untuk menggunakan variabel Anda di kartu teks, kita perlu menutupnya di dalam tanda kurung kurawal, misalnya, {{sesi.namavariabel}} .
Variabel Pengguna
Variabel pengguna mengikuti pengguna di antara percakapan yang memungkinkan data bertahan di beberapa interaksi dengan chatbot. Mereka sempurna untuk menyimpan informasi yang tetap relevan bagi pengguna dari waktu ke waktu seperti detail pribadi, tag dari percakapan sebelumnya, atau preferensi bahasa.
Untuk membuat variabel pengguna:
Langkah 1. Buka “Pengaturan Chatbot” dari ikon Botpress yang terletak di pojok kiri atas.
Langkah 2. Pilih “Variabel” dari tab.
Langkah 3. Tentukan variabel pengguna dengan memberi nama dan menentukan jenis datanya.
@user.variablename atau {{user.variablename}} dapat digunakan untuk merujuk ke variabel “Pengguna” di kartu teks.
Variabel Bot
Semua pengguna di chatbot memiliki akses ke variabel-variabel ini di semua percakapan. Mereka sering digunakan untuk menyimpan informasi dan konfigurasi pengembang seperti menyimpan titik akhir untuk panggilan API, nomor versi bot, atau namanya.
Ikuti langkah-langkah berikut untuk membuat variabel Bot:
Langkah 1. Pilih “Pengaturan Chatbot” dengan mengklik ikon Botpress di pojok kiri atas.
Langkah 2. Pilih “Variabel” dari tab.
Langkah 3. Tentukan nama dan jenis data variabel bot.
Seperti variabel pengguna, @bot.variablename atau bot.variablename dapat digunakan untuk merujuk ke variabel bot di kartu.
Variabel Konfigurasi
Mereka adalah tipe khusus dari variabel bot aman. Anda dapat mengelolanya dari Cloud Dashboard, dan tidak perlu membuka bot. Variabel konfigurasi ideal untuk menyimpan informasi sensitif seperti token API, alamat IP pribadi, atau kredensial database.
Untuk membuat variabel konfigurasi:
Langkah 1. Buka “Pengaturan Chatbot” dari ikon Botpress yang terletak di pojok kiri atas.
Langkah 2. Klik pada tab 'Variabel'.
Langkah 3. Tambahkan variabel konfigurasi dan berikan nama dan nilainya.
Untuk mengakses variabel konfigurasi dalam kode, Anda dapat menggunakan “env.key” di mana “key” mewakili nama variabel konfigurasi yang akan diambil.
Menggunakan Variabel dalam Kode
Tanda kurung kurawal “{{ }}” atau simbol @ tidak diperlukan saat menggunakan variabel dalam kode. Sintaks untuk mengakses variabel dalam kode mengikuti pola “variabletype.variablename”. Misalnya:
Kode:
- alur kerja.phoneNumber
- sesi.userAcctId
- pengguna.Nama Depan
- bot.endpoint
- env.apiKey
Variabel dapat diberi nilai atau diperbarui dalam kode. Namun penting untuk memastikan bahwa nilai yang ditetapkan cocok dengan tipe data variabel untuk menghindari kesalahan.
Kesimpulan
Variabelnya adalah landasan interaksi dinamis dan personal di Botpress. Dengan menggunakan berbagai tipe data dan memahami cakupan variabel, pengembang dapat membuat chatbot dengan kemampuan yang canggih. Apakah Anda perlu menyimpan informasi pengguna, menghubungkan dengan API atau meneruskan data antara alur kerja dan variabel di Botpress memberikan fleksibilitas dan kontrol yang diperlukan.