# Automacao e Agendamento

Automatize seus agentes do Neotask com trabalhos agendados, modos de entrega flexiveis e direcionamento de sessao poderoso.

---

## Trabalhos Agendados (Cron)

Trabalhos agendados permitem automatizar acoes do agente em uma programacao recorrente ou unica. Defina quando um trabalho e executado, o que ele faz e para onde os resultados vao.

---

## Tipos de Agendamento

| Tipo | Formato | Exemplo |
|------|---------|---------|
| **Em** | Data/hora fixa | Executar uma vez em 28 de fev. de 2026 as 9:00 |
| **A cada** | Intervalo | Executar a cada 30 minutos |
| **Cron** | Expressao cron padrao | `0 9 * * 1-5` (dias uteis as 9h) |

### Suporte a Fuso Horario

- Todos os agendamentos respeitam o fuso horario configurado
- Expressoes cron suportam um parametro de fuso horario
- Opcao de defasagem disponivel para compensar horarios de execucao entre multiplos trabalhos

---

## Payloads de Trabalho

Cada trabalho agendado executa um payload -- a acao que o agente realiza quando o trabalho dispara.

| Tipo | Descricao |
|------|-----------|
| **Evento do Sistema** | Acionar um evento arbitrario (baseado em texto) |
| **Turno do Agente** | Enviar uma mensagem para um agente com uma substituicao de modelo opcional |

---

## Modos de Entrega

Controle para onde os resultados de um trabalho agendado sao enviados apos a execucao.

| Modo | Descricao |
|------|-----------|
| **Nenhum** | Execucao interna apenas -- nenhuma saida e entregue |
| **Anuncio** | Transmitir o resultado para um canal |
| **Webhook** | Enviar o resultado via POST para uma URL externa |

---

## Direcionamento de Sessao

Escolha como o contexto da conversa e tratado para cada trabalho agendado.

| Modo | Descricao |
|------|-----------|
| **Principal** | Sessao compartilhada -- historico de conversa acumulado entre execucoes |
| **Isolada** | Sessao nova por execucao -- tela limpa cada vez que o trabalho executa |

---

## Operacoes de Trabalho

O Neotask oferece controle total sobre o ciclo de vida dos seus trabalhos agendados:

- **Criar, atualizar e excluir** trabalhos a qualquer momento
- **Ativar ou desativar** um trabalho sem exclui-lo
- **Forcar execucao imediata** para ignorar o agendamento e executar sob demanda
- **Pular uma vez** para atrasar uma unica execucao e retomar automaticamente o agendamento normal
- **Ver historico completo de execucao** incluindo status, duracao e erros de cada execucao

---

## Exemplos de Automacao

Aqui estao algumas formas comuns de equipes usarem trabalhos agendados do Neotask:

### Resumo Matinal

- **Agendamento:** Diariamente as 8:00
- **O que faz:** O agente resume as ultimas noticias e envia um resumo para o Slack

### Relatorio Semanal

- **Agendamento:** Toda segunda-feira
- **O que faz:** O agente compila dados de analytics e envia um resumo por email para a equipe

### Sincronizacao de Dados

- **Agendamento:** A cada 4 horas
- **O que faz:** O agente verifica APIs externas e atualiza o painel com dados atualizados

### Verificacao de Saude

- **Agendamento:** A cada 15 minutos
- **O que faz:** O agente monitora servicos e envia alertas em caso de falha