# 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:

1. Siapkan topik dan langganan GCP Pub/Sub
2. Konfigurasikan pemfilteran label Gmail
3. Arahkan pengiriman push ke URL webhook Anda
4. 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 |