Agendamento de Tarefas
O sistema de agendamento do Claude Scheduler permite automatizar completamente suas tarefas de IA usando expressões cron. Execute prompts em horários específicos, intervalos regulares ou em momentos estratégicos do seu negócio.
Visão Geral
O que são Expressões Cron?
Expressões cron são strings que definem quando uma tarefa deve ser executada. Elas consistem em 5 campos:
* * * * *
┬ ┬ ┬ ┬ ┬
│ │ │ │ │
│ │ │ │ └─── Dia da Semana (0-6, Domingo=0)
│ │ │ └───── Mês (1-12)
│ │ └─────── Dia do Mês (1-31)
│ └───────── Hora (0-23)
└─────────── Minuto (0-59)
Formato de Tarefa
{
"name": "Nome da Tarefa",
"description": "Descrição opcional",
"schedule": "0 9 * * 1-5",
"model": "anthropic/claude-3-haiku",
"prompt": "Seu prompt aqui",
"temperature": 0.7,
"max_tokens": 4096,
"enabled": true,
"notifications": {
"email": true,
"webhook": "https://seu-webhook.com/notify"
}
}Expressões Cron Comuns
Intervalos Regulares
A Cada Minuto
* * * * *
Caso de Uso: Monitoramento em tempo real, alertas críticos
{
"name": "Monitor Sistema Crítico",
"schedule": "* * * * *",
"model": "google/gemini-2.0-flash",
"prompt": "Verifique o status do sistema: {{system_status}}\nAlerte sobre anomalias."
}A Cada 5 Minutos
*/5 * * * *
Caso de Uso: Atualização de dashboards, verificação de APIs
{
"name": "Atualizar Dashboard Vendas",
"schedule": "*/5 * * * *",
"model": "anthropic/claude-3-haiku",
"prompt": "Resuma as vendas dos últimos 5 minutos:\n{{sales_data}}"
}A Cada 15 Minutos
*/15 * * * *
Caso de Uso: Análise de métricas, sincronização de dados
A Cada Hora
0 * * * *
Caso de Uso: Relatórios horários, backup de dados
{
"name": "Relatório Horário Atendimento",
"schedule": "0 * * * *",
"model": "anthropic/claude-3-sonnet",
"prompt": "Analise os tickets de atendimento da última hora:\n- Total de tickets: {{ticket_count}}\n- Tempo médio de resposta: {{avg_response_time}}\n- Satisfação do cliente: {{csat_score}}\n\nForneça insights e recomendações."
}Horários Específicos
Diariamente às 9h
0 9 * * *
Caso de Uso: Relatórios diários, resumos matinais
{
"name": "Briefing Diário Executivo",
"schedule": "0 9 * * *",
"model": "anthropic/claude-3-opus",
"prompt": "Crie um briefing executivo com:\n\n1. Principais notícias do setor\n2. Performance de ontem (vendas, tráfego, conversões)\n3. Prioridades do dia\n4. Alertas e ações necessárias\n\nDados: {{daily_metrics}}",
"temperature": 0.3
}Duas vezes ao dia (9h e 18h)
0 9,18 * * *
Caso de Uso: Sincronização de sistemas, relatórios matutinos e vespertinos
{
"name": "Sincronização CRM",
"schedule": "0 9,18 * * *",
"model": "anthropic/claude-3-haiku",
"prompt": "Analise novos leads do CRM e classifique por prioridade:\n{{crm_leads}}"
}Meio-dia
0 12 * * *
Caso de Uso: Lembrete de almoço, análise matinal
Final do expediente (18h)
0 18 * * *
Caso de Uso: Relatórios de fechamento, preparação para o dia seguinte
{
"name": "Resumo Fim do Dia",
"schedule": "0 18 * * *",
"model": "openai/gpt-4-turbo",
"prompt": "Analise o desempenho do dia:\n\n**Vendas:** {{sales}}\n**Novos Usuários:** {{new_users}}\n**Issues Resolvidos:** {{resolved_issues}}\n**Pendências:** {{pending_tasks}}\n\nCrie um relatório executivo e liste as top 3 prioridades para amanhã.",
"temperature": 0.2
}Dias Específicos da Semana
Dias Úteis (Segunda a Sexta)
0 9 * * 1-5
Caso de Uso: Tarefas corporativas, relatórios de negócios
{
"name": "Análise Competitiva Diária",
"schedule": "0 9 * * 1-5",
"model": "google/gemini-2.5-pro",
"prompt": "Analise as atividades dos concorrentes nas últimas 24h:\n\n{{competitor_data}}\n\nIdentifique:\n1. Novos produtos/features\n2. Mudanças de preço\n3. Campanhas de marketing\n4. Menções nas redes sociais\n\nSugestões estratégicas para nossa empresa.",
"temperature": 0.4
}Apenas Segunda-feira
0 9 * * 1
Caso de Uso: Planejamento semanal, reuniões de início de semana
{
"name": "Planejamento Semanal",
"schedule": "0 9 * * 1",
"model": "anthropic/claude-3-opus",
"prompt": "Crie o planejamento da semana baseado em:\n\n**Objetivos do Trimestre:** {{quarter_goals}}\n**Progresso Atual:** {{current_progress}}\n**Recursos Disponíveis:** {{available_resources}}\n**Deadlines:** {{upcoming_deadlines}}\n\nForneça:\n1. Prioridades da semana\n2. Alocação de recursos\n3. Riscos e mitigações\n4. Checklist de tarefas",
"temperature": 0.3
}Apenas Sexta-feira
0 15 * * 5
Caso de Uso: Relatórios semanais, retrospectivas
{
"name": "Retrospectiva Semanal",
"schedule": "0 15 * * 5",
"model": "openai/gpt-4-turbo",
"prompt": "Analise a semana que passou:\n\n{{weekly_data}}\n\nCrie uma retrospectiva com:\n- O que deu certo (vitórias)\n- O que pode melhorar (desafios)\n- Aprendizados da semana\n- Action items para próxima semana",
"temperature": 0.5
}Finais de Semana (Sábado e Domingo)
0 10 * * 6,0
Caso de Uso: Manutenção de sistemas, análises aprofundadas
Datas Específicas do Mês
Primeiro dia do mês (9h)
0 9 1 * *
Caso de Uso: Relatórios mensais, fechamento financeiro
{
"name": "Relatório Financeiro Mensal",
"schedule": "0 9 1 * *",
"model": "openai/gpt-4-turbo",
"prompt": "Analise o desempenho financeiro do mês anterior:\n\n**Receita:** {{monthly_revenue}}\n**Despesas:** {{monthly_expenses}}\n**Lucro:** {{monthly_profit}}\n**MRR:** {{mrr}}\n**Churn:** {{churn_rate}}\n**CAC:** {{cac}}\n**LTV:** {{ltv}}\n\nForneça:\n1. Análise de tendências\n2. Comparação com meses anteriores\n3. Projeções para o próximo mês\n4. Recomendações estratégicas",
"temperature": 0.2
}Dia 15 de cada mês
0 9 15 * *
Caso de Uso: Revisão de meio de mês, ajustes de metas
Último dia do mês (23h)
0 23 28-31 * *
Caso de Uso: Preparação para fechamento mensal
{
"name": "Preparação Fechamento Mensal",
"schedule": "0 23 28-31 * *",
"model": "anthropic/claude-3-sonnet",
"prompt": "Prepare o checklist para fechamento mensal:\n\n- Verificar todas as transações pendentes\n- Reconciliar contas\n- Gerar relatórios preliminares\n- Identificar pendências\n\nDados atuais: {{month_data}}"
}Agendamentos Complexos
Segunda, Quarta e Sexta às 10h
0 10 * * 1,3,5
Caso de Uso: Publicação de conteúdo, newsletter
{
"name": "Publicar Post Blog",
"schedule": "0 10 * * 1,3,5",
"model": "meta-llama/llama-3.1-70b-instruct",
"prompt": "Crie um post de blog sobre {{topic}} seguindo nosso guia de estilo:\n\n**Tom:** {{brand_tone}}\n**Comprimento:** 800-1200 palavras\n**SEO Keywords:** {{keywords}}\n**CTA:** {{call_to_action}}\n\nIncluir:\n- Introdução engajante\n- 3-5 seções principais\n- Exemplos práticos\n- Conclusão com CTA",
"temperature": 0.8
}Horário de negócios (9h-18h) a cada hora
0 9-18 * * 1-5
Caso de Uso: Monitoramento durante expediente
A cada 30 minutos durante horário comercial
0,30 9-18 * * 1-5
Caso de Uso: Atualizações frequentes de dados críticos
Casos de Uso Práticos
1. E-commerce
Monitoramento de Estoque
{
"name": "Alerta Estoque Baixo",
"schedule": "0 */6 * * *", // A cada 6 horas
"model": "anthropic/claude-3-haiku",
"prompt": "Analise o estoque atual:\n{{inventory_data}}\n\nIdentifique produtos com estoque baixo (<10 unidades) e gere alertas de reposição.",
"notifications": {
"email": true,
"priority": "high"
}
}Análise de Concorrência
{
"name": "Price Monitoring Competidores",
"schedule": "0 8,20 * * *", // 8h e 20h
"model": "google/gemini-2.0-flash",
"prompt": "Compare nossos preços com concorrentes:\n{{competitor_prices}}\n\nIdentifique oportunidades de ajuste de preço.",
"temperature": 0.2
}2. Marketing e Redes Sociais
Geração de Conteúdo
{
"name": "Criar Posts Redes Sociais",
"schedule": "0 7 * * *", // 7h diariamente
"model": "anthropic/claude-3-sonnet",
"prompt": "Crie 3 posts para redes sociais sobre:\n\nTópico: {{daily_topic}}\nTom: {{brand_voice}}\nHashtags: {{relevant_hashtags}}\n\nFormatos:\n1. LinkedIn (profissional)\n2. Instagram (visual)\n3. Twitter/X (conciso)",
"temperature": 0.8
}Análise de Sentimento
{
"name": "Monitor Menções Marca",
"schedule": "*/30 * * * *", // A cada 30 min
"model": "anthropic/claude-3-haiku",
"prompt": "Analise menções da nossa marca:\n{{social_mentions}}\n\nClassifique sentimento e identifique menções urgentes que precisam de resposta.",
"notifications": {
"webhook": "https://api.slack.com/webhook/alerts"
}
}3. Atendimento ao Cliente
Classificação de Tickets
{
"name": "Triagem Tickets Suporte",
"schedule": "*/10 * * * *", // A cada 10 min
"model": "anthropic/claude-3-haiku",
"prompt": "Classifique estes tickets de suporte:\n{{new_tickets}}\n\nCategorias: Técnico, Financeiro, Vendas, Geral\nPrioridade: Urgente, Alta, Normal, Baixa\n\nRetorne JSON com classificações.",
"temperature": 0.1
}Respostas Automatizadas
{
"name": "Responder FAQ Comum",
"schedule": "*/5 * * * *", // A cada 5 min
"model": "anthropic/claude-3-sonnet",
"prompt": "Para tickets classificados como FAQ:\n{{faq_tickets}}\n\nGere respostas personalizadas mas seguindo nossos templates:\n{{faq_templates}}",
"temperature": 0.4
}4. Análise de Dados e BI
Relatório Executivo Diário
{
"name": "Dashboard Executivo",
"schedule": "0 8 * * 1-5", // 8h dias úteis
"model": "openai/gpt-4-turbo",
"prompt": "Crie dashboard executivo com:\n\n**KPIs Principais:**\n{{kpis}}\n\n**Análise:**\n1. Tendências (comparação com semana anterior)\n2. Desvios significativos\n3. Insights acionáveis\n4. Recomendações\n\nFormato: Executivo, máximo 1 página",
"temperature": 0.2,
"notifications": {
"email": ["ceo@empresa.com", "cfo@empresa.com"]
}
}Detecção de Anomalias
{
"name": "Detector Anomalias",
"schedule": "*/15 * * * *", // A cada 15 min
"model": "google/gemini-2.0-flash",
"prompt": "Analise métricas em tempo real:\n{{realtime_metrics}}\n\nDetecte anomalias baseado em:\n- Padrões históricos\n- Sazonalidade\n- Threshold definidos\n\nAlerte apenas sobre anomalias significativas (>2 desvios padrão).",
"temperature": 0.1
}Gerenciamento de Tarefas
Criar Nova Tarefa
// Via Dashboard
1. Acesse "Tasks" no menu lateral
2. Clique em "New Task"
3. Preencha o formulário:
- Nome e descrição
- Expressão cron (use o visual editor)
- Modelo AI
- Prompt e parâmetros
4. Configure notificações
5. Clique em "Create Task"
// Via API
POST /api/tasks
{
"name": "Minha Tarefa",
"schedule": "0 9 * * *",
"model": "anthropic/claude-3-haiku",
"prompt": "Seu prompt",
"enabled": true
}Editar Tarefa Existente
// Pausa temporária
PATCH /api/tasks/:id
{ "enabled": false }
// Alterar schedule
PATCH /api/tasks/:id
{ "schedule": "0 12 * * *" }
// Atualizar prompt
PATCH /api/tasks/:id
{ "prompt": "Novo prompt atualizado" }Executar Manualmente
// Teste imediato (não afeta schedule)
POST /api/tasks/:id/run
{
"test_mode": true,
"override_params": {
"temperature": 0.5
}
}Recursos Avançados
Variáveis Dinâmicas
Use variáveis no seu prompt que são substituídas em tempo de execução:
{
"prompt": "Analise as vendas de {{current_date}} para região {{region}}",
"variables": {
"current_date": "{{date:YYYY-MM-DD}}",
"region": "{{env:REGION}}"
}
}Variáveis Disponíveis:
{{date:FORMAT}}- Data atual em qualquer formato{{time:FORMAT}}- Hora atual{{env:VAR_NAME}}- Variável de ambiente{{random:MIN-MAX}}- Número aleatório{{uuid}}- UUID único
Condições de Execução
Execute apenas se condições forem atendidas:
{
"schedule": "0 9 * * *",
"conditions": {
"day_of_week": ["monday", "friday"],
"api_check": "https://api.example.com/status",
"expected_status": 200
}
}Chains (Tarefas Encadeadas)
Execute múltiplas tarefas em sequência:
{
"name": "Pipeline Análise Completa",
"schedule": "0 9 * * 1",
"chain": [
{
"step": 1,
"task_id": "collect-data",
"wait_for_completion": true
},
{
"step": 2,
"task_id": "analyze-data",
"input_from_step": 1
},
{
"step": 3,
"task_id": "generate-report",
"input_from_step": 2
}
]
}Visual Cron Editor
Nossa interface oferece um editor visual de expressões cron:
Modo Simples
- Selecione intervalos predefinidos
- Escolha dias da semana
- Defina horários específicos
Modo Avançado
- Editor de texto com syntax highlighting
- Validação em tempo real
- Preview das próximas 10 execuções
- Tradução da expressão em linguagem natural
Exemplo:
Expressão: 0 9 * * 1-5
Tradução: "Todos os dias úteis (Segunda a Sexta) às 9:00 AM"
Próximas execuções:
- 2025-01-20 09:00:00
- 2025-01-21 09:00:00
- 2025-01-22 09:00:00
...
Monitoramento e Logs
Histórico de Execuções
Visualize todas as execuções em Tasks > Executions:
- Status (sucesso, falha, timeout)
- Duração da execução
- Tokens consumidos
- Custo da execução
- Output completo da AI
Alertas de Falha
Configure notificações automáticas para falhas:
{
"alerts": {
"on_failure": {
"email": true,
"slack": true,
"retry_policy": {
"max_retries": 3,
"retry_delay": "5m"
}
}
}
}Limites e Boas Práticas
Limites por Plano
| Plano | Tarefas Ativas | Execuções/Mês | Frequência Mínima |
|---|---|---|---|
| Free | 3 | 100 | 5 minutos |
| Pro | 50 | 10,000 | 1 minuto |
| Business | Ilimitado | Ilimitado | Sem limite |
Boas Práticas
-
Evite Over-scheduling
- Não agende tarefas mais frequentemente do que necessário
- Use intervalos apropriados para cada caso de uso
-
Otimize Prompts
- Prompts concisos consomem menos tokens
- Use o modelo mais barato que atende suas necessidades
-
Configure Timeouts
- Defina timeouts adequados para evitar execuções travadas
- Timeout padrão: 60 segundos
-
Use Variáveis
- Reutilize tarefas com variáveis dinâmicas
- Evite duplicação de tarefas similares
-
Monitore Custos
- Ative alertas de budget
- Revise regularmente tarefas com alto custo
Recursos Relacionados
- Catálogo de Modelos AI - Escolha o modelo ideal
- Notificações - Configure alertas de execução
- Execuções - Analise histórico e performance
- API Reference - Integração programática
Ferramentas Úteis
Geradores de Cron
- Crontab Guru - Valide e teste expressões
- Visual Editor integrado no dashboard
Templates Prontos
Acesse nossa biblioteca de templates em Tasks > Templates:
- Marketing e redes sociais (15 templates)
- E-commerce e vendas (12 templates)
- Atendimento ao cliente (10 templates)
- Análise de dados (8 templates)
- DevOps e monitoramento (7 templates)
Próximos Passos: Crie sua primeira tarefa agendada em Dashboard > New Task!