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:
- Bir GCP Pub/Sub konusu ve aboneliği ayarlayın
- Gmail etiket filtrelemesini yapılandırın
- Push teslimatını webhook URL'nize yönlendirin
- 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 |