Agenda
Em Automações > Agenda fica tudo o que está programado para rodar na organização, de todos os grupos: os agendamentos de uma vez e as recorrências. A agenda mostra também o que já rodou, com o resultado, e o que deveria ter rodado e não rodou.
A Agenda exige que o plano tenha agendamento ou recorrência. Os horários aparecem no fuso do seu perfil.
Indicadores
| Indicador | O que conta |
|---|---|
| Hoje | As rodadas de hoje e quantas já rodaram. |
| Próximas 24 horas | O que está programado nas próximas 24 horas, com a próxima rodada. |
| Recorrências ativas | Quantas recorrências estão ativas, e quantas pausadas. |
| Últimos 7 dias | O que não rodou e o que falhou na última semana. |
Visões
| Visão | Para quê |
|---|---|
| Semana | A semana em grade de horas, com a linha de agora. Clique num horário vazio para agendar nele. |
| Mês | O mês inteiro. Um ícone de alerta marca o dia com falha ou com algo que não rodou. |
| Lista | De ontem até os próximos 14 dias, em lista. É a visão inicial no celular. |
| Por runner, no dia | Uma faixa de 24 horas por runner ou cluster, para ver sobreposições e horários livres. |
Os filtros escolhem o grupo, o runner ou cluster e o tipo (agendamentos ou recorrências), e mostram ou escondem as recorrências pausadas e os itens cancelados. As recorrências muito frequentes (a cada poucos minutos ou horas) aparecem resumidas por dia, como "N vezes".
O que cada item mostra
| Status | Quando |
|---|---|
| Programado | Vai rodar, ou está esperando o runner. |
| Rodando agora | Há execuções em andamento. |
| Passou | Nenhuma execução falhou. |
| Falhou | Nenhuma execução passou. |
| Com falhas | Parte passou e parte falhou, com a contagem (por exemplo, 34/38). |
| Não rodou | O lote não chegou a rodar. O motivo aparece no item. |
| Pausada | A recorrência está pausada, por uma pessoa ou pelo Proton. |
| Pulada | Esta vez da recorrência foi pulada. |
| Cancelado | O lote foi cancelado. Aparece só com o filtro de cancelados. |
Por que algo não rodou
- O runner estava fora do ar no horário e não voltou em 1 hora.
- Passou mais de 1 hora do horário e o lote não saiu.
- O runner ou o cluster não existe mais.
- O ciclo ou o grupo foi fechado.
- Os datasets do agendamento não existem mais.
- Quem agendou não está mais ativo na organização.
- O plano da organização não inclui mais o recurso.
Agendar
Agendar (ou um clique num horário vazio da semana) abre um assistente em cinco etapas:
- O que agendar: o grupo de automação. As execuções caem no ciclo aberto do grupo (com mais de um ciclo aberto, escolha o ciclo). Só aparecem grupos com ciclo aberto. Novo grupo abre o Centro de Automação em outra aba; ao voltar, o grupo novo já vem escolhido.
- O que vai rodar: as automações do grupo. Dá para ajustar os parâmetros, por dataset ou por parâmetro.
- Onde roda: o runner ou o cluster. Para automação mobile, também o aparelho e o app. Agendar num runner que está offline é permitido: ele precisa estar no ar na hora.
- Quando: Agendar, com a data e a hora, ou Recorrente, com a frequência.
- Código e ambiente: a branch de cada sistema (a padrão já vem escolhida), o ambiente e as opções de notificação e de reexecutar ao falhar.
Peça à IA
Com o módulo de IA, a primeira etapa traz Prefere descrever? Peça à IA: escreva o que rodar e quando, como "de segunda a sexta às 07:00, rodar o grupo Regressão". O assistente encontra as automações e o runner, mostra o resumo e só agenda depois do seu ok. Usa créditos de IA.
Recorrências
| Frequência | Como funciona |
|---|---|
| Minuto | A cada N minutos (1 a 59), contando a partir da rodada anterior. |
| Hora | A cada N horas (1 a 23), contando a partir da rodada anterior. |
| Diário | Todo dia, no horário escolhido. |
| Semanal | Nos dias escolhidos (há atalhos para dias úteis e fim de semana), no horário escolhido. |
| Mensal | Num dia do mês ou no último dia do mês. O mês que não tem o dia escolhido (como 31) é pulado. |
- A regra vale no fuso de quem criou a recorrência. Mudar o fuso do perfil depois não desloca o que já foi agendado.
- Cada rodada usa a branch e o ambiente escolhidos na recorrência.
- Se a rodada anterior ainda está em andamento, ou esperando o runner, a rodada da vez é pulada.
- Nada é retroativo: uma rodada perdida (por exemplo, com mais de 1 hora de atraso) não roda depois.
Pausa automática
O Proton pausa a recorrência quando ela não pode mais rodar: o plano não inclui mais recorrências, quem criou saiu da organização, o ciclo ou o grupo foi fechado, ou o runner ou o cluster foi removido. Resolva o motivo e use Retomar.
Uma recorrência criada por quem saiu da organização não volta a rodar: crie outra.
O runner na hora do agendamento
Se o runner está offline no horário, o lote espera. Se o runner voltar em até 1 hora, a execução roda atrasada; senão, o lote fica como Não rodou. Num cluster, basta um runner do cluster estar no ar.
Ações de cada item
Clicar num item abre os detalhes: quando, a duração prevista, onde roda, quem criou, a regra (na recorrência), as automações, as próximas vezes e as últimas rodadas.
| Ação | Onde | O que faz |
|---|---|---|
| Rodar agora | Recorrência ou agendamento | Roda uma vez agora, sem mudar a regra da recorrência. |
| Reagendar | Agendamento que ainda não saiu | Muda a data e a hora. |
| Pausar e Retomar | Recorrência | Para e volta a rodar. |
| Editar | Recorrência | A frequência, o runner, as branches, as automações, o ambiente e as opções. |
| Pular esta vez | Uma vez futura da recorrência | Pula só esta vez; depois aparece Desfazer o pulo. |
| Cancelar esta vez | Lote da recorrência que ainda não saiu | Cancela só este lote. |
| Excluir recorrência | Recorrência | As próximas vezes saem da agenda; o que já rodou fica no histórico. |
| Excluir agendamento | Agendamento que ainda não saiu | O agendamento sai da agenda e não roda. |
| Abrir o grupo no Centro de Automação | Qualquer item | Abre o grupo e o ciclo. |
Quando o runner ou o cluster de um item foi removido, o detalhe avisa: edite a recorrência e escolha outro runner, ou exclua o agendamento e agende de novo.
Permissões
Ver a Agenda exige ver o Centro de Automação; agendar e usar as ações exige executar no Centro de Automação. Agendar exige o recurso de agendamento no plano, e criar recorrência, o de recorrência.