- Execute Code Card di Botpress memungkinkan Anda untuk menjalankan JavaScript kustom di dalam alur kerja bot, memungkinkan panggilan API dinamis, pemrosesan data, dan logika yang dipersonalisasi di luar tindakan bawaan standar.
- Kasus penggunaan utama termasuk permintaan API dinamis, output LLM pasca-pemrosesan, pembatasan kecepatan, pemeriksaan izin, dan panggilan API multi-langkah berantai, sehingga agen AI dapat menangani alur kerja yang kompleks dengan presisi.
- Praktik terbaik termasuk mengamankan kunci API dalam variabel lingkungan, menangani kesalahan dan batas waktu dengan baik, dan membangun logika bersyarat untuk operasi bot yang kuat dan aman - memastikan integrasi API yang lancar dan dapat diskalakan.
Agen AI hanya sekuat data yang dapat mereka akses. Meskipun model bahasa besarLLMs) menghasilkan respons dari data pelatihan, mereka tidak dapat mengambil harga saham waktu nyata, memproses pembayaran, atau mengakses detail CRM-kecuali jika diintegrasikan dengan API.
API memungkinkan agen AI untuk mengakses data waktu nyata, menjalankan logika, dan memicu tindakan. Untuk memanfaatkannya secara penuh, agen memerlukan kode khusus.
Kartu 'Execute Code' di Botpress Studio memungkinkan Anda menulis dan mengeksekusi JavaScript di dalam alur kerja bot - menangani panggilan API, pemrosesan data, dan kustomisasi perilaku bot dengan lancar.
Apa yang dimaksud dengan Kartu Kode Eksekusi?
Execute Code Card di Botpress memberdayakan para pengembang untuk menjalankan JavaScript kustom dalam alur bot. Kartu ini memungkinkan fungsi-fungsi berikut ini:
- Implementasi Logika Khusus: Anda dapat menjalankan kalkulasi yang rumit atau mengubah data dengan cara yang tidak tercakup dalam tindakan standar.
- Interaksi Dinamis: Sesuaikan respons berdasarkan data pengguna atau perhitungan waktu nyata.
- Integrasi Data: Terhubung dengan layanan pihak ketiga secara mulus untuk mengambil atau mengirim data.
- Manajemen Status: Akses dan modifikasi status bot untuk mempertahankan konteks dan mempersonalisasi interaksi.
- Penanganan Kesalahan: Menerapkan manajemen kesalahan khusus untuk memastikan operasi yang kuat.
KartuKode Eksekusi menampilkan saran kode yang dihasilkan AI. Masukkan perintah-seperti mengambil data API-dan sistem akan menghasilkan JavaScript secara instan. Anda kemudian dapat meninjau, mengedit, dan menyempurnakannya sesuai kebutuhan, sehingga mempercepat pengembangan.
Mengapa Agen AI Membutuhkan API Eksternal?
Agen AI hanya berguna jika data dan layanan yang mereka akses. Meskipun mereka dapat memproses input dan menghasilkan respons, mereka tidak memiliki pengetahuan waktu nyata, kemampuan transaksional, dan integrasi yang mendalam tanpa API eksternal.
Baik Anda mengintegrasikan data waktu nyata, mengotomatiskan alur kerja, atau meningkatkan keamanan, API membuat bot Anda lebih cerdas, responsif, dan terintegrasi.
5 Cara Menggunakan Kartu Kode Eksekusi
Execute Code Card di Botpress Studio menyederhanakan operasi agen AI. Menambahkannya ke alur kerja Anda sangatlah mudah - ikuti tutorial singkat ini:
Setelahditambahkan, berikut ini adalah cara-cara utama untuk memanfaatkannya dalam alur kerja agen Anda.
1. Panggilan API Dinamis
Alih-alih menggunakan panggilan API statis, Execute Card memungkinkan Anda memodifikasi permintaan secara dinamis berdasarkan maksud pengguna, konteks bot, atau percakapan sebelumnya.
Contoh: Mengambil data khusus berdasarkan preferensi pengguna.
Prompt: Chatbot perjalanan perlu mengambil harga hotel berdasarkan tujuan, tanggal perjalanan, dan anggaran pengguna.
.webp)
Catatan: Kartu Kode Eksekusi dapat menghasilkan kode dari bahasa alami. Akan tetapi, selalu lakukan verifikasi terhadap variabel yang digunakan dalam kode yang dihasilkan sebelum menerapkan alur kerja ke produksi.
2. Pemrosesan Pasca-Pemrosesan pada Tanggapan LLM
Meskipun Botpress menyediakan tindakan AI bawaan, terkadang Anda perlu menyempurnakan respons sebelum menampilkannya kepada pengguna - apakah itu memformat keluaran, memfilter kata-kata tertentu, atau menyusun data dengan lebih jelas.
Contoh: Menulis ulang tanggapan LLM yang tidak terstruktur ke dalam tabel/format yang ditentukan.
Permintaan: AI mengambil rekomendasi restoran dari API, dan saya ingin Anda memformatnya ke dalam tabel yang bersih sebelum menampilkannya.
.webp)
3. Pembatasan Suku Bunga dan Eksekusi Bersyarat
Beberapa API, termasuk dompet digital, memiliki batas penggunaan. Dengan Execute Code Card, Anda bisa mengontrol interaksi pengguna dengan memberlakukan batas tarif, mengatur fallback, dan menambahkan logika bersyarat berdasarkan ketersediaan API.
Contoh: Memeriksa 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. Menangani Izin
Jika bot Anda perlu memverifikasi pengguna sebelum memberikan akses ke fitur-fitur tertentu, kartu ini memungkinkan alur autentikasi khusus yang melampaui opsi default Botpress.
Contoh: Memeriksa 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. Rangkaian API Multi-Langkah
Terkadang, bot perlu menggabungkan data dari beberapa API sebelum mengirimkan respons akhir. Kartu ini memungkinkan alur kerja multi-langkah yang kompleks dengan mengambil, mengubah, dan meneruskan data secara dinamis.
Contoh: Mengambil Cuaca + Reservasi Restoran untuk Merekomendasikan Waktu Terbaik untuk Pergi
Perintah: Ambil data cuaca dan lalu lintas untuk workflow.city menggunakan workflow.userApiKey. Berdasarkan kondisi, kembalikan waktu perjalanan terbaik. Menangani kegagalan.
.webp)
Integrasi API Tanpa Batas untuk Agen AI
Agen AI bekerja paling baik ketika mereka dapat memanfaatkan data waktu nyata, mengotomatiskan alur kerja, dan terhubung dengan layanan eksternal.
Botpress Hub membuat hal ini menjadi mulus dengan integrasi API yang sudah jadi, alat otomatisasi, dan konektor yang siap pakai-sehingga Anda bisa fokus pada pembuatan, bukan pada konfigurasi.
Mulaimengintegrasikan API yang kuat ke dalam alur kerja bot Anda hari ini - gratis.
Hal-hal yang sering ditanyakan
1. Apakah saya perlu mengetahui JavaScript untuk menggunakan Execute Code Card secara efektif?
Belum tentu. Akan sangat membantu jika Anda mengetahui dasar-dasarnya, tetapi kartu ini menyertakan saran kode yang dibuat oleh AI. Anda tinggal menjelaskan apa yang Anda inginkan, dan kartu ini akan menulis beberapa kode awal untuk Anda sesuaikan.
2. Apakah ada templat atau cuplikan kode boilerplate untuk integrasi API yang umum?
Ya, Botpress menyediakan contoh dan cuplikan yang dibagikan kepada komunitas untuk kasus-kasus penggunaan yang populer seperti memanggil API cuaca, CRM, atau layanan pembayaran.
3. Dapatkah saya menggunakan Execute Code Card tanpa pengalaman integrasi API sebelumnya?
Tentu saja. Jika Anda baru mengenal API, AI bawaan kartu dapat memandu Anda dengan petunjuk, dan pembangun alur kerja visual membuat seluruh proses lebih intuitif.
4. Bagaimana kartu menangani permintaan API yang berjalan lama atau batas waktu?
Ini mendukung JavaScript asinkron dengan menunggu, tetapi Anda akan ingin membangun penanganan timeout secara manual menggunakan logika try/catch dan fallback untuk menjaga semuanya tetap lancar.
5. Apa saja praktik terbaik untuk menerapkan autentikasi dan otorisasi menggunakan kartu?
Simpan kunci sensitif dengan aman di variabel lingkungan, gunakan token atau header untuk API auth, dan tambahkan logika bersyarat di kode Anda untuk memeriksa peran pengguna atau tingkat akses sebelum melanjutkan.
.webp)
