> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dify.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Agendador

> Automatize tarefas recorrentes com ações agendadas dos agentes.

O Agendador permite configurar tarefas recorrentes que os agentes executam automaticamente. Crie relatórios diários, análises semanais, verificações periódicas e qualquer fluxo de trabalho automatizado.

## Como o Agendamento Funciona

As tarefas agendadas usam expressões CRON com BullMQ. Quando um agendamento é disparado:

1. O sistema cria uma nova thread de conversa
2. O agente designado recebe o prompt da tarefa
3. O agente executa usando suas ferramentas e conhecimento configurados
4. Os resultados são salvos e, opcionalmente, enviados para serviços conectados

## Criando um Agendamento

Você pode criar agendamentos diretamente na conversa:

> "Agende um relatório de análise de mercado toda segunda-feira às 9h"

Ou pela interface do Agendador:

<Steps>
  <Step title="Abra o Agendador">
    Navegue até a seção **Agendador** na barra lateral.
  </Step>

  <Step title="Crie um novo agendamento">
    Clique em **Novo Agendamento** e configure:

    <ParamField body="prompt" type="string" required>
      A instrução de tarefa que o agente executará a cada vez.
    </ParamField>

    <ParamField body="schedule" type="string" required>
      Expressão CRON (ex.: `0 9 * * 1` para toda segunda-feira às 9h).
    </ParamField>

    <ParamField body="agent" type="string" required>
      Qual agente deve executar esta tarefa.
    </ParamField>
  </Step>

  <Step title="Revise e ative">
    Revise a prévia do agendamento e clique em **Ativar**.
  </Step>
</Steps>

## Padrões CRON Comuns

| Padrão        | Agendamento                      |
| ------------- | -------------------------------- |
| `0 9 * * *`   | Todo dia às 9:00                 |
| `0 9 * * 1`   | Toda segunda-feira às 9:00       |
| `0 */6 * * *` | A cada 6 horas                   |
| `0 9 1 * *`   | Primeiro dia de cada mês às 9:00 |
| `0 9 * * 1-5` | Dias úteis às 9:00               |

## Gerenciando Agendamentos

* **Pausar** um agendamento sem excluí-lo
* **Editar** o prompt, o horário ou o agente designado
* **Ver histórico** de execuções e resultados anteriores
* **Excluir** agendamentos que não são mais necessários

## Histórico de Execuções

Cada execução é registrada com:

* Data/hora e duração
* Resposta do agente e artefatos gerados
* Status (sucesso, erro, timeout)

<Tip>
  Comece com agendamentos simples e itere. Você pode modificar o prompt e o horário a qualquer momento.
</Tip>