Otomatisasi & Penjadwalan
Cron Jobs
Jadwalkan wakeup agen dengan timing yang tepat. Cron job bertahan di seluruh restart Gateway dan mendukung pola penjadwalan yang fleksibel.
Jenis Jadwal
| Jenis | Deskripsi | Contoh |
|---|---|---|
| Ekspresi cron | Sintaks cron standar dengan timezone | 0 7 * * * (setiap hari pukul 7 pagi) |
| Interval | Ulangi pada interval tetap | 30m, 2h, 1d |
| One-shot | Jalankan sekali pada waktu tertentu | 2026-03-15T16:00:00Z |
Target Sesi
- Sesi utama, Masukkan antrian sebagai event sistem dalam percakapan utama agen
- Sesi terisolasi, Jalankan dalam sesi khusus (
cron:<jobId>) untuk menghindari kontaminasi percakapan utama
Mode Pengiriman
| Mode | Deskripsi |
|---|---|
| None | Eksekusi diam (tidak ada output yang diposting) |
| Announce | Posting hasil kembali ke saluran tertentu |
| Webhook | HTTP POST hasil ke URL eksternal |
Pengingat One-Shot
Atur pengingat untuk waktu tertentu. Agen bangun, memproses pengingat, dan secara opsional menghapus pekerjaan setelah berjalan.
Pekerjaan Berulang
Jadwalkan tugas berulang dengan ekspresi cron dan dukungan timezone. Pekerjaan melacak riwayat eksekusinya (sukses, gagal, timing).
Webhooks
Terima event dari layanan eksternal dan arahkan ke agen.
Gmail Pub/Sub
Integrasikan dengan sistem notifikasi push Gmail untuk memicu tindakan agen ketika email tiba:
- Siapkan topik dan langganan GCP Pub/Sub
- Konfigurasikan pemfilteran label Gmail
- Arahkan pengiriman push ke URL webhook Anda
- Neotask menerima pesan dan memasukkan antrian event agen
Webhook Kustom
Daftarkan endpoint HTTP yang memicu giliran agen saat dipanggil. Berguna untuk mengintegrasikan dengan pipeline CI/CD, sistem pemantauan, atau layanan apa pun yang dapat mengirim permintaan HTTP.
Event Sistem
Event sistem adalah sinyal yang membangunkan agen untuk diproses:
- Segera, Proses pada heartbeat berikutnya
- Heartbeat berikutnya, Antri untuk check-in terjadwal berikutnya
Gunakan event sistem untuk alur kerja reaktif, agen bangun ketika sesuatu terjadi daripada pada jadwal tetap.
Heartbeat
Heartbeat adalah sinyal periodik (default ~15 detik) yang memberi agen kesempatan untuk memproses pekerjaan yang tertunda:
- Periksa event sistem baru
- Proses pesan yang antri
- Jalankan otomasi yang tertunda
Heartbeat dapat diaktifkan, dinonaktifkan, atau dikonfigurasi per-agen.
Hooks
Otomasi berbasis event yang memicu perintah atau skrip shell sebagai respons terhadap event Gateway:
- Saat pesan, Jalankan ketika pesan diterima
- Saat giliran agen, Jalankan sebelum atau sesudah agen memproses pesan
- Saat event saluran, Jalankan pada event khusus saluran (bergabung, keluar, reaksi)
Hook berjalan di host Gateway dan memiliki akses ke data konteks event.
Kasus Penggunaan
| Skenario | Solusi |
|---|---|
| Briefing pagi harian | Cron job pukul 7 pagi → agen merangkum pembaruan semalam |
| Pembuatan laporan mingguan | Cron job setiap Senin → agen membuat dan mengirim laporan melalui email |
| Pemantauan email | Webhook Gmail → agen memproses email masuk |
| Notifikasi build | Webhook CI/CD → agen mengumumkan hasil build di Discord |
| Pemeriksaan data per jam | Cron berbasis interval → agen memeriksa dasbor dan memberi peringatan pada anomali |
| Posting sosial terjadwal | Cron job → agen menyusun dan memposting konten pada waktu optimal |