Pular para o conteúdo principal

Tarefas agendadas

Tarefas agendadas permitem que o agente execute ações automaticamente em horários definidos — sem precisar abrir o chat.

Casos de uso

  • Relatório diário de métricas todas as manhãs
  • Verificação de uptime a cada 5 minutos
  • Backup automático de banco de dados semanalmente
  • Análise de logs e alertas por e-mail
  • Deploy automático em staging toda sexta à noite

Criando uma tarefa

  1. No menu lateral, clique em Tarefas Agendadas
  2. Clique em Nova Tarefa
  3. Preencha:
    • Nome — identificação da tarefa
    • Horário (cron) — expressão cron ou preset
    • Prompt — instrução que o agente vai receber
    • Ambiente — onde executar
    • Projeto — contexto do projeto (opcional)
    • Agente — agente especializado (opcional)
    • Modo de permissão — recomendado: Autônomo para tarefas sem supervisão
  4. Clique em Salvar

Expressões cron

ExpressãoSignificado
*/5 * * * *A cada 5 minutos
0 * * * *A cada hora
0 9 * * *Todo dia às 9h
0 18 * * *Todo dia às 18h
0 8 * * 1Toda segunda-feira às 8h
0 0 1 * *Primeiro dia do mês à meia-noite

Exemplos de prompts para tarefas

Relatório diário de build

Verifique o status do build mais recente no GitHub Actions.
Se houver falhas, liste os erros e crie uma issue no repositório.
Se estiver tudo ok, registre no arquivo logs/build-status.log.

Monitoramento de uptime

Faça uma requisição GET para https://minha-api.com/health.
Se retornar status diferente de 200, envie um webhook de alerta para a URL do Slack configurada.

Limpeza semanal de logs

No servidor de produção, remova arquivos de log com mais de 30 dias em /var/log/app/.
Liste quantos arquivos foram removidos e o espaço liberado.

Acompanhando execuções

Cada tarefa registra:

  • Último status — sucesso, falha, em execução
  • Última execução — data e hora
  • Próxima execução — quando vai rodar novamente
  • Sessão gerada — link para a conversa que foi criada na execução

Clique na execução para ver a sessão completa — incluindo todas as ferramentas usadas e o resultado.

Pausando e reativando

Cada tarefa tem um toggle de ativo/pausado. Desative temporariamente sem precisar deletar.

Cuidado com o modo de permissão

Tarefas agendadas rodam sem supervisão. Use o modo Autônomo com cuidado em ambientes de produção — certifique-se que o prompt é bem definido e não pode causar ações destrutivas acidentais.