- Kad Laksana Kod dalam Botpress membolehkan anda menjalankan JavaScript tersuai dalam aliran kerja bot, mendayakan panggilan API dinamik, pemprosesan data dan logik diperibadikan melangkaui tindakan terbina dalam standard.
- Kes penggunaan utama termasuk permintaan API dinamik, pasca pemprosesan LLM output, pengehadan kadar, semakan kebenaran dan rantaian panggilan API berbilang langkah, membenarkan ejen AI mengendalikan aliran kerja yang kompleks dengan tepat.
- Amalan terbaik termasuk mendapatkan kunci API dalam pembolehubah persekitaran, mengendalikan ralat dan tamat masa dengan anggun, dan membina logik bersyarat untuk operasi bot yang teguh dan selamat — memastikan integrasi API yang lancar dan berskala.
Ejen AI hanya berkuasa seperti data yang boleh mereka akses. Manakala model bahasa besar ( LLMs ) menjana respons daripada data latihan, mereka tidak boleh mendapatkan semula harga saham masa nyata, memproses pembayaran atau mengakses butiran CRM—melainkan disepadukan dengan API.
API membolehkan ejen AI mengakses data masa nyata, melaksanakan logik dan mencetuskan tindakan. Untuk memanfaatkannya sepenuhnya, ejen memerlukan kod tersuai.
Kad 'Execute Code' dalam Botpress Studio membolehkan anda menulis dan melaksanakan JavaScript Di dalam aliran kerja bot—mengendalikan panggilan API, pemprosesan data dan penyesuaian tingkah laku bot dengan lancar.
Apakah Kad Kod Laksanakan?
Kad Laksana Kod dalam Botpress memperkasakan pembangun untuk menjalankan JavaScript tersuai dalam aliran bot. Ia membolehkan fungsi berikut:
- Pelaksanaan Logik Tersuai: Anda boleh melaksanakan pengiraan kompleks atau mengubah data dengan cara yang tidak dilindungi oleh tindakan standard.
- Interaksi Dinamik: Laraskan respons berdasarkan data pengguna atau pengiraan masa nyata.
- Penyepaduan Data: Sambung lancar dengan perkhidmatan pihak ketiga untuk mengambil atau menghantar data.
- Pengurusan Negeri: Akses dan ubah suai keadaan bot untuk mengekalkan konteks dan memperibadikan interaksi.
- Pengendalian Ralat: Laksanakan pengurusan ralat tersuai untuk memastikan operasi yang mantap.
Kad Execute Code menampilkan cadangan kod yang dijana AI . Masukkan gesaan—seperti mengambil data API—dan sistem menjana JavaScript serta-merta. Anda kemudian boleh menyemak, mengedit dan memperhalusinya mengikut keperluan, mempercepatkan pembangunan.
Mengapa Ejen AI Memerlukan API Luaran?
Ejen AI hanya berguna seperti data dan perkhidmatan yang mereka akses. Walaupun mereka boleh memproses input dan menjana respons, mereka kekurangan pengetahuan masa nyata, keupayaan transaksi dan penyepaduan mendalam tanpa API luaran.
Sama ada anda menyepadukan data masa nyata, mengautomasikan aliran kerja atau meningkatkan keselamatan, API menjadikan bot anda lebih pintar, responsif dan bersepadu.
5 Cara Menggunakan Kad Execute Code
Kad Execute Code dalam Botpress Studio menyelaraskan operasi ejen AI. Menambahnya pada aliran kerja anda adalah mudah — ikut tutorial pantas ini:
Setelah ditambahkan, berikut ialah cara utama untuk memanfaatkannya dalam aliran kerja agen anda.
1. Panggilan API Dinamik
Daripada menggunakan panggilan API statik, Kad Laksana membolehkan anda mengubah suai permintaan secara dinamik berdasarkan niat pengguna, konteks bot atau perbualan sebelumnya.
Contoh: Mengambil data tersuai berdasarkan pilihan pengguna.
Gesaan: Bot sembang perjalanan perlu mendapatkan semula harga hotel berdasarkan destinasi pengguna , tarikh perjalanan dan belanjawan .
.webp)
Nota: Kad Execute Code boleh menjana kod daripada bahasa semula jadi. Walau bagaimanapun, sentiasa sahkan pembolehubah yang digunakan dalam kod hasil anda sebelum menggunakan aliran kerja ke pengeluaran.
2. Pasca Pemprosesan pada LLM Jawapan
manakala Botpress menyediakan tindakan AI terbina dalam, kadangkala anda perlu memperhalusi respons sebelum menunjukkannya kepada pengguna—sama ada itu memformat output, menapis perkataan tertentu atau menstruktur data dengan lebih jelas.
Contoh: Menulis semula tidak berstruktur LLM jawapan ke dalam jadual/format yang ditentukan.
Gesaan: AI mengambil pengesyoran restoran daripada API dan saya mahu anda memformatkannya ke dalam jadual yang bersih sebelum memaparkannya.
.webp)
3. Had Kadar dan Pelaksanaan Bersyarat
Sesetengah API, termasuk dompet digital, mempunyai had penggunaan. Dengan Kad Execute Code, anda boleh mengawal interaksi pengguna dengan menguatkuasakan had kadar, menetapkan sandaran dan menambah logik bersyarat berdasarkan ketersediaan API.
Contoh: Menyemak Penggunaan API Sebelum Memanggilnya
Prompt: Check API quota from https://api.monitoring.com/usage?apikey=${workflow.userApiKey} before making a request. If fewer than 5 requests remain, return an error; otherwise, proceed. Ensure proper error handling in case of failures.
.webp)
4. Mengendalikan Kebenaran
Jika bot anda perlu mengesahkan pengguna sebelum memberikan akses kepada ciri tertentu, kad tersebut membenarkan aliran pengesahan tersuai yang melampaui Botpress pilihan lalai.
Contoh: Menyemak Status Langganan Pengguna Sebelum Memberikan Respons AI
Prompt: Check a user's subscription via https://billing.example.com/user/{userId}. If on a free plan, prompt an upgrade; otherwise, allow access. Handle errors.
.webp)
5. Rantaian API Berbilang Langkah
Kadangkala, bot perlu menggabungkan data daripada berbilang API sebelum menghantar respons akhir. Kad ini membolehkan aliran kerja berbilang langkah yang kompleks dengan mengambil, mengubah dan menghantar data secara dinamik.
Contoh: Mengambil Cuaca + Tempahan Restoran untuk Mengesyorkan Masa Terbaik untuk Bertolak
Gesaan: Ambil data cuaca dan trafik untuk workflow.city menggunakan workflow.userApiKey. Berdasarkan syarat, kembalikan masa perjalanan terbaik. Mengendalikan kegagalan.
.webp)
Integrasi API Lancar untuk Ejen AI
Ejen AI berfungsi dengan baik apabila mereka boleh memanfaatkan data masa nyata, mengautomasikan aliran kerja dan berhubung dengan perkhidmatan luaran.
Botpress Hub menjadikannya lancar dengan penyepaduan API pra-bina, alatan automasi dan penyambung sedia untuk digunakan—supaya anda boleh memfokuskan pada membina, bukan mengkonfigurasi.
Mula menyepadukan API yang berkuasa ke dalam aliran kerja bot anda hari ini—ia percuma.
Soalan lazim
1. Adakah saya perlu mengetahui JavaScript untuk menggunakan Kad Kod Laksanakan dengan berkesan?
Tak semestinya. Ia membantu untuk mengetahui asas, tetapi kad itu termasuk cadangan kod yang dijana AI. Anda hanya boleh menerangkan perkara yang anda mahukan, dan ia akan menulis beberapa kod pemula untuk anda tweak.
2. Adakah terdapat templat atau coretan kod boilerplate untuk penyepaduan API biasa?
ya, Botpress menyediakan contoh dan coretan yang dikongsi komuniti untuk kes penggunaan popular seperti memanggil API cuaca, CRM atau perkhidmatan pembayaran.
3. Bolehkah saya menggunakan Kad Execute Code tanpa pengalaman penyepaduan API sebelumnya?
betul-betul. Jika anda baru menggunakan API, AI terbina dalam kad boleh membimbing anda dengan gesaan dan pembina aliran kerja visual menjadikan keseluruhan proses lebih intuitif.
4. Bagaimanakah kad mengendalikan permintaan API atau tamat masa yang telah berjalan lama?
Ia menyokong JavaScript tak segerak dengan menunggu, tetapi anda perlu membina pengendalian tamat masa secara manual menggunakan logik cuba/tangkap dan sandaran untuk memastikan perkara berjalan lancar.
5. Apakah amalan terbaik untuk melaksanakan pengesahan dan kebenaran menggunakan kad?
Simpan kunci sensitif dengan selamat dalam pembolehubah persekitaran, gunakan token atau pengepala untuk pengesahan API dan tambah logik bersyarat dalam kod anda untuk menyemak peranan pengguna atau tahap akses sebelum meneruskan.