# Automatisering och schemaläggning

## Cronjobb

Schemalägg agentvakningar med exakt timing. Cronjobb består över Gateway-omstarter och stöder flexibla schemaläggningsmönster.

### Schematyper

| Typ | Beskrivning | Exempel |
|------|-------------|---------|
| **Cron-uttryck** | Standard cron-syntax med tidszon | `0 7 * * *` (dagligen kl. 7) |
| **Intervall** | Upprepa med fasta intervall | `30m`, `2h`, `1d` |
| **Engångs** | Kör en gång vid en specifik tid | `2026-03-15T16:00:00Z` |

### Sessionsmål

- **Huvudsession**, Köa som en systemhändelse i agentens huvudkonversation
- **Isolerad session**, Kör i en dedikerad session (`cron:<jobId>`) för att undvika att förorena huvudkonversationer

### Leveranslägen

| Läge | Beskrivning |
|------|-------------|
| **Ingen** | Tyst exekvering (inget utdata publiceras) |
| **Meddela** | Publicera resultatet tillbaka till en specifik kanal |
| **Webhook** | HTTP POST resultatet till en extern URL |

### Engångspåminnelser

Ställ in en påminnelse för en specifik tid. Agenten vaknar, bearbetar påminnelsen och tar eventuellt bort jobbet efter körning.

### Återkommande jobb

Schemalägg upprepade uppgifter med cron-uttryck och tidszonstöd. Jobb spårar sin exekveringshistorik (framgång, fel, timing).

---

## Webhooks

Ta emot händelser från externa tjänster och dirigera dem till agenter.

### Gmail Pub/Sub

Integrera med Gmails push-meddelandesystem för att utlösa agentåtgärder när e-post anländer:

1. Konfigurera ett GCP Pub/Sub-ämne och en prenumeration
2. Konfigurera Gmail-etikettfiltrering
3. Peka push-leverans till din webhook-URL
4. Neotask tar emot meddelanden och köar agentshändelser

### Anpassade webhooks

Registrera HTTP-slutpunkter som utlöser agentturer när de anropas. Användbart för integration med CI/CD-pipelines, övervakningssystem eller vilken tjänst som helst som kan skicka HTTP-förfrågningar.

---

## Systemhändelser

Systemhändelser är signaler som väcker en agent för bearbetning:

- **Omedelbar**, Bearbeta vid nästa hjärtslag
- **Nästa hjärtslag**, Köa för nästa schemalagda incheckning

Använd systemhändelser för reaktiva arbetsflöden, agenter vaknar när något händer snarare än enligt ett fast schema.

---

## Hjärtslag

Hjärtslaget är en periodisk signal (standard ~15 sekunder) som ger agenter möjlighet att bearbeta väntande arbete:

- Kontrollera efter nya systemhändelser
- Bearbeta köade meddelanden
- Kör väntande automatiseringar

Hjärtslaget kan aktiveras, inaktiveras eller konfigureras per agent.

---

## Krokar

Händelsestyrd automatisering som utlöser skalkommandon eller skript som svar på Gateway-händelser:

- **Vid meddelande**, Kör när ett meddelande tas emot
- **Vid agentur**, Kör före eller efter att en agent bearbetar ett meddelande
- **Vid kanalhändelse**, Kör vid kanalspecifika händelser (gå med, lämna, reaktion)

Krokar körs på Gateway-värden och har tillgång till händelsekontextdata.

---

## Användningsfall

| Scenario | Lösning |
|----------|----------|
| Daglig morgonbriefing | Cronjobb kl. 7 → agenten sammanfattar nattens uppdateringar |
| Vecklig rapportgenerering | Cronjobb varje måndag → agenten genererar och skickar rapport via e-post |
| E-postövervakning | Gmail webhook → agenten bearbetar inkommande e-post |
| Byggnadsmeddelanden | CI/CD webhook → agenten meddelar byggresultat på Discord |
| Timvis datakontroll | Intervallbaserat cron → agenten kontrollerar instrumentpanel och larmar vid avvikelser |
| Schemalagda sociala inlägg | Cronjobb → agenten utkast och publicerar innehåll vid optimala tider |