---
id: "fluxos.automacoes"
titulo: "Automações agendadas"
resumo: "Crie pedidos que o Elyra executa sozinho no horário marcado e acompanhe o que cada rodada fez."
idioma: "pt-br"
tipo: "conceito"
categoria: "quadro"
aplicavelDesde: "0.0.16"
capabilities: ["automations.list", "automations.show"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/fluxos/automacoes/"
fonte: "pt-br/fluxos/automacoes.md"
caminhoPublico: "docs/publica/pt-br/fluxos/automacoes.md"
hashFonte: "sha256:0dce1681e48c538f43356c7a2be427c85bc08b60af5cefc60069918ae74b4082"
hashDestaPagina: "sha256:0dce1681e48c538f43356c7a2be427c85bc08b60af5cefc60069918ae74b4082"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
Uma **automação** é um pedido que roda sozinho no horário que você marcar. Você escreve o pedido como
escreveria numa conversa, escolhe com qual agente ele roda e de quanto em quanto tempo — e o Elyra
executa, guardando o que aconteceu para você ler depois.

Serve para o trabalho repetido que não precisa da sua presença: revisar o que abriu, resumir o que
mudou, triar o que chegou.

## Onde encontrar

No **menu do canto da janela** há a entrada **Automações**. A tela tem dois grupos:

| Grupo | O que é |
|---|---|
| **Suas rotinas** | As automações criadas aqui no Elyra |
| **Hosts externos** | Jobs que pertencem a outro sistema; veja [Automações de hosts externos](/docs/pt-br/fluxos/automacoes-externas/) |

## O que a lista mostra

Cada rotina informa:

- o **nome** e o **estado do ciclo de vida** — ligada, pausada, rodando, nunca executada, com erro;
- o **agendamento**, em forma legível;
- a **próxima execução**, quando existe ("próxima em 3 h", "próxima agora");
- o **projeto** em que ela trabalha, e o **agente** que ela usa.

Abrir uma rotina mostra o **detalhe**:

| Campo | O que diz |
|---|---|
| **Schedule** | O agendamento em forma legível |
| **Agent** | O agente que executa |
| **Source** | De onde vem a tarefa, quando a automação busca trabalho numa fonte |
| **Session** | Se as rodadas reaproveitam uma sessão ou começam do zero |
| **Grace** | Quanto tempo de atraso ainda conta como "na hora" |
| **Precheck** | O comando que decide se aquela rodada deve rodar |
| **Last run** | Quando foi a última execução |
| **Tokens** | O consumo acumulado |

E as ações: **Run Now** (executar agora), **Edit automation**, **Delete automation** e o interruptor de
pausar/retomar.

## O que uma automação é, e o que ela não é

- **Ela executa um agente**, não um script. O pedido é texto em linguagem natural, e o agente decide
  como cumpri-lo — com as ferramentas e as permissões que ele tem.
- **Ela guarda histórico.** Cada rodada fica registrada com status, workspace, consumo e tokens.
- **Ela não substitui supervisão.** O que ela faz acontece sem você olhando; leia o histórico antes de
  confiar nela para algo sensível.
- **Ela trabalha num projeto.** A rotina pertence a um projeto, e é no repositório dele que o trabalho
  acontece.

## Pausar não é apagar

O interruptor da rotina **pausa** e **retoma**. Pausar interrompe as execuções e **mantém tudo**: o
pedido, o agendamento e o histórico. É o que você quer na maioria das vezes — para parar sem perder
nada.

Apagar é outra operação, e é destrutiva.

## Escopo e limites

- **A tela lista as automações da instalação**, com os jobs externos em grupo separado.
- **Uma ação de automação por vez.** Enquanto uma operação está em andamento, a tela avisa que outra
  ainda está rodando, em vez de disparar duas em cima do mesmo estado.
- **Um id inexistente falha**, em vez de devolver uma automação vazia.

## Próximos passos

- [Criar uma automação](/docs/pt-br/fluxos/automacoes-criar/)
- [Execuções e histórico](/docs/pt-br/fluxos/automacoes-execucoes/)
- [Notificações do agente](/docs/pt-br/fluxos/notificacoes/)