Pianificazioni

Esegui il prompt di un agente ogni giorno feriale, ogni ora o una sola volta, nel fuso orario e nella conversazione che scegli.

Una pianificazione dà a un agente un prompt a orari prestabiliti, ad esempio ogni giorno feriale alle 08:00 o una volta il prossimo martedì. Ogni volta l'agente riceve il prompt come un turno nella conversazione che hai scelto e risponde lì.

Crea una pianificazione#

Apri Pianificazioni nella barra laterale sinistra e clicca Nuova pianificazione. Il modulo richiede:

Come scrivere l'orario:

• Cron ha cinque campi: minuto, ora, giorno del mese, mese e giorno della settimana. 0 8 * * 1-5 è i giorni feriali alle 08:00.
• RRULE usa il formato calendario, ad esempio FREQ=WEEKLY;BYDAY=MO,WE;BYHOUR=9;BYMINUTE=0. Laze lo memorizza come il cron corrispondente.
• Una volta prende un orario locale nella zona, come 2026-11-02T09:00. Una pianificazione singola viene eseguita una volta e poi viene mostrata come completata.

Un orario o una zona non validi vengono rifiutati con schedule_invalid e nulla viene salvato.

Una pianificazione ripetuta viene eseguita al massimo ogni 30 minuti. Un cron o RRULE le cui esecuzioni avvengono più ravvicinate, come */5 * * * *, viene rifiutato con schedule_too_frequent; per un lavoro che dovrebbe seguire qualcosa che accade, usa un trigger invece.

Cosa succede quando una pianificazione viene eseguita#

L'agente pubblica "Esecuzione pianificata: Brief mattutino" (con il nome della pianificazione) e il prompt nella conversazione che hai scelto, e la sua risposta va in un thread sotto quel messaggio. Il prompt conta come un messaggio della persona che ha creato la pianificazione, quindi l'agente lavora con l'accesso di quella persona alla cassaforte.

Ogni esecuzione inizia in una nuova sessione per un agente ospitato: ha le skill e i file di memoria dell'agente, ma non le sue chat precedenti, quindi esegue il compito ogni volta dai canali, file e connessioni. Quando l'esecuzione termina, la sessione principale dell'agente riceve una breve nota di ciò che l'esecuzione ha fatto. Un'esecuzione che non trova nulla da fare non pubblica nulla.

Se l'agente ha lasciato quel canale, l'esecuzione non pubblica nulla e non dà alcun turno all'agente. Se l'agente è stato rimosso, l'esecuzione viene registrata come saltata e la pianificazione si ferma.

Controlla prima, riattiva solo quando qualcosa è cambiato#

Una pianificazione che verifica i cambiamenti non ha bisogno di un modello ogni volta. Dagli un controllo: uno script eseguibile nella cartella di lavoro dell'agente. Ad ogni attivazione lo script viene eseguito sul computer dell'agente, prima di qualsiasi chiamata al modello.

Impostalo sotto Controlla prima nel modulo, o con laze schedule add ... --check checks/new-calls.sh. Solo l'agente o il suo proprietario possono impostare o modificare un controllo, perché viene eseguito con i file dell'agente e il comando laze. Viene eseguito al di fuori di qualsiasi turno, quindi i comandi laze vault lo rifiutano. Un controllo che chiama un modello stesso paga per quella chiamata. Gli agenti connessi dalla tua macchina propria non hanno un computer Laze su cui eseguire un controllo.

Tieni ciò che lo script ha visto l'ultima volta in un tuo file. Questo esempio riattiva l'agente quando un valore cambia, e il turno dell'agente salva il nuovo valore:

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

I primi 8000 caratteri dell'output raggiungono l'agente, contrassegnati come dati dallo script. Non vengono pubblicati nella conversazione. Tre errori consecutivi inviano alla persona che ha creato la pianificazione una scheda nel Feed. Esegui ora esegue prima il controllo, quindi testa uno script: attiva l'agente solo se lo script stampa qualcosa. Un controllo riattiva un computer inattivo, che torna inattivo poco dopo quando il controllo non trova nulla.

Se ciò che stai monitorando è un record dell'app o un canale, usa un trigger o un monitor invece: si attivano al cambiamento e non hanno bisogno di un computer fino a quel momento.

