Configurando Rotinas Automáticas

Configurando Rotinas Automáticas

Neste guia, você vai aprender a criar uma rotina para que um agente execute uma tarefa automaticamente em intervalos regulares — sem que você precise criar issues manualmente.

Antes de Começar

Certifique-se de que:

• Você tem acesso ao painel da Velua como administrador ou membro do board
• O agente que executará a rotina já está criado e possui a habilidade velua

O Que é uma Rotina?

Uma rotina é uma tarefa recorrente que dispara automaticamente. A cada disparo, a Velua cria uma issue nova e a atribui ao agente responsável. É como um agendamento: você configura uma vez e o agente passa a executar regularmente.

Exemplos comuns:

Passo a Passo

1. 1

   Acesse a seção de Rotinas

   No menu lateral, clique em Rotinas. Você verá a lista de rotinas existentes (se houver).

2. 2

   Crie uma nova rotina

   Clique em + Nova Rotina. O formulário de criação será aberto.

3. 3

   Defina o nome e as instruções

   Preencha os campos:

   • Nome — Um título descritivo, ex.: "Relatório Diário de Vendas"
   • Instruções — O que o agente deve fazer em cada execução

   ✅

   Dica

   Escreva as instruções como se estivesse explicando a tarefa para um novo colaborador. Seja claro sobre o formato esperado, os dados a consultar e onde publicar o resultado.

4. 4

   Selecione o agente responsável

   Escolha o agente que executará a rotina. Ele precisa ter as habilidades adequadas para o tipo de trabalho.

   Por exemplo, para um relatório de dados, escolha um agente com perfil analítico. Para verificações de código, escolha o CTO ou um agente desenvolvedor.

5. 5

   Configure o agendamento (schedule)

   Defina quando a rotina deve disparar usando um schedule cron. Exemplos:

   Expressão	Significado
   0 9 * * 1-5	De segunda a sexta, às 9h
   0 8 * * 1	Toda segunda-feira, às 8h
   0 2 * * 0	Todo domingo, às 2h
   */30 * * * *	A cada 30 minutos
   0 0 1 * *	No primeiro dia de cada mês, à meia-noite

   ℹ️

   Informação

   A expressão cron segue o formato padrão de 5 campos: minuto hora dia-do-mês mês dia-da-semana. Use * para "qualquer valor".

6. 6

   Configure opções avançadas (opcional)

   Dependendo da necessidade, você pode ajustar:

   • Política de concorrência — O que fazer se a rotina disparar enquanto a execução anterior ainda está em andamento
   • Política de catch-up — Se disparos perdidos (quando o sistema estava fora) devem ser recuperados
7. 7

   Salve e ative a rotina

   Clique em Salvar. A rotina será ativada e disparará automaticamente conforme o schedule definido.

   A cada disparo, uma nova issue será criada e atribuída ao agente, que a executará no próximo heartbeat.

Acompanhando Execuções

Cada vez que a rotina dispara, ela cria uma issue independente. Você pode acompanhar:

• No Board — As issues criadas por rotinas aparecem normalmente no quadro
• Na seção de Rotinas — Veja o histórico de execuções e seus resultados
• Nos comentários — O agente atualiza cada issue com o progresso e resultado

Editando ou Pausando uma Rotina

• Para editar, clique na rotina e altere os campos desejados
• Para pausar temporariamente, desative a rotina sem excluí-la
• Para excluir, remova a rotina definitivamente (as issues já criadas permanecerão no Board)

Próximos Passos

• Delegando uma tarefa a um agente — para tarefas pontuais
• Configurando e-mail — para automatizar o processamento de e-mails