cron-manager

name	cron-manager
description	Gerencia jobs agendados do sistema Ravi. Use quando o usuário quiser: - Criar, listar ou deletar tarefas agendadas - Configurar cron expressions, intervalos ou horários específicos - Ativar/desativar jobs existentes - Executar jobs manualmente

Cron Manager

Você gerencia os jobs agendados do Ravi. Jobs são tarefas que rodam automaticamente em horários ou intervalos específicos.

Tipos de Schedule

Tipo	Exemplo	Descrição
--cron	"0 9 * * *"	Cron expression (todo dia 9h)
--every	30m, 1h, 2h30m	Intervalo fixo
--at	2025-02-01T15:00	Horário único (one-shot)

Comandos Disponíveis

Listar jobs

ravi cron list

Ver detalhes

ravi cron show <id>

Criar job

Com cron expression:

ravi cron add "Relatório Diário" --cron "0 9 * * *" --message "Gere o relatório diário"

Com intervalo:

ravi cron add "Check Emails" --every 30m --message "Verifique novos emails"

Shell direto, sem invocar agent/LLM:

ravi cron add "ETL" --cron "*/15 * * * *" --shell "python3 /home/ravi/job.py"

Shell com agent apenas em erro:

ravi cron add "ETL" \
  --cron "*/15 * * * *" \
  --shell "python3 /home/ravi/job.py" \
  --on-error notify-session:admin-group

One-shot (executa uma vez):

ravi cron add "Lembrete" --at "2025-02-01T15:00" --message "Lembrar de X" --delete-after

Opções:

• --agent <id> - Agent que executa
• --account <id> - Conta/canal usado para entrega quando o job responde em chat
• --tz <timezone> - Fuso horário (ex: America/Sao_Paulo)
• --isolated - Roda em sessão isolada
• --delete-after - Deleta após primeira execução
• --description <text> - Descrição do job
• --shell <cmd> / --exec <cmd> - Executa comando shell direto sem prompt LLM
• --timeout <seconds|duration> - Timeout para shell jobs, ex: 60, 30s, 10m
• --env-file <path> - Arquivo dotenv simples para shell jobs
• --on-error notify-session:<session> - Notifica sessão só quando shell job falhar
• --idempotency-key <key> - Reutiliza duravelmente a mesma criação em retries; a mesma key não pode representar outro job

Quando cron add roda dentro de um turn de observer com source turn id, Ravi deriva a idempotência automaticamente de rule + source turn + ação normalizada. Isso impede que replay/retry crie follow-ups duplicados, inclusive depois que um one-shot --delete-after já foi removido. Fora desse contexto, produtores automatizados devem passar uma --idempotency-key estável.

Depois de criar job que deve responder em um chat/sessão específica, sempre rode ravi cron show <id> e confira agent, account, session/reply-session antes de considerar pronto. Não confie no account herdado do contexto atual: se o cron entregar pelo account errado, o agent pode trabalhar e falhar no delivery com chat not found.

Para trabalho determinístico (ETL, scraping, sync, scripts idempotentes), prefira --shell em vez de pedir para um agent usar Bash. Isso mantém tracking em ravi cron list/show, evita custo de tokens em runs bem-sucedidos e só envolve agent quando houver --on-error.

Para jobs de monitoramento, faça o prompt comparar o estado atual com a última checagem e responder só quando houver mudança material. Não transforme o mesmo bloqueio em alerta a cada tick: se a causa, impacto e próximo passo continuam iguais, o job deve registrar localmente ou ficar silencioso. Se a repetição do bloqueio indicar risco novo, como retry infinito ou consumo inútil de tentativas, reporte esse risco como decisão operacional necessária em vez de recontar o mesmo erro.

Ativar/Desativar

ravi cron enable <id>
ravi cron disable <id>

Configurar propriedades

ravi cron set <id> <key> <value>

Keys: name, message, shell, exec, timeout, env-file, on-error, cron, every, tz, agent, account, description, session, reply-session, delete-after

Executar manualmente

ravi cron run <id>

Deletar

ravi cron rm <id>

Cron Expression Reference

┌───────────── minuto (0-59)
│ ┌───────────── hora (0-23)
│ │ ┌───────────── dia do mês (1-31)
│ │ │ ┌───────────── mês (1-12)
│ │ │ │ ┌───────────── dia da semana (0-6, 0=domingo)
│ │ │ │ │
* * * * *

Exemplos:

• 0 9 * * * - Todo dia às 9h
• 0 9 * * 1-5 - Dias úteis às 9h
• */15 * * * * - A cada 15 minutos
• 0 0 1 * * - Primeiro dia do mês à meia-noite
• 0 18 * * 5 - Toda sexta às 18h

Exemplos

Relatório semanal toda segunda:

ravi cron add "Weekly Report" --cron "0 9 * * 1" --message "Gere relatório semanal" --tz "America/Sao_Paulo"

Verificação a cada 2 horas:

ravi cron add "Health Check" --every 2h --message "Verifique status dos sistemas"

Lembrete único:

ravi cron add "Reunião" --at "2025-01-30T14:00" --message "Lembrar: reunião em 15min" --delete-after