Pular para o conteúdo principal
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 ou chame a API de Completions. Nesta seção os exemplos usam o Workflow Contract routing da seção de Workflow: 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

​
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. 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.
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

​
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.
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

Campos, frequências, fuso horário, quem pode ver e as entradas de cada execução

Gerenciando agendas e histórico

Status, pausar, editar, excluir e o que fazer quando uma execução falha