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

# Agendamentos do contexto

> Rode a correspondência automaticamente adicionando a um contexto agendamentos de conciliação baseados em cron, na aba Agendamentos de conciliação do módulo Matcher.

Use a aba **Agendamentos de conciliação** de um contexto no módulo Matcher do Lerian Console para rodar a correspondência automaticamente. Cada agendamento de conciliação define quando o Matcher roda a correspondência para o contexto.

> [!NOTE]
>
> Os agendamentos de conciliação definem quando a correspondência automática roda. Eles não buscam dados. Para agendar quando uma fonte busca dados, use os [agendamentos de ingestão](https://docs.lerian.studio/pt/products/matcher/ui/context-sources.md#managing-ingestion-schedules) da fonte.

## Acessando os agendamentos

***

**Step 1**

Na barra lateral do Matcher, vá para **Configurar → Contextos**.

**Step 2**

Clique no nome de um contexto para abrir a página dele.

**Step 3**

Selecione a aba **Agendamentos de conciliação**.

> [!NOTE]
>
> A correspondência agendada roda apenas enquanto o contexto está **Ativo**.

## Lista de agendamentos

***

A aba lista os agendamentos de conciliação do contexto. Cada linha mostra:

* A expressão cron
* Um selo **Ativado** ou **Desativado**
* Os horários de **Última rodada** e **Próxima rodada** em UTC. Um horário vazio mostra `—`
* Um botão de edição (lápis) e um botão de exclusão (lixeira)

## Criando um agendamento

***

**Step 1**

Na aba **Agendamentos de conciliação**, clique em **Adicionar agendamento de casamento**. O painel lateral **Adicionar agendamento de casamento** abre.

**Step 2**

Digite o agendamento em **Expressão cron (UTC)**, com até 100 caracteres. O placeholder é `0 2 * * *`.

Conforme você digita, uma prévia aparece abaixo do campo. Uma expressão comum mostra uma frase como "Executa todos os dias às 02:00 (UTC)". Uma expressão incomum mostra uma frase gerada ou "Agendamento personalizado". Uma expressão com o formato errado mostra "Agendamentos de casamento usam uma expressão cron de 5 campos, como 0 2 \* \* \*."

A prévia não bloqueia **Salvar**. O Matcher verifica a expressão quando você salva.

**Step 3**

Deixe o toggle **Ativado** ligado para criar um agendamento ativo. Desligue-o para criar um agendamento desabilitado. Um agendamento desabilitado não tem horário de próxima execução, então ele não roda.

**Step 4**

Clique em **Salvar**.

> [accordion] Como escrever uma expressão de agendamento
>
> O Matcher lê uma **expressão cron** em UTC. Ela tem cinco campos, separados por espaços: `minute hour day-of-month month day-of-week`.
>
> | Campo | Intervalo |
> | - | - |
> | Minuto | `0–59` |
> | Hora | `0–23` |
> | Dia do mês | `1–31` |
> | Mês | `1–12` |
> | Dia da semana | `0–7` (0 e 7 são domingo) |
>
> Caracteres especiais:
>
> * `*`: qualquer valor
> * `,`: uma lista de valores, como `1,15,30`
> * `-`: um intervalo, como `9-17`
> * `/`: um passo, como `*/15` para cada 15 unidades
>
> Exemplos:
>
> * `0 6 * * *`: todos os dias às 06:00 UTC
> * `*/15 * * * *`: a cada 15 minutos
> * `0 9 * * 1-5`: às 09:00 UTC nos dias de semana
>
> O Matcher não aceita `@every` nem outras macros nomeadas. Quando você restringe tanto o dia do mês quanto o dia da semana, uma coincidência em qualquer um dos dois campos dispara o agendamento. Use um intervalo de cinco minutos ou mais. O Matcher recusa `* * * * *` e `*/2 * * * *`.

## Editando um agendamento

***

Clique no botão de lápis na linha de um agendamento. O painel lateral **Editar agendamento de casamento** abre com os valores atuais de **Expressão cron (UTC)** e **Ativado**. Mude os campos e clique em **Salvar**. Para um agendamento habilitado, o Matcher calcula a **Próxima rodada** de novo a partir do horário UTC atual. Quando você desabilita um agendamento, ele perde o horário de próxima execução.

## Excluindo um agendamento

***

Clique no botão de lixeira na linha de um agendamento. Uma caixa de diálogo identifica o agendamento e pede que você confirme. Clique em **Confirmar**.

> [!WARNING]
>
> Você não pode desfazer uma exclusão. O agendamento não roda de novo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.