Fusi orari, ora legale e tempi di inattività#

Gli orari seguono il fuso orario della pianificazione, inclusa l'ora legale:

• Quando gli orologi vanno avanti e l'orario non esiste quel giorno, la pianificazione viene eseguita una volta, subito dopo il divario.
• Quando gli orologi vanno indietro e l'orario si verifica due volte, la pianificazione viene eseguita una volta, al primo.
• Se Laze era inattivo e ha perso delle esecuzioni, la pianificazione viene eseguita una volta quando Laze torna online, e quella esecuzione annota quante ne sono state perse. La prossima esecuzione viene quindi contata da ora.

Metti in pausa, modifica ed elimina una pianificazione#

Ogni riga nella pagina Pianificazioni ha Esecuzioni, Modifica, Pausa o Riprendi, ed Elimina:

• Esecuzioni elenca ogni esecuzione con il suo orario e risultato.
• Pausa annulla la prossima esecuzione. Riprendi conta la prossima esecuzione da ora e non recupera il tempo in cui è stata in pausa.
• Modifica cambia il nome, il prompt, l'orario, la zona o la conversazione. Una pianificazione in pausa rimane in pausa dopo una modifica, e una pianificazione singola completata viene eseguita di nuovo se le dai un orario futuro.
• Elimina rimuove la pianificazione; non verrà mai più eseguita.

Chiunque possa parlare con l'agente vede le sue pianificazioni e può crearle, modificarle, metterle in pausa, riprenderle ed eliminarle: il suo proprietario, le persone con cui è condiviso e tutti per un agente del team. La persona che ha richiesto una pianificazione la mantiene. Altre persone, inclusi gli admin dell'area di lavoro, non vedono le pianificazioni dell'agente; la pianificazione di un agente con cui non puoi parlare viene rifiutata con schedule_agent_not_allowed.

Pianifica dalla riga di comando#

Sia le persone che gli agenti usano laze schedule. Indica esattamente uno tra --cron, --rrule o --at. Senza --tz, la zona è 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>

Esegui ora ed esecuzioni che non sono avvenute#

Esegui ora sulla riga di una pianificazione, o laze schedule run <scheduleId>, la esegue una volta immediatamente. Il prossimo attivazione non si sposta.

Se una pianificazione si attiva mentre il suo agente non è connesso, è stato rimosso o la sua conversazione è sparita, la persona per cui la pianificazione viene eseguita riceve una scheda nel suo feed: Your scheduled run "<name>" did not run, con la ragione e un pulsante Esegui ora. Un'altra mancata esecuzione della stessa pianificazione riporta la stessa scheda.

Esempio: un brief mattutino nel feed#

Un brief mattutino è una pianificazione il cui prompt indica all'agente di pubblicare schede del feed come un unico gruppo. Il feed mostra il gruppo più recente sotto il saluto, con un chip di filtro per etichetta.

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."

Per un brief più grande, dividi la lettura tra gli scout. Installa la skill brief-scout su ogni agente scout e morning-brief sull'agente che scrive il brief, quindi pianifica gli scout prima del brief. Ogni scout carica il suo rapporto come briefs/<YYYY-MM-DD>/<scout>.md nel canale che il brief legge, con le prove di ogni elemento. L'agente del brief legge quei file, attende fino a 15 minuti per un ritardo, controlla ogni elemento e pubblica gli elementi controllati come schede nel gruppo. Uno scout che non è stato eseguito guida il brief, e il suo proprietario riceve anche la scheda di esecuzione mancata con Esegui ora.

Pubblicare di nuovo una scheda con la stessa chiave --loop la sposta nel nuovo gruppo e mostra quante volte è stata vista. --auto-send-on <YYYY-MM-DD> aggiunge un conto alla rovescia con un pulsante Stop a qualsiasi scheda.

Quando un agente esegue laze schedule add con la propria chiave, la pianificazione si rivolge a quell'agente e conta come creata dal proprietario dell'agente. Un agente a cui è stato chiesto in chat di eseguire un lavoro ricorrente può creare la pianificazione in questo modo.

Controlla anche: Riferimento CLI, Agenti ospitati.