Zeitpläne

Führe den Prompt eines Agenten jeden Wochentag, jede Stunde oder einmalig aus, in der Zeitzone und Unterhaltung deiner Wahl.

Ein Zeitplan gibt einem Agenten zu festgelegten Zeiten eine Anweisung, zum Beispiel jeden Werktag um 08:00 Uhr oder einmal nächsten Dienstag. Jedes Mal erhält der Agent die Anweisung als Zug in der von dir ausgewählten Unterhaltung und antwortet dort.

Zeitplan erstellen

Öffne Zeitpläne in der linken Leiste und klicke auf Neuer Zeitplan. Das Formular fragt nach:

Feld	Eingabe
Name	Eine kurze Bezeichnung, zum Beispiel „Morgenbriefing“
Agent	Der Agent, der die Arbeit erledigt
Anweisung	Was der Agent jedes Mal tun soll, so geschrieben, wie du es im Chat schreiben würdest
Wann	Wiederholt sich (Cron), Wiederholt sich (RRULE) oder Einmalig, mit der Uhrzeit darunter
Zeitzone	Eine IANA-Zone wie `Europe/Amsterdam`
Antworten in	Deine Direktnachrichten mit dem Agenten oder einer deiner Channel

Das Formular Zeitplan bearbeiten mit Name, Agent, Anweisung, einer wöchentlichen Cron-Zeit, Zeitzone und dem Support-Channel — Ein Zeitplan, der den Agenten jeden Montag um 09:00 Uhr um eine Support-Zusammenfassung bittet.

So gibst du die Uhrzeit ein:

Cron hat fünf Felder: Minute, Stunde, Tag des Monats, Monat und Wochentag. 0 8 * * 1-5 ist werktags um 08:00 Uhr.
RRULE verwendet das Kalenderformat, zum Beispiel FREQ=WEEKLY;BYDAY=MO,WE;BYHOUR=9;BYMINUTE=0. Laze speichert es als den passenden Cron.
Einmalig verwendet eine lokale Uhrzeit in der Zeitzone, zum Beispiel 2026-11-02T09:00. Ein einmaliger Zeitplan wird einmal ausgeführt und erscheint danach als erledigt.

Eine ungültige Uhrzeit oder Zeitzone wird mit schedule_invalid abgelehnt und es wird nichts gespeichert.

Ein sich wiederholender Zeitplan wird höchstens alle 30 Minuten ausgeführt. Ein Cron oder RRULE, dessen Ausführungen dichter beieinander liegen, zum Beispiel */5 * * * *, wird mit schedule_too_frequent abgelehnt; für Arbeiten, die nach einem Ereignis stattfinden sollen, verwende stattdessen einen Auslöser.

Was passiert, wenn ein Zeitplan ausgeführt wird

Der Agent postet „Geplante Ausführung: Morgenbriefing“ (mit dem Namen des Zeitplans) und die Anweisung in der von dir ausgewählten Unterhaltung. Seine Antwort landet in einem Thread unter dieser Nachricht. Die Anweisung zählt als Nachricht von der Person, die den Zeitplan erstellt hat. Der Agent arbeitet daher mit dem Zugriff dieser Person auf den Tresor.

Jede Ausführung beginnt in einer neuen Sitzung für einen gehosteten Agenten: Er verfügt über die Skills und Gedächtnisdateien des Agenten, aber nicht über seine früheren Chats. Daher erledigt er die Aufgabe jedes Mal basierend auf den Channeln, Dateien und Verbindungen. Wenn die Ausführung endet, erhält die Hauptsitzung des Agenten eine kurze Notiz darüber, was die Ausführung getan hat. Eine Ausführung, die nichts zu tun findet, postet nichts.

Wenn der Agent diesen Channel verlassen hat, postet die Ausführung nichts und gibt dem Agenten keinen Zug. Wurde der Agent entfernt, wird die Ausführung als übersprungen vermerkt und der Zeitplan stoppt.

Die Seite Zeitpläne mit einem aktiven Zeitplan, seinem Agenten, Channel, Cron-Zeit und der nächsten Ausführung — Jeder Zeitplan zeigt seinen Agenten, die Unterhaltung, die Uhrzeit und die nächste Ausführung.

Zuerst prüfen, nur bei Änderungen aufwecken

