# Automatisering en planning

## Cron-taken

Plan agentactivaties met nauwkeurige timing. Cron-taken blijven behouden over Gateway-herstarts heen en ondersteunen flexibele planningspatronen.

### Planningstypen

| Type | Beschrijving | Voorbeeld |
|------|-------------|---------|
| **Cron-expressie** | Standaard cron-syntaxis met tijdzone | `0 7 * * *` (dagelijks om 7:00 uur) |
| **Interval** | Herhalen met vaste tussenpozen | `30m`, `2h`, `1d` |
| **Eenmalig** | Eén keer uitvoeren op een specifiek tijdstip | `2026-03-15T16:00:00Z` |

### Sessiedoelen

- **Hoofdsessie**, In de wachtrij plaatsen als systeemevenement in het hoofdgesprek van de agent
- **Geïsoleerde sessie**, Uitvoeren in een toegewijde sessie (`cron:<jobId>`) om hoofdgesprekken niet te vervuilen

### Leveringsmodi

| Modus | Beschrijving |
|------|-------------|
| **Geen** | Stille uitvoering (geen uitvoer gepost) |
| **Aankondiging** | Het resultaat terugposten naar een specifiek kanaal |
| **Webhook** | Het resultaat via HTTP POST verzenden naar een externe URL |

### Eenmalige herinneringen

Stel een herinnering in voor een specifiek tijdstip. De agent wordt wakker, verwerkt de herinnering en verwijdert de taak optioneel na uitvoering.

### Terugkerende taken

Plan herhalende taken met cron-expressies en tijdzoneondersteuning. Taken bijhouden hun uitvoeringsgeschiedenis (succes, mislukking, timing).

---

## Webhooks

Ontvang evenementen van externe services en stuur ze door naar agents.

### Gmail Pub/Sub

Integreer met het push-notificatiesysteem van Gmail om agentacties te activeren wanneer er e-mails binnenkomen:

1. Stel een GCP Pub/Sub-onderwerp en -abonnement in
2. Configureer Gmail-labelfiltering
3. Wijs pushlevering toe aan uw webhook-URL
4. Neotask ontvangt berichten en plaatst agentgebeurtenissen in de wachtrij

### Aangepaste webhooks

Registreer HTTP-eindpunten die agentbeurten activeren wanneer ze worden aangeroepen. Handig voor integratie met CI/CD-pipelines, bewakingssystemen of een service die HTTP-verzoeken kan verzenden.

---

## Systeemevenementen

Systeemevenementen zijn signalen die een agent wakker maken voor verwerking:

- **Onmiddellijk**, Verwerken bij de volgende hartslag
- **Volgende hartslag**, In de wachtrij plaatsen voor de volgende geplande check-in

Gebruik systeemevenementen voor reactieve workflows, agents worden wakker wanneer er iets gebeurt in plaats van op een vast schema.

---

## Hartslag

De hartslag is een periodiek signaal (standaard ~15 seconden) dat agents de kans geeft om openstaand werk te verwerken:

- Controleren op nieuwe systeemevenementen
- Berichten in de wachtrij verwerken
- Openstaande automatiseringen uitvoeren

De hartslag kan per agent worden in- of uitgeschakeld of geconfigureerd.

---

## Hooks

Evenementgestuurde automatisering die shellopdrachten of scripts uitvoert als reactie op Gateway-evenementen:

- **Bij bericht**, Uitvoeren wanneer een bericht wordt ontvangen
- **Bij agentbeurt**, Uitvoeren voor of na het verwerken van een bericht door een agent
- **Bij kanaalevenement**, Uitvoeren bij kanaalspecifieke evenementen (deelnemen, verlaten, reactie)

Hooks draaien op de Gateway-host en hebben toegang tot evenementcontextgegevens.

---

## Gebruiksscenario's

| Scenario | Oplossing |
|----------|----------|
| Dagelijkse ochtendbrief | Cron-taak om 7:00 uur → agent vat nachtelijke updates samen |
| Wekelijkse rapportgeneratie | Cron-taak elke maandag → agent genereert en mailt rapport |
| E-mailbewaking | Gmail-webhook → agent verwerkt inkomende e-mails |
| Build-meldingen | CI/CD-webhook → agent kondigt buildresultaten aan op Discord |
| Uurlijkse gegevenscontrole | Op interval gebaseerde cron → agent controleert dashboard en waarschuwt bij afwijkingen |
| Geplande sociale berichten | Cron-taak → agent ontwerpt en post inhoud op optimale tijden |