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

# Visão geral das Agendas

> Execute um Canvas, Workflow ou Agente publicado sozinho, de forma recorrente ou uma única vez

Uma **Agenda** inicia uma execução para você no horário que você escolher. Em vez de alguém clicar em **Executar** ou do seu sistema chamar a API, o Tela executa um Canvas, Workflow ou Agente publicado todo dia, toda segunda às 9h, no dia 1º do mês ou uma única vez em uma data que você definir.

Use uma agenda quando o trabalho segue o calendário e as entradas são sempre as mesmas: um relatório semanal, uma checagem noturna, uma execução antes de um prazo. Se as entradas mudam a cada execução, crie [tarefas em um App](https://docs.tela.com/pt/workstation/workstation.md) ou chame a [API de Completions](https://docs.tela.com/pt/completion-api/overview.md).

Nesta seção os exemplos usam o Workflow **Contract routing** da [seção de Workflow](https://docs.tela.com/pt/workflow/overview.md): uma agenda que o executa toda segunda às 09:00 com um contrato e um solicitante salvos na agenda.

![Página de Agendas com uma agenda recorrente e uma agenda única já concluída para o Workflow Contract routing](https://mintcdn.com/meistrari/M2w7BduKZAFA1Sbx/images/pt/schedules/list.png?fit=max\&auto=format\&n=M2w7BduKZAFA1Sbx\&q=85\&s=8e93e2996b10ceaf5f6baaad786ebe4c)

## O que executa

Uma agenda nunca executa o seu trabalho em andamento. Ela executa o que você publicou e consulta a versão no momento em que cada execução começa.

| Destino | Versão que executa |
| - | - |
| Canvas | A versão publicada em **Production** |
| Workflow | A versão publicada em **Production** |
| Agente | A versão publicada da branch principal |

Isso tem uma consequência importante: publicar uma nova versão muda o que **todas as agendas existentes** daquele Canvas, Workflow ou Agente executam a seguir. Um rascunho, uma versão antiga do histórico ou uma versão publicada só em outro ambiente nunca é agendada. Um destino sem versão em Production ou publicada nem aparece na lista.

> [!TIP]
>
> Antes de publicar algo que já tem agendas ativas, confira a página **Agendas** filtrando pelo destino. A próxima execução agendada vai usar a versão nova.

## Onde encontrar as agendas

* **Agendas** na barra lateral esquerda lista todas as agendas do Workspace e é onde você as cria.
* O menu `…` ao lado do título de um Canvas, Workflow ou Agente tem a opção **Agendar**, que abre o mesmo formulário com o destino já escolhido. Quando o destino ainda não foi publicado, o formulário pede que você publique primeiro.

![Menu … de um Workflow com a opção Agendar](https://mintcdn.com/meistrari/M2w7BduKZAFA1Sbx/images/pt/schedules/workflow-menu.png?fit=max\&auto=format\&n=M2w7BduKZAFA1Sbx\&q=85\&s=a29823da0c5782b78d3415500a5389f9)

## Como é uma execução

Cada vez que uma agenda dispara, o Tela cria uma execução normal do destino e a registra no **Histórico** da agenda. Você acompanha o resultado onde acompanha qualquer outra execução:

* Canvas e Workflow: em **Usage**, com a origem **Agenda**. A execução de um Workflow também aparece em **Debug**.
* Agente: como uma sessão em **Usage**.

Uma agenda só decide **quando uma execução começa**. Não existe espera ou atraso dentro de um Canvas, Workflow ou Agente. Um processo que precisa esperar horas ou dias por algo externo é montado como duas execuções: uma registra o que está pendente e uma agenda recorrente inicia outra que retoma o que ficou pronto.

> [!NOTE]
>
> Cada execução gasta créditos como uma execução iniciada à mão. Uma agenda que dispara a cada minuto gera muitas execuções, então escolha a menor frequência que resolve o trabalho.

## Nesta seção

> **[Criando uma agenda](https://docs.tela.com/pt/schedules/creating-schedules.md)**
>
> Campos, frequências, fuso horário, quem pode ver e as entradas de cada execução

> **[Gerenciando agendas e histórico](https://docs.tela.com/pt/schedules/managing-schedules.md)**
>
> Status, pausar, editar, excluir e o que fazer quando uma execução falha


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