Ein Zeitplan, der auf Änderungen prüft, benötigt nicht jedes Mal ein Modell. Gib ihm eine Prüfung: ein ausführbares Skript im Arbeitsordner des Agenten. Bei jeder Auslösung läuft das Skript auf dem Agenten-Computer, vor jedem Modellaufruf.

Das Skript	Was passiert
Beendet sich mit 0 und gibt etwas aus	Der Agent wacht auf, und das Ausgegebene wird der Anweisung hinzugefügt
Beendet sich mit 0 und gibt nichts aus	Nichts. Die Ausführung wird als Nichts Neues angezeigt und es werden keine Credits verbraucht
Beendet sich mit einem Fehler oder läuft länger als 30 Sekunden	Die Prüfung ist fehlgeschlagen. Der Agent bleibt inaktiv und der Zeitplan erscheint unter Braucht Aufmerksamkeit

Lege dies unter Zuerst prüfen im Formular oder mit laze schedule add ... --check checks/new-calls.sh fest. Nur der Agent oder sein Inhaber kann eine Prüfung einrichten oder ändern, da sie mit den Dateien des Agenten und dem Befehl laze ausgeführt wird. Sie läuft außerhalb jedes Zugs, daher lehnen laze vault-Befehle sie ab. Eine Prüfung, die selbst ein Modell aufruft, bezahlt diesen Aufruf. Agenten, die von deiner eigenen Maschine verbunden sind, haben keinen Laze-Computer, auf dem eine Prüfung ausgeführt werden kann.

Bewahre das, was das Skript zuletzt gesehen hat, in einer eigenen Datei auf. Dieses Beispiel weckt den Agenten, wenn sich ein Wert ändert, und der Zug des Agenten speichert den neuen Wert:

#!/bin/sh
now=$(laze app records list picks --site published | sha256sum)
[ "$now" = "$(cat state/picks 2>/dev/null)" ] && exit 0
echo "picks changed: $now"

Die ersten 8000 Zeichen der Ausgabe erreichen den Agenten, als Daten aus dem Skript markiert. Sie werden nicht in der Unterhaltung gepostet. Drei aufeinanderfolgende Fehler senden der Person, die den Zeitplan erstellt hat, eine Karte in den Feed. Jetzt ausführen führt zuerst die Prüfung aus, testet also ein Skript: Es weckt den Agenten nur, wenn das Skript etwas ausgibt. Eine Prüfung weckt einen schlafenden Computer auf, der bald darauf wieder in den Ruhezustand übergeht, wenn die Prüfung nichts findet.

Wenn das, was du beobachtest, ein App-Eintrag oder ein Channel ist, verwende stattdessen einen Auslöser oder einen Monitor: Sie lösen bei der Änderung aus und benötigen bis dahin keinen Computer.

Zeitzonen, Sommerzeit und Ausfallzeiten

Uhrzeiten folgen der Zeitzone des Zeitplans, einschließlich der Sommerzeit:

Wenn die Uhren vorgestellt werden und die Zeit an diesem Tag nicht existiert, wird der Zeitplan einmal direkt nach der Lücke ausgeführt.
Wenn die Uhren zurückgestellt werden und die Zeit zweimal vorkommt, wird der Zeitplan einmal bei der ersten ausgeführt.
Wenn Laze ausgefallen war und Ausführungen verpasst wurden, wird der Zeitplan einmal ausgeführt, sobald Laze wieder verfügbar ist. Diese Ausführung vermerkt, wie viele verpasst wurden. Die nächste Ausführung wird dann von jetzt an gezählt.

Zeitplan pausieren, bearbeiten und löschen

Jede Zeile auf der Seite Zeitpläne enthält Ausführungen, Bearbeiten, Pausieren oder Fortsetzen und Löschen:

Ausführungen listet jede Ausführung mit ihrer Uhrzeit und ihrem Ergebnis auf.
Pausieren löscht die nächste Ausführung. Fortsetzen zählt die nächste Ausführung von jetzt an und holt die pausierte Zeit nicht nach.
Bearbeiten ändert den Namen, die Anweisung, die Uhrzeit, die Zeitzone oder die Unterhaltung. Ein pausierter Zeitplan bleibt nach einer Bearbeitung pausiert, und ein abgeschlossener einmaliger Zeitplan wird erneut ausgeführt, wenn du ihm eine zukünftige Uhrzeit gibst.
Löschen entfernt den Zeitplan; er wird nie wieder ausgeführt.

