# 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:

1. GCP Pub/Sub-Thema und Abonnement einrichten
2. Gmail-Label-Filterung konfigurieren
3. Push-Zustellung auf Ihre Webhook-URL richten
4. 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 |