Agendamentos
Rode o prompt de um agente todo dia útil, toda hora ou uma vez, no fuso horário e na conversa que você escolher.
Um agendamento dá um prompt a um agente em horários definidos, por exemplo, todo dia útil às 08:00 ou uma vez na próxima terça-feira. A cada horário, o agente recebe o prompt como um turno na conversa que você escolheu e responde lá.
Criar um agendamento
Abra Agendamentos na barra lateral esquerda e clique em Novo agendamento. O formulário pede:
| Campo | O que inserir |
|---|---|
| Nome | Um rótulo curto, como "Resumo matinal" |
| Agente | O agente que realiza o trabalho |
| Prompt | O que o agente deve fazer a cada vez, escrito como você escreveria no chat |
| Quando | Repete (cron), Repete (RRULE) ou Uma vez, com o horário abaixo |
| Fuso horário | Um fuso horário IANA, como Europe/Amsterdam |
| Responder em | Suas mensagens diretas com o agente, ou um dos seus canais |
Como escrever o horário:
- Cron tem cinco campos: minuto, hora, dia do mês, mês e dia da semana.
0 8 * * 1-5é dias úteis às 08:00. - RRULE usa o formato de calendário, por exemplo
FREQ=WEEKLY;BYDAY=MO,WE;BYHOUR=9;BYMINUTE=0. Laze o armazena como o cron correspondente. - Uma vez usa um horário local no fuso, como
2026-11-02T09:00. Um agendamento único é executado uma vez e depois é mostrado como concluído.
Um horário ou fuso horário inválido é recusado com schedule_invalid e nada é salvo.
Um agendamento repetitivo é executado no máximo a cada 30 minutos. Um cron ou RRULE cujas execuções são mais próximas, como */5 * * * *, é recusado com schedule_too_frequent; para trabalhos que devem seguir um evento, use um gatilho.
O que acontece quando um agendamento é executado
O agente posta "Execução agendada: Resumo matinal" (com o nome do agendamento) e o prompt na conversa que você escolheu, e sua resposta vai em uma thread sob essa mensagem. O prompt conta como uma mensagem da pessoa que criou o agendamento, então o agente trabalha com o acesso dessa pessoa ao vault.
Cada execução começa em uma nova sessão para um agente hospedado: ele tem as habilidades e arquivos de memória do agente, mas não seus chats anteriores, então realiza a tarefa a partir dos canais, arquivos e conexões a cada vez. Quando a execução termina, a sessão principal do agente recebe uma breve nota do que a execução fez. Uma execução que não encontra nada para fazer não posta nada.
Se o agente saiu desse canal, a execução não posta nada e não dá um turno ao agente. Se o agente foi removido, a execução é registrada como ignorada e o agendamento para.
Verificar primeiro, ativar apenas quando algo mudar
Um agendamento que consulta por alterações não precisa de um modelo a cada vez. Dê a ele um check: um script executável na pasta de trabalho do agente. A cada disparo, o script é executado no computador do agente, antes de qualquer chamada de modelo.
| O script | O que acontece |
|---|---|
| Sai com 0 e imprime algo | O agente acorda, e o que ele imprimiu é adicionado ao prompt |
| Sai com 0 e não imprime nada | Nada. A execução mostra como Nada de novo e nenhum crédito é gasto |
| Sai com um erro, ou executa por mais de 30 segundos | A verificação falhou. O agente permanece inativo e o agendamento aparece em Precisa de atenção |
Defina-o em Verificar primeiro no formulário, ou com laze schedule add ... --check checks/new-calls.sh. Apenas o agente ou seu proprietário pode definir ou alterar uma verificação, porque ela é executada com os arquivos do agente e o comando laze. Ela é executada fora de qualquer turno, então os comandos laze vault a recusam. Uma verificação que chama um modelo por si mesma paga por essa chamada. Agentes conectados de sua própria máquina não têm um computador Laze para executar uma verificação.
Mantenha o que o script viu pela última vez em um arquivo seu. Este exemplo ativa o agente quando um valor muda, e o turno do agente salva o novo valor:
#!/bin/sh
now=$(laze app records list picks --site published | sha256sum)
[ "$now" = "$(cat state/picks 2>/dev/null)" ] && exit 0
echo "picks changed: $now"Os primeiros 8000 caracteres da saída chegam ao agente, marcados como dados do script. Eles não são postados na conversa. Três falhas consecutivas enviam à pessoa que criou o agendamento um cartão no Feed. Executar agora executa a verificação primeiro, testando assim um script: ele ativa o agente somente se o script imprimir algo. Uma verificação ativa um computador inativo, que volta a inativar-se logo depois quando a verificação não encontra nada.
Se o que você monitora é um registro de aplicativo ou um canal, use um gatilho ou um monitor em vez disso: eles disparam na alteração e não precisam de um computador até então.
Fusos horários, horário de verão e tempo de inatividade
Os horários seguem o fuso horário do agendamento, incluindo o horário de verão:
- Quando os relógios avançam e o horário não existe naquele dia, o agendamento é executado uma vez, logo após a lacuna.
- Quando os relógios atrasam e o horário acontece duas vezes, o agendamento é executado uma vez, no primeiro.
- Se Laze estava inativo e perdeu execuções, o agendamento é executado uma vez quando Laze volta, e essa execução registra quantas foram perdidas. A próxima execução é então contada a partir de agora.
Pausar, editar e excluir um agendamento
Cada linha na página Agendamentos tem Executa, Editar, Pausar ou Retomar, e Excluir:
- Executa lista cada execução com seu horário e resultado.
- Pausar cancela a próxima execução. Retomar conta a próxima execução a partir de agora e não recupera o tempo pausado.
- Editar altera o nome, prompt, horário, fuso ou conversa. Um agendamento pausado permanece pausado após uma edição, e um agendamento único concluído é executado novamente se você lhe der um horário futuro.
- Excluir remove o agendamento; ele nunca mais será executado.
Qualquer pessoa que pode falar com o agente vê seus agendamentos e pode criá-los, editá-los, pausá-los, retomá-los e excluí-los: seu proprietário, as pessoas com quem é compartilhado e todos para um agente de equipe. A pessoa que pediu um agendamento também o mantém. Outras pessoas, incluindo administradores do workspace, não veem os agendamentos do agente; agendar um agente com o qual você não pode falar é recusado com schedule_agent_not_allowed.
Agendar pela linha de comando
Pessoas e agentes usam laze schedule. Forneça exatamente um de --cron, --rrule ou --at. Sem --tz, o fuso é 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>Executar agora e execuções que não aconteceram
Executar agora na linha de um agendamento, ou laze schedule run <scheduleId>, o executa uma vez imediatamente. O próximo disparo não se move.
Se um agendamento dispara enquanto seu agente não está conectado, foi removido ou sua conversa desapareceu, a pessoa para quem o agendamento é executado recebe um cartão em seu feed: Your scheduled run "<name>" did not run, com o motivo e um botão Executar agora. Outra perda do mesmo agendamento traz o mesmo cartão de volta.
Exemplo: um resumo matinal no feed
Um resumo matinal é um agendamento cujo prompt diz ao agente para postar cartões de feed como um grupo. O feed mostra o grupo mais recente sob a saudação, com um chip de filtro por rótulo.
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."Para um resumo maior, divida a leitura entre os scouts. Instale a habilidade brief-scout em cada agente scout e morning-brief no agente que escreve o resumo, depois agende os scouts antes do resumo. Cada scout envia seu relatório como briefs/<YYYY-MM-DD>/<scout>.md para o canal que o resumo lê, com a evidência de cada item. O agente do resumo lê esses arquivos, espera até 15 minutos por um atrasado, verifica cada item e posta os itens verificados como cartões no grupo. Um scout que não foi executado leva ao resumo, e seu proprietário também recebe o cartão de execução perdida com Executar agora.
Postar um cartão novamente com a mesma chave --loop o move para o novo grupo e mostra quantas vezes ele foi visto. --auto-send-on <YYYY-MM-DD> adiciona uma contagem regressiva com um botão Parar a qualquer cartão.
Quando um agente executa laze schedule add com sua própria chave, o agendamento mira esse agente e é contado como criado pelo proprietário do agente. Um agente solicitado no chat para trabalho recorrente pode criar o agendamento desta forma.
Veja também: Referência da CLI, Agentes hospedados.