Scheman

Kör en agents prompt varje veckodag, varje timme eller en gång, i den tidszon och konversation du väljer.

Ett schema ger en agent en prompt vid bestämda tider, till exempel varje vardag klockan 08:00 eller en gång nästa tisdag. Varje gång får agenten prompten som en tur i den konversation du valde och svarar där.

Skapa ett schema#

Öppna Scheman i vänsterfältet och klicka på Nytt schema. Formuläret frågar efter:

Hur du skriver tiden:

• Cron har fem fält: minut, timme, dag i månaden, månad och veckodag. 0 8 * * 1-5 är vardagar klockan 08:00.
• RRULE använder kalenderformatet, till exempel FREQ=WEEKLY;BYDAY=MO,WE;BYHOUR=9;BYMINUTE=0. Laze lagrar det som den matchande cron.
• En gång tar en lokal tid i zonen, till exempel 2026-11-02T09:00. Ett engångsschema körs en gång och visas sedan som klar.

En ogiltig tid eller zon nekas med schedule_invalid och inget sparas.

Ett upprepande schema körs som mest var 30:e minut. En cron eller RRULE vars körningar ligger närmare varandra, till exempel */5 * * * *, nekas med schedule_too_frequent; för arbete som ska följa något som händer, använd en utlösare istället.

Vad som händer när ett schema körs#

Agenten postar "Schemalagd körning: Morgonbrief" (med schemats namn) och prompten i den konversation du valde. Dess svar hamnar i en tråd under det meddelandet. Prompten räknas som ett meddelande från personen som skapade schemat. Agenten arbetar därför med den personens åtkomst till valvet.

Varje körning startar i en ny session för en hostad agent. Den har agentens färdigheter och minnesfiler men inte dess tidigare chattar. Den utför alltså uppgiften från kanalerna, filerna och anslutningarna varje gång. När körningen avslutas får agentens huvudsession en kort notering om vad körningen gjorde. En körning som inte hittar något att göra postar inget.

Om agenten har lämnat den kanalen postar körningen inget och ger agenten ingen tur. Om agenten togs bort registreras körningen som överhoppad och schemat stoppas.

Kontrollera först, väck bara när något ändrats#

Ett schema som söker efter ändringar behöver ingen modell varje gång. Ge den en kontroll: ett körbart skript i agentens arbetsmapp. Vid varje avfyrning körs skriptet på agentens dator, före eventuella modellanrop.

Ställ in det under Kontrollera först i formuläret, eller med laze schedule add ... --check checks/new-calls.sh. Endast agenten eller dess ägare kan ställa in eller ändra en kontroll, eftersom den körs med agentens filer och laze kommando. Den körs utanför någon tur, så laze vault kommandon vägrar den. En kontroll som själv anropar en modell betalar för det anropet. Agenter anslutna från din egen maskin har ingen Laze-dator att köra en kontroll på.

Spara vad skriptet senast såg i en egen fil. Detta exempel väcker agenten när ett värde ändras, och agentens tur sparar det nya värdet:

#!/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 första 8000 tecknen av utdata når agenten, markerade som data från skriptet. De postas inte i konversationen. Tre misslyckanden i rad skickar personen som gjorde schemat ett kort i Flödet. Kör nu kör kontrollen först, så den testar ett skript: den väcker agenten endast om skriptet skriver ut något. En kontroll väcker en sovande dator, som snart återgår till att sova när kontrollen inte hittar något.

Om det du övervakar är en app-post eller en kanal, använd en utlösare eller en övervakare istället. De aktiveras vid ändringen och behöver ingen dator förrän dess.

Tidszoner, sommartid och driftstopp#

Tiderna följer schemats tidszon, inklusive sommartid:

• När klockorna flyttas fram och tiden inte existerar den dagen, körs schemat en gång, direkt efter glappet.
• När klockorna flyttas tillbaka och tiden inträffar två gånger, körs schemat en gång, vid den första.
• Om Laze var nere och missade körningar, körs schemat en gång när Laze är tillbaka. Den körningen noterar hur många som missades. Nästa körning räknas då från nu.

Pausa, redigera och radera ett schema#

Varje rad på sidan Scheman har Körs, Redigera, Pausa eller Återuppta, och Radera:

• Körs listar varje körning med dess tid och resultat.
• Pausa rensar nästa körning. Återuppta räknar nästa körning från nu och tar inte igen den pausade tiden.
• Redigera ändrar namn, prompt, tid, zon eller konversation. Ett pausat schema förblir pausat efter en redigering. Ett slutfört engångsschema körs igen om du ger det en tid framåt.
• Radera tar bort schemat; det körs aldrig igen.

Alla som kan prata med agenten ser dess scheman och kan skapa, redigera, pausa, återuppta och radera dem: dess ägare, personerna den delas med, och alla för en teamagent. Personen som bad om ett schema behåller det också. Andra personer, inklusive arbetsyteadministratörer, ser inte agentens scheman; att schemalägga en agent du inte kan prata med nekas med schedule_agent_not_allowed.

Schemalägg från kommandoraden#

Personer och agenter använder båda laze schedule. Ange exakt en av --cron, --rrule eller --at. Utan --tz är zonen 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>

Kör nu och körningar som inte ägde rum#

Kör nu på en schemarad, eller laze schedule run <scheduleId>, kör det omedelbart en gång. Nästa avfyrning flyttas inte.

Om ett schema avfyras medan dess agent inte är ansluten, togs bort, eller dess konversation är borta, får personen som schemat körs för ett kort i sitt flöde: Your scheduled run "<name>" did not run, med anledning och en Kör nu-knapp. En annan miss av samma schema återkommer med samma kort.

Exempel: en morgonbrief i flödet#

En morgonbrief är ett schema vars prompt säger åt agenten att posta flödeskort som en grupp. Flödet visar den nyaste gruppen under hälsningen, med ett filterchip per etikett.

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 en större brief, dela upp läsningen mellan "scouts". Installera färdigheten brief-scout på varje "scout"-agent och morning-brief på agenten som skriver briefen. Schemalägg sedan "scouts" före briefen. Varje "scout" laddar upp sin rapport som briefs/<YYYY-MM-DD>/<scout>.md till kanalen briefen läser, med varje objekts bevis. Briefagenten läser dessa filer, väntar upp till 15 minuter på en sen fil, kontrollerar varje objekt och postar de kontrollerade objekten som kort i gruppen. En "scout" som inte kördes leder briefen, och dess ägare får också kortet för missad körning med Kör nu.

Att posta ett kort igen med samma --loop nyckel flyttar det till den nya gruppen och visar hur många gånger det har setts. --auto-send-on <YYYY-MM-DD> lägger till en nedräkning med en Stopp-knapp till vilket kort som helst.

När en agent kör laze schedule add med sin egen nyckel, riktar sig schemat till den agenten och räknas som skapat av agentens ägare. En agent som ombades i chatten för återkommande arbete kan skapa schemat på detta sätt.

Se även: CLI-referens, Hostade agenter.