Automatisierung & Planung
Cron-Jobs
Planen Sie Agenten-Weckrufe mit praezisem Timing. Cron-Jobs ueberdauern Gateway-Neustarts und unterstuetzen flexible Planungsmuster.
Planungstypen
| Typ | Beschreibung | Beispiel |
|---|---|---|
| Cron-Ausdruck | Standard-Cron-Syntax mit Zeitzone | 0 7 * * * (taeglich um 7 Uhr) |
| Intervall | Wiederholung in festen Abstaenden | 30m, 2h, 1d |
| Einmalig | Einmal zu einem bestimmten Zeitpunkt ausfuehren | 2026-03-15T16:00:00Z |
Session-Ziele
- Haupt-Session -- Als Systemereignis in der Hauptkonversation des Agenten einreihen
- Isolierte Session -- In einer dedizierten Session (
cron:<jobId>) ausfuehren, um Hauptkonversationen nicht zu beeinflussen
Zustellmodi
| Modus | Beschreibung |
|---|---|
| None | Stille Ausfuehrung (keine Ausgabe veroeffentlicht) |
| Announce | Ergebnis zurueck an einen bestimmten Kanal senden |
| Webhook | Ergebnis per HTTP POST an eine externe URL senden |
Einmalige Erinnerungen
Setzen Sie eine Erinnerung fuer einen bestimmten Zeitpunkt. Der Agent wacht auf, verarbeitet die Erinnerung und loescht optional den Job nach der Ausfuehrung.
Wiederkehrende Jobs
Planen Sie sich wiederholende Aufgaben mit Cron-Ausdruecken und Zeitzonen-Unterstuetzung. Jobs verfolgen ihren Ausfuehrungsverlauf (Erfolg, Fehler, Timing).
Webhooks
Empfangen Sie Ereignisse von externen Diensten und leiten Sie sie an Agenten weiter.
Gmail Pub/Sub
Integration mit Gmails Push-Benachrichtigungssystem, um Agenten-Aktionen bei eingehenden E-Mails auszuloesen:
- GCP Pub/Sub-Thema und Abonnement einrichten
- Gmail-Label-Filterung konfigurieren
- Push-Zustellung auf Ihre Webhook-URL richten
- Neotask empfaengt Nachrichten und reiht Agenten-Ereignisse ein
Benutzerdefinierte Webhooks
Registrieren Sie HTTP-Endpunkte, die Agenten-Durchlaeufe ausloesen, wenn sie aufgerufen werden. Nuetzlich fuer die Integration mit CI/CD-Pipelines, Monitoring-Systemen oder jedem Dienst, der HTTP-Anfragen senden kann.
Systemereignisse
Systemereignisse sind Signale, die einen Agenten zur Verarbeitung wecken:
- Sofort -- Beim naechsten Heartbeat verarbeiten
- Naechster Heartbeat -- Fuer die naechste geplante Kontrolle einreihen
Verwenden Sie Systemereignisse fuer reaktive Workflows -- Agenten wachen auf, wenn etwas passiert, anstatt nach einem festen Zeitplan.
Heartbeat
Der Heartbeat ist ein periodisches Signal (Standard ca. 15 Sekunden), das Agenten die Moeglichkeit gibt, anstehende Arbeit zu verarbeiten:
- Auf neue Systemereignisse pruefen
- Wartende Nachrichten verarbeiten
- Ausstehende Automatisierungen ausfuehren
Der Heartbeat kann pro Agent aktiviert, deaktiviert oder konfiguriert werden.
Hooks
Ereignisgesteuerte Automatisierung, die Shell-Befehle oder Skripte als Reaktion auf Gateway-Ereignisse ausfuehrt:
- Bei Nachricht -- Ausfuehren, wenn eine Nachricht empfangen wird
- Bei Agenten-Durchlauf -- Vor oder nach der Nachrichtenverarbeitung eines Agenten ausfuehren
- Bei Channel-Ereignis -- Bei kanalspezifischen Ereignissen ausfuehren (Beitritt, Verlassen, Reaktion)
Hooks laufen auf dem Gateway-Host und haben Zugriff auf Ereigniskontextdaten.
Anwendungsfaelle
| Szenario | Loesung |
|---|---|
| Taegliches Morgen-Briefing | Cron-Job um 7 Uhr --> Agent fasst ueber Nacht eingegangene Updates zusammen |
| Woechentliche Berichterstellung | Cron-Job jeden Montag --> Agent erstellt und versendet Bericht per E-Mail |
| E-Mail-Ueberwachung | Gmail-Webhook --> Agent verarbeitet eingehende E-Mails |
| Build-Benachrichtigungen | CI/CD-Webhook --> Agent kuendigt Build-Ergebnisse auf Discord an |
| Stuendliche Datenpruefung | Intervallbasierter Cron --> Agent prueft Dashboard und warnt bei Anomalien |
| Geplante Social-Media-Beitraege | Cron-Job --> Agent verfasst und veroeffentlicht Inhalte zu optimalen Zeiten |