# Automatyzacja i harmonogramowanie

## Zadania Cron

Planuj przebudzenia agentów z precyzyjnym czasowaniem. Zadania cron utrzymują się po ponownym uruchomieniu bramy i obsługują elastyczne wzorce harmonogramowania.

### Typy harmonogramów

| Typ | Opis | Przykład |
|-----|------|---------|
| **Wyrażenie cron** | Standardowa składnia cron ze strefą czasową | `0 7 * * *` (codziennie o 7:00) |
| **Interwał** | Powtarzaj w ustalonych odstępach | `30m`, `2h`, `1d` |
| **Jednorazowe** | Uruchom raz o określonym czasie | `2026-03-15T16:00:00Z` |

### Cele sesji

- **Sesja główna** -- Umieść w kolejce jako zdarzenie systemowe w głównej rozmowie agenta
- **Sesja izolowana** -- Uruchom w dedykowanej sesji (`cron:<jobId>`), aby uniknąć zanieczyszczenia głównych rozmów

### Tryby dostarczania

| Tryb | Opis |
|------|------|
| **Brak** | Ciche wykonanie (brak publikowanego wyjścia) |
| **Ogłoszenie** | Publikuj wynik z powrotem do określonego kanału |
| **Webhook** | Wyślij metodą HTTP POST wynik do zewnętrznego adresu URL |

### Jednorazowe przypomnienia

Ustaw przypomnienie na konkretny czas. Agent przebudza się, przetwarza przypomnienie i opcjonalnie usuwa zadanie po uruchomieniu.

### Zadania cykliczne

Planuj powtarzające się zadania za pomocą wyrażeń cron i obsługi stref czasowych. Zadania śledzą swoją historię wykonania (sukces, niepowodzenie, czas).

---

## Webhooki

Odbieraj zdarzenia z zewnętrznych usług i kieruj je do agentów.

### Gmail Pub/Sub

Integracja z systemem powiadomień push Gmail w celu wyzwalania akcji agenta po nadejściu wiadomości e-mail:

1. Skonfiguruj temat GCP Pub/Sub i subskrypcję
2. Skonfiguruj filtrowanie etykiet Gmail
3. Skieruj dostarczanie push na adres URL webhooka
4. Neotask odbiera wiadomości i umieszcza zdarzenia agenta w kolejce

### Niestandardowe webhooki

Rejestruj punkty końcowe HTTP, które wyzwalają tury agenta po wywołaniu. Przydatne do integracji z potokami CI/CD, systemami monitorowania lub dowolną usługą, która może wysyłać żądania HTTP.

---

## Zdarzenia systemowe

Zdarzenia systemowe to sygnały, które budzą agenta do przetwarzania:

- **Natychmiastowe** -- Przetwarzaj na następnym heartbeat
- **Następny heartbeat** -- Umieść w kolejce na następne zaplanowane sprawdzenie

Używaj zdarzeń systemowych do reaktywnych przepływów pracy -- agenci budzą się, gdy coś się dzieje, a nie według stałego harmonogramu.

---

## Heartbeat

Heartbeat to okresowy sygnał (domyślnie ~15 sekund), który daje agentom możliwość przetwarzania oczekującej pracy:

- Sprawdzaj nowe zdarzenia systemowe
- Przetwarzaj wiadomości w kolejce
- Uruchamiaj oczekujące automatyzacje

Heartbeat można włączyć, wyłączyć lub skonfigurować per agent.

---

## Hooki

Automatyzacja oparta na zdarzeniach, która wyzwala polecenia powłoki lub skrypty w odpowiedzi na zdarzenia bramy:

- **Przy wiadomości** -- Wykonaj, gdy wiadomość jest odebrana
- **Przy turze agenta** -- Wykonaj przed lub po przetworzeniu wiadomości przez agenta
- **Przy zdarzeniu kanału** -- Wykonaj na zdarzeniach specyficznych dla kanału (dołączenie, opuszczenie, reakcja)

Hooki działają na hoście bramy i mają dostęp do danych kontekstu zdarzenia.

---

## Przypadki użycia

| Scenariusz | Rozwiązanie |
|-----------|------------|
| Codzienny poranny briefing | Zadanie cron o 7:00 → agent podsumowuje nocne aktualizacje |
| Tygodniowe generowanie raportów | Zadanie cron w każdy poniedziałek → agent generuje i wysyła raport e-mailem |
| Monitorowanie wiadomości e-mail | Webhook Gmail → agent przetwarza przychodzące wiadomości e-mail |
| Powiadomienia o kompilacji | Webhook CI/CD → agent ogłasza wyniki kompilacji na Discord |
| Godzinowe sprawdzanie danych | Cron oparty na interwałach → agent sprawdza panel i ostrzega o anomaliach |
| Zaplanowane wpisy w mediach społecznościowych | Zadanie cron → agent redaguje i publikuje treści w optymalnych czasach |