Jeder, der mit dem Agenten sprechen kann, sieht seine Zeitpläne und kann sie erstellen, bearbeiten, pausieren, fortsetzen und löschen: sein Inhaber, die Personen, mit denen er geteilt wird, und alle für einen Team-Agenten. Die Person, die einen Zeitplan angefordert hat, behält ihn ebenfalls. Andere Personen, einschließlich Arbeitsbereich-Admins, sehen die Zeitpläne des Agenten nicht; das Planen eines Agenten, mit dem du nicht sprechen kannst, wird mit schedule_agent_not_allowed abgelehnt.

Zeitplan über die Befehlszeile

Personen und Agenten verwenden beide laze schedule. Gib genau eine von --cron, --rrule oder --at an. Ohne --tz ist die Zeitzone UTC.

laze schedule add "Morning brief" --prompt "Write my morning brief from my inbox and calendar" --cron "0 8 * * 1-5" --tz Europe/Amsterdam
laze schedule add "Renewal reminder" --prompt "Remind the team about the ACME renewal" --at 2026-11-02T09:00 --tz Europe/Amsterdam --channel <channelId>
laze schedule list
laze schedule pause <scheduleId>
laze schedule runs <scheduleId>
laze schedule run <scheduleId>

Jetzt ausführen und Ausführungen, die nicht stattgefunden haben

Jetzt ausführen in der Zeile eines Zeitplans oder laze schedule run <scheduleId> führt ihn sofort einmal aus. Die nächste Auslösung verschiebt sich nicht.

Wenn ein Zeitplan ausgelöst wird, während sein Agent nicht verbunden ist, entfernt wurde oder seine Unterhaltung nicht mehr existiert, erhält die Person, für die der Zeitplan läuft, eine Karte in ihrem Feed: Your scheduled run "<name>" did not run, mit dem Grund und einem Jetzt ausführen-Button. Eine weitere verpasste Ausführung desselben Zeitplans bringt dieselbe Karte zurück.

Beispiel: Ein Morgenbriefing im Feed

Ein Morgenbriefing ist ein Zeitplan, dessen Anweisung dem Agenten mitteilt, Feed-Karten als eine Gruppe zu posten. Der Feed zeigt die neueste Gruppe unter der Begrüßung, mit einem Filter-Chip pro Label.

laze schedule add "Morning brief" --cron "45 7 * * 1-5" --tz Europe/Amsterdam --prompt "Check my inbox, calendar and open loops. Post one feed card per thing that needs me with --group \"Morning brief <d Mon>\", one --label of money, promise, decide, nudge, risk or fyi, and --loop <stable key>. Then run laze feed group-summary \"Morning brief <d Mon>\" and post its output."

Für ein größeres Briefing verteile das Lesen auf mehrere Späher. Installiere den Skill brief-scout auf jedem Späher-Agenten und morning-brief auf dem Agenten, der das Briefing erstellt, und plane dann die Späher vor dem Briefing. Jeder Späher lädt seinen Bericht als briefs/<YYYY-MM-DD>/<scout>.md in den Channel hoch, den das Briefing liest, mit dem Beleg für jeden Eintrag. Der Briefing-Agent liest diese Dateien, wartet bis zu 15 Minuten auf einen verspäteten, prüft jeden Eintrag und postet die geprüften Einträge als Karten in der Gruppe. Ein Späher, der nicht ausgeführt wurde, führt das Briefing an, und sein Inhaber erhält auch die Karte für die verpasste Ausführung mit Jetzt ausführen.

Eine Karte erneut mit demselben Schlüssel --loop zu posten, verschiebt sie in die neue Gruppe und zeigt an, wie oft sie gesehen wurde. --auto-send-on <YYYY-MM-DD> fügt jeder Karte einen Countdown mit einem Stopp-Button hinzu.

Wenn ein Agent laze schedule add mit seinem eigenen Schlüssel ausführt, richtet sich der Zeitplan an diesen Agenten und zählt als vom Inhaber des Agenten erstellt. Ein Agent, der im Chat um wiederkehrende Arbeit gebeten wurde, kann den Zeitplan auf diese Weise erstellen.

Siehe auch: CLI-Referenz, Gehostete Agenten.