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:
- Skonfiguruj temat GCP Pub/Sub i subskrypcję
- Skonfiguruj filtrowanie etykiet Gmail
- Skieruj dostarczanie push na adres URL webhooka
- 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 |