Cron

Cron-Ausdrücke starten Agenten nach einem wiederkehrenden Zeitplan, etwa für automatisierte Reports, Monitoring und regelmäßige Aufgaben.

Einrichtung

1. 1

   Verbindung erstellen

   Öffne den Agenten, klicke im Verbindungsflussdiagramm auf Add inbound connector, dann auf Create New Connector und wähle Cron Scheduler.

2. 2

   Zeitplan festlegen

   Gib einen Cron-Ausdruck ein, zum Beispiel 0 9 * * 1-5 für werktags um 9 Uhr.

3. 3

   Optional einen Prompt festlegen und auf Create klicken

   Der Prompt erscheint in der Payload des geplanten Runs. Der Zeitplan läuft in der gewählten Zeitzone, standardmäßig in UTC.

So funktioniert Cron

Cron-Verbindungen starten verknüpfte Agenten nach dem konfigurierten Zeitplan. Sobald der geplante Zeitpunkt erreicht ist, startet connic alle Agenten, die mit der Verbindung verknüpft sind.

Der Zeitplan verwendet das standardmäßige Format für Cron-Ausdrücke mit fünf Feldern:

┌───────────── minute (0 - 59)
│ ┌───────────── hour (0 - 23)
│ │ ┌───────────── day of month (1 - 31)
│ │ │ ┌───────────── month (1 - 12)
│ │ │ │ ┌───────────── day of week (0 - 6) (Sunday = 0)
│ │ │ │ │
* * * * *

Weitere Beispiele

# Täglich um Mitternacht
0 0 * * *

# Stündlich
0 * * * *

# Jeden Montag um 9 Uhr
0 9 * * 1

# Jeden Werktag um 9 Uhr
0 9 * * 1-5

# Alle 15 Minuten
*/15 * * * *

# Am ersten Tag jedes Monats um Mitternacht
0 0 1 * *

Optional lässt sich ein Prompt konfigurieren, der bei jedem geplanten Run in die Payload für den Agenten aufgenommen wird. Zum Beispiel: „Erstelle den täglichen Umsatzbericht für gestern“.

Payload-Format

{
  "trigger": "cron",
  "schedule": "0 9 * * 1-5",
  "triggered_at": "2024-01-15T09:00:00+00:00",
  "prompt": "Generate the daily report"
}

Enthalten sind trigger („cron“), schedule, triggered_at (ISO-Zeitstempel) und der optional konfigurierte prompt.