# Otomasyon ve Zamanlama

## Cron İşleri

Hassas zamanlamayla ajan uyanmalarını zamanlayın. Cron işleri, Gateway yeniden başlatmaları boyunca kalıcıdır ve esnek zamanlama kalıplarını destekler.

### Zamanlama Türleri

| Tür | Açıklama | Örnek |
|------|-------------|---------|
| **Cron ifadesi** | Saat dilimiyle standart cron sözdizimi | `0 7 * * *` (her gün saat 7'de) |
| **Aralık** | Sabit aralıklarla tekrar | `30m`, `2h`, `1d` |
| **Tek seferlik** | Belirli bir zamanda bir kez çalışır | `2026-03-15T16:00:00Z` |

### Oturum Hedefleri

- **Ana oturum**, Ajanın ana konuşmasında bir sistem olayı olarak kuyruğa alın
- **Yalıtılmış oturum**, Ana konuşmaları kirletmemek için özel bir oturumda çalıştırın (`cron:<jobId>`)

### Teslimat Modları

| Mod | Açıklama |
|------|-------------|
| **Yok** | Sessiz yürütme (çıktı gönderilmez) |
| **Duyuru** | Sonucu belirli bir kanala geri gönderin |
| **Webhook** | Sonucu harici bir URL'ye HTTP POST yapın |

### Tek Seferlik Hatırlatıcılar

Belirli bir zaman için hatırlatıcı ayarlayın. Ajan uyanır, hatırlatıcıyı işler ve isteğe bağlı olarak çalıştıktan sonra işi siler.

### Yinelenen İşler

Cron ifadeleri ve saat dilimi desteğiyle yinelenen görevler zamanlayın. İşler yürütme geçmişlerini (başarı, başarısızlık, zamanlama) takip eder.

---

## Webhook'lar

Harici hizmetlerden olayları alın ve ajanlara yönlendirin.

### Gmail Pub/Sub

E-postalar geldiğinde ajan eylemlerini tetiklemek için Gmail'in push bildirim sistemiyle entegre olun:

1. Bir GCP Pub/Sub konusu ve aboneliği ayarlayın
2. Gmail etiket filtrelemesini yapılandırın
3. Push teslimatını webhook URL'nize yönlendirin
4. Neotask mesajları alır ve ajan olaylarını kuyruğa alır

### Özel Webhook'lar

Çağrıldığında ajan turlarını tetikleyen HTTP uç noktalarını kaydedin. CI/CD işlem hatlarıyla, izleme sistemleriyle veya HTTP istekleri gönderebilen herhangi bir hizmetle entegrasyon için kullanışlıdır.

---

## Sistem Olayları

Sistem olayları, ajanı işleme için uyandıran sinyallerdir:

- **Anlık**, Sonraki kalp atışında işle
- **Sonraki kalp atışı**, Sonraki planlanmış kontrole kuyruğa al

Reaktif iş akışları için sistem olaylarını kullanın, ajanlar sabit bir programa göre değil, bir şey olduğunda uyanır.

---

## Kalp Atışı

Kalp atışı, ajanlara bekleyen işleri işleme fırsatı veren periyodik bir sinyaldir (varsayılan ~15 saniye):

- Yeni sistem olaylarını kontrol et
- Kuyruktaki mesajları işle
- Bekleyen otomasyonları çalıştır

Kalp atışı, ajan başına etkinleştirilebilir, devre dışı bırakılabilir veya yapılandırılabilir.

---

## Kancalar

Gateway olaylarına yanıt olarak kabuk komutlarını veya betikleri tetikleyen olay güdümlü otomasyon:

- **Mesaj alındığında**, Bir mesaj alındığında yürüt
- **Ajan turu**, Ajan bir mesajı işlemeden önce veya sonra yürüt
- **Kanal olayında**, Kanala özgü olaylarda yürüt (katılma, ayrılma, tepki)

Kancalar Gateway ana bilgisayarında çalışır ve olay bağlamı verilerine erişebilir.

---

## Kullanım Senaryoları

| Senaryo | Çözüm |
|----------|----------|
| Günlük sabah brifing | Saat 7'de cron işi → ajan gece boyunca güncellemeleri özetler |
| Haftalık rapor oluşturma | Her Pazartesi cron işi → ajan rapor oluşturur ve e-posta gönderir |
| E-posta izleme | Gmail webhook → ajan gelen e-postaları işler |
| Derleme bildirimleri | CI/CD webhook → ajan derleme sonuçlarını Discord'da duyurur |
| Saatlik veri kontrolü | Aralık tabanlı cron → ajan gösterge panelini kontrol eder ve anomalilerde uyarı verir |
| Zamanlanmış sosyal medya gönderileri | Cron işi → ajan optimal zamanlarda içerik hazırlar ve yayınlar |