HTTP KB vs HTTP Actions
Memahami perbedaan dan kapan menggunakan masing-masing
Apa Bedanya?
HTTP Knowledge Base dan HTTP Actions adalah dua fitur yang berbeda untuk mengintegrasikan agent Anda dengan sistem eksternal. Keduanya bekerja secara real-time, namun memiliki tujuan yang sangat berbeda.
Untuk mengambil data dari API eksternal agar agent bisa menjawab dengan informasi terbaru
Untuk melakukan aksi melalui API - mengirim data, membuat order, update informasi, dll
Perbandingan Cepat
| Aspek | HTTP Knowledge Base | HTTP Actions |
|---|---|---|
| Tujuan | AMBIL DATA (Untuk dijawab ke user) | LAKUKAN AKSI (Mengubah/mengirim data) |
| Kapan Dijalankan | Otomatis saat user bertanya dan agent butuh data terbaru | Saat user meminta agent melakukan sesuatu |
| Efek Samping | Tidak ada - hanya membaca data | Ada - mengubah data di sistem |
| Method HTTP | Biasanya GET | POST, PUT, PATCH, DELETE |
| Contoh Use Case | Cek stok, status server, data cuaca | Kirim pesan, buat order, update status |
HTTP Knowledge Base
🎯 Untuk Apa?
HTTP KB digunakan ketika agent perlu mengambil data TERBARU dari API eksternal untuk menjawab pertanyaan user. Data diambil secara real-time saat user bertanya.
✅ Kapan Menggunakan
User: "Berapa stok sepatu ukuran 42?" → Agent fetch dari inventory API Anda
User: "Apakah server produksi online?" → Cek dari monitoring API
User: "Cuaca Jakarta hari ini?" → Fetch dari weather API
User: "Berapa total penjualan hari ini?" → Get dari analytics API
HTTP KB adalah untuk READ saja. Tidak mengubah apa pun di sistem Anda - hanya mengambil informasi untuk dijawab ke user.
HTTP Actions
🎯 Untuk Apa?
HTTP Actions digunakan ketika user ingin agent MELAKUKAN SESUATU melalui API - mengirim pesan, membuat order, update data, dan aksi lainnya yang mengubah state di sistem.
✅ Kapan Menggunakan
User: "Kirim laporan ke manager" → POST ke messaging API
User: "Pesan 10 unit produk X" → Create order via API
User: "Ubah status order menjadi complete" → PUT/PATCH ke API
User: "Cancel order #123" → DELETE atau update via API
🔐 Public vs Private Actions
Tidak perlu login. Untuk aksi yang tidak memerlukan data user-specific.
Contoh: Subscribe newsletter, kirim feedback umum
User HARUS login dulu. Untuk aksi yang memerlukan autentikasi dan data user.
Contoh: Transfer uang, cek saldo pribadi, update profil
HTTP Actions mengubah data di sistem Anda. Pastikan API endpoint Anda aman dan memiliki validasi yang tepat!
Cara Memilih yang Tepat
Tanya diri Anda: Apa yang user ingin lakukan?
- User ingin TAHU informasi terbaru dari sistem eksternal
- Data yang dibutuhkan selalu berubah (stok, cuaca, status)
- Tidak ada yang diubah - hanya membaca data
- User ingin MELAKUKAN sesuatu melalui agent
- Ada data yang akan dikirim, diubah, atau dihapus
- Action ini mengubah state di sistem Anda
Contoh Kombinasi Penggunaan
Skenario: E-commerce Bot
- Cek stok produk tertentu
- Tanyakan harga terbaru
- Cek status pengiriman order
- Buat pesanan baru
- Cancel pesanan
- Update alamat pengiriman
Skenario: Support Bot
- Cek status tiket support
- List open tickets user
- Cek availability agent support
- Buat tiket support baru
- Eskalasi tiket ke supervisor
- Close tiket yang solved
Kesalahan Umum
Salah karena HTTP Actions seharusnya untuk aksi yang mengubah data, bukan hanya membaca.
Benar:
Gunakan HTTP KB untuk membaca/mengecek data apapun
Salah karena HTTP KB dirancang untuk READ-only, bukan untuk mengubah state sistem.
Benar:
Gunakan HTTP Actions untuk semua aksi yang mengirim/mengubah data
Ringkasan
🎯 Tujuan
Mengambil data terbaru untuk dijawab
⚡ Karakteristik
READ-only, tidak mengubah apapun
💡 Contoh
Cek stok, status, cuaca, analytics
🎯 Tujuan
Melakukan aksi yang mengubah data
⚡ Karakteristik
WRITE, ada side effects
💡 Contoh
Kirim pesan, buat order, update, delete
Pelajari Lebih Lanjut
HTTP Knowledge Base
Panduan lengkap membuat HTTP KB untuk fetch data real-time dari API eksternal
HTTP Actions
Pelajari cara membuat HTTP Actions untuk execute aksi melalui API
Persistent Context
Cara menggunakan Persistent Context untuk Private Actions dan session management
Login Action
Panduan membuat Login Action dan mengonfigurasi response mapping untuk auth