Planningen

Voer de prompt van een agent elke doordeweekse dag, elk uur of één keer uit, in de tijdzone en het gesprek dat je kiest.

Een planning geeft een agent op vaste tijden een prompt, bijvoorbeeld elke werkdag om 08:00 of eenmalig volgende dinsdag. Op elk moment krijgt de agent de prompt als een beurt in het gesprek dat je hebt gekozen en antwoordt daar.

Een planning aanmaken#

Open Planningen in de linkerzijbalk en klik op Nieuwe planning. Het formulier vraagt om:

Hoe je de tijd schrijft:

• Cron heeft vijf velden: minuut, uur, dag van de maand, maand en werkdag. 0 8 * * 1-5 is werkdagen om 08:00.
• RRULE gebruikt het kalenderformaat, bijvoorbeeld FREQ=WEEKLY;BYDAY=MO,WE;BYHOUR=9;BYMINUTE=0. Laze slaat het op als de overeenkomstige cron.
• Eén keer neemt een lokale tijd in de zone, zoals 2026-11-02T09:00. Een eenmalige planning wordt één keer uitgevoerd en verschijnt daarna als voltooid.

Een ongeldige tijd of zone wordt geweigerd met schedule_invalid en er wordt niets opgeslagen.

Een herhalende planning wordt maximaal elke 30 minuten uitgevoerd. Een cron of RRULE waarvan de uitvoeringen dichter bij elkaar liggen, zoals */5 * * * *, wordt geweigerd met schedule_too_frequent; voor werk dat iets volgend moet uitvoeren, gebruik je in plaats daarvan een trigger.

Wat er gebeurt wanneer een planning wordt uitgevoerd#

De agent plaatst "Geplande uitvoering: Ochtendbriefing" (met de naam van de planning) en de prompt in het gesprek dat je hebt gekozen, en het antwoord gaat in een thread onder dat bericht. De prompt telt als een bericht van de persoon die de planning heeft gemaakt, dus de agent werkt met de toegang van die persoon tot de kluis.

Elke uitvoering start in een nieuwe sessie voor een gehoste agent: deze heeft de skills en geheugenbestanden van de agent, maar niet de eerdere chats, dus de agent voert de taak telkens uit vanuit de kanalen, bestanden en verbindingen. Wanneer de uitvoering eindigt, krijgt de hoofdsessie van de agent een korte notitie van wat de uitvoering heeft gedaan. Een uitvoering die niets te doen vindt, plaatst niets.

Als de agent dat kanaal heeft verlaten, plaatst de uitvoering niets en krijgt de agent geen beurt. Als de agent is verwijderd, wordt de uitvoering geregistreerd als overgeslagen en stopt de planning.

Eerst controleren, alleen wakker maken als er iets is veranderd#

Een planning die peilt naar wijzigingen heeft niet elke keer een model nodig. Geef deze een check: een uitvoerbaar script in de werkmap van de agent. Bij elke uitvoering draait het script op de agentcomputer, vóór elke modelaanroep.

Stel dit in onder Eerst controleren in het formulier, of met laze schedule add ... --check checks/new-calls.sh. Alleen de agent of de eigenaar kan een check instellen of wijzigen, omdat deze wordt uitgevoerd met de bestanden van de agent en het commando laze. Het wordt buiten elke beurt uitgevoerd, dus commando's laze vault weigeren het. Een check die zelf een model aanroept, betaalt voor die aanroep. Agents die vanaf je eigen machine zijn verbonden, hebben geen Laze-computer om een check op uit te voeren.

Bewaar wat het script het laatst heeft gezien in een eigen bestand. Dit voorbeeld wekt de agent wanneer een waarde verandert, en de beurt van de agent slaat de nieuwe waarde op:

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

De eerste 8000 tekens van de uitvoer bereiken de agent, gemarkeerd als gegevens van het script. Ze worden niet in het gesprek geplaatst. Drie opeenvolgende mislukkingen sturen de persoon die de planning heeft gemaakt één kaart in de Feed. Nu uitvoeren voert eerst de check uit, en test zo een script: het wekt de agent alleen als het script iets afdrukt. Een check wekt een slapende computer, die kort daarna weer in slaap valt wanneer de check niets vindt.

Als wat je monitort een app-record of een kanaal is, gebruik dan in plaats daarvan een trigger of een monitor: deze activeren bij de wijziging en hebben tot dan geen computer nodig.

Tijdzones, zomertijd en downtime#

Tijden volgen de tijdzone van de planning, inclusief zomertijd:

• Wanneer de klokken vooruitgaan en de tijd die dag niet bestaat, wordt de planning één keer uitgevoerd, direct na het gat.
• Wanneer de klokken teruggaan en de tijd twee keer voorkomt, wordt de planning één keer uitgevoerd, bij de eerste.
• Als Laze niet beschikbaar was en uitvoeringen heeft gemist, wordt de planning één keer uitgevoerd wanneer Laze weer online is, en die uitvoering vermeldt hoeveel er zijn gemist. De volgende uitvoering wordt dan vanaf nu geteld.

Een planning pauzeren, bewerken en verwijderen#

Elke rij op de pagina Planningen heeft Uitvoeringen, Bewerken, Pauzeren of Hervatten, en Verwijderen:

• Uitvoeringen toont elke uitvoering met de tijd en het resultaat.
• Pauzeren wist de volgende uitvoering. Hervatten telt de volgende uitvoering vanaf nu en haalt de gepauzeerde tijd niet in.
• Bewerken wijzigt de naam, prompt, tijd, zone of het gesprek. Een gepauzeerde planning blijft gepauzeerd na een bewerking, en een voltooide eenmalige planning wordt opnieuw uitgevoerd als je deze een tijd in de toekomst geeft.
• Verwijderen verwijdert de planning; deze wordt nooit meer uitgevoerd.

Iedereen die met de agent kan praten, ziet de planningen ervan en kan deze aanmaken, bewerken, pauzeren, hervatten en verwijderen: de eigenaar, de mensen met wie deze is gedeeld, en iedereen voor een teamagent. De persoon die om een planning heeft gevraagd, behoudt deze ook. Andere mensen, inclusief werkruimte-admins, zien de planningen van de agent niet; het plannen van een agent waarmee je niet kunt praten, wordt geweigerd met schedule_agent_not_allowed.

Plannen via de commandoregel#

Mensen en agents gebruiken beide laze schedule. Geef precies één van --cron, --rrule of --at op. Zonder --tz is de zone 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>

Nu uitvoeren en uitvoeringen die niet hebben plaatsgevonden#

Nu uitvoeren op de rij van een planning, of laze schedule run <scheduleId>, voert deze onmiddellijk één keer uit. De volgende uitvoering verplaatst niet.

Als een planning wordt geactiveerd terwijl de agent niet is verbonden, is verwijderd of het gesprek is verdwenen, krijgt de persoon voor wie de planning wordt uitgevoerd één kaart in hun feed: Your scheduled run "<name>" did not run, met de reden en een knop Nu uitvoeren. Een volgende gemiste uitvoering van dezelfde planning brengt dezelfde kaart terug.

Voorbeeld: een ochtendbriefing in de feed#

Een ochtendbriefing is een planning waarvan de prompt de agent vertelt om feed-kaarten als één groep te plaatsen. De feed toont de nieuwste groep onder de begroeting, met één filterchip per 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."

Voor een uitgebreidere briefing verdeel je het lezen over scouts. Installeer de skill brief-scout op elke scout-agent en morning-brief op de agent die de briefing schrijft, plan vervolgens de scouts vóór de briefing. Elke scout uploadt zijn rapport als briefs/<YYYY-MM-DD>/<scout>.md naar het kanaal dat de briefing leest, met bewijsmateriaal voor elk item. De briefing-agent leest die bestanden, wacht maximaal 15 minuten op een te late, controleert elk item en plaatst de gecontroleerde items als kaarten in de groep. Een scout die niet is uitgevoerd, leidt de briefing, en de eigenaar krijgt ook de gemiste-uitvoering-kaart met Nu uitvoeren.

Een kaart opnieuw plaatsen met dezelfde sleutel --loop verplaatst deze naar de nieuwe groep en toont hoe vaak deze is gezien. --auto-send-on <YYYY-MM-DD> voegt een afteltimer met een Stop-knop toe aan elke kaart.

Wanneer een agent laze schedule add uitvoert met zijn eigen sleutel, richt de planning zich op die agent en telt als gemaakt door de eigenaar van de agent. Een agent die in de chat om terugkerend werk heeft gevraagd, kan de planning op deze manier aanmaken.

Zie ook: CLI-referentie, Gehoste agents.