Agendamentos

Um agendamento roda uma tarefa automaticamente num ambiente, numa recorrência definida por expressão cron. Cada tarefa tem no máximo um agendamento por ambiente.

Configurar

Com a tarefa e o ambiente selecionados na barra superior, use Configurar agendamento, na lateral das execuções, e escolha a frequência. O agendamento vale para o ambiente selecionado.

Frequência	Exemplo
Sob demanda	sem agendamento
A cada X horas	a cada 4 horas, no minuto 15
Diariamente	todo dia às 09:00
Dias úteis (seg–sex)	de segunda a sexta às 09:00
Semanal	toda segunda às 09:00
Mensal	todo dia 5 às 09:00
Custom (expressão cron)	0 9 * * 1-5

:::caution Horários em UTC O agendamento criado pelo console usa horários em UTC. 09:00 UTC são 06:00 em Brasília. Um agendamento declarado no repositório pode ter outro fuso (timezone: America/Sao_Paulo). :::

Acompanhar

Configurações → Agendamentos lista todos os agendamentos da organização: tarefa, ambiente, recorrência e status (Ativo ou Pausado). Daqui dá para:

• Pausar e Retomar, sem perder a configuração;
• Cancelar agendamento, que remove o agendamento. Para voltar a agendar, configure de novo na tarefa.

Regras

• Não empilha. Se a tarefa já tem uma execução ativa ou na fila no horário agendado, aquele disparo é pulado. Um cron mais curto do que a duração da tarefa perde disparos.
• Secrets antes do horário. O agendamento roda com os secrets do ambiente. Cadastre o valor de um secret novo antes do próximo horário.
• Plano e teto. Sem plano ou com o teto mensal atingido, o agendamento não dispara (e os webhooks recebem o evento correspondente). Um disparo pulado não é refeito.

Agendamentos declarados no repositório

Uma skill pode declarar os próprios agendamentos (task.schedules). Nesse caso, o repositório é a fonte de verdade: a recorrência e o fuso voltam ao declarado no próximo push se forem editados aqui. A pausa feita aqui continua valendo enquanto a skill não declarar paused. Ver Agendamento, endpoint e executor.

Pela API: /v1/schedules.