Documentação

Agendas

Execute tarefas de forma recorrente e acompanhe os resultados gerados pela agenda.

Uma programação executa tarefas de forma recorrente sem que alguém precise solicitá-las. Encontre-as na fábrica em Automações e crie-as em Novo trabalho como uma automação programada para rodar a cada poucas horas, diariamente, semanalmente ou mensalmente.

Para que servem as agendas?

Manutenções recorrentes fáceis de acordar e fáceis de esquecer:

  • Atualizações de dependências
  • Tarefas de limpeza que se acumulam — código morto, flags obsoletas, exportações não utilizadas
  • Relatórios periódicos
  • Verificações periódicas contra um padrão que você adotou

A característica comum é que a tarefa está bem definida com antecedência. Uma agenda não pode decidir o que vale a pena fazer; ela apenas repete uma instrução que você já escreveu.

Para que elas não são adequadas?

Qualquer coisa que exija julgamento sobre prioridade. Uma agenda que abre tarefas toda segunda-feira, independentemente do que estiver acontecendo, competirá pelos mesmos slots de agente que as tarefas que você planejou.

O trabalho agendado consome capacidade real.

Isso é o que você deve internalizar antes de criar várias agendas.

Uma tarefa agendada é uma tarefa comum. Ela entra na fila, ocupa um slot de agente e consome recursos do modelo. Três agendas diárias em um plano de um slot podem impedir tudo o que você pretendia fazer.

Histórico de execução

Cada agenda mantém um histórico de execuções e dos resultados obtidos. Verifique-o ocasionalmente — o modo de falha de uma automação não é uma quebra grave, mas a produção silenciosa de nada útil durante meses, enquanto consome orçamento.

Se uma agenda abriu doze pull requests e nenhum deles foi mesclado, a agenda está incorreta.

Agendas e automações de eventos

Duas maneiras pelas quais o trabalho começa sem intervenção humana:

AutomaçãoDisparado por
AgendaHorário
Automação de eventoAlgo que acontece, como a abertura de um pull request ou a falha em uma verificação
  • AgendarHorário
  • Automação de eventosAlgo acontece.

Uma tarefa comum

Especificação, plano, construção, verificação, revisão. Usa um slot de agente; atribua-lhe prioridade menor.

P2P3

Um pull request

Ele não pode fazer merge nem commit na sua branch base.

Você aprova

A automação difere apenas no seu gatilho. O que ela abre é uma tarefa comum no caminho normal, portanto usa capacidade real e resulta em um pull request que você aprova.

Use uma agenda quando o gatilho for realmente o horário, ou quando o sistema monitorado não envia eventos Coroid, como Sentry ou Jira: a agenda solicita essas informações por meio dos servidores MCP. Se o que você quer dizer é "quando isso acontecer" e Coroid ou GitHub enviarem esse evento, use uma automação de evento. Assim, haverá menos trabalho desnecessário.

O trabalho também começa a partir de seus próprios sistemas e agentes, de automações de eventos e de resultados de qualidade. Veja Formas de iniciar o trabalho.