Pular para o conteúdo

Automações

Ligue um acontecimento a uma cadeia de ações: horário, commit, agente que terminou, GitHub, GitLab ou uma chamada de webhook.

Ver Markdown

Uma automação liga um acontecimento a uma ação. Você diz quando ela dispara (um horário, um commit, um agente que terminou, um pull request, uma chamada de outro sistema) e o que ela faz (rodar um comando, mandar um pedido a um agente, abrir um agente novo no Canvas, gravar uma nota, mostrar uma notificação). O Elyra executa sozinho e guarda o que aconteceu para você ler depois.

Serve para o trabalho repetido que não precisa da sua presença: revisar o que abriu, rodar os testes a cada commit, avisar quando um agente ficou esperando você, reagir a um PR aberto no GitHub.

Onde encontrar

No menu do canto da janela, escolha Automações. A tela tem a lista à esquerda, agrupada por projeto, e o detalhe da automação selecionada à direita.

Automação selecionada: a frase que a descreve, a ordem do que acontece e o histórico com a execução concluída

A frase: quando, onde e o que

Toda automação se lê como uma frase:

Quando houver commit em meu-projeto, no meu-projeto, no main, rode um comando no terminal, e depois notifique “Commit no projeto”.

Parte da frase O que define
Quando… O gatilho. Veja Gatilhos
no (projeto) O projeto em que a automação trabalha
no (workspace) ou num novo workspace Onde as ações rodam: um workspace que já existe, ou um novo a cada execução
faça isto, e depois… A cadeia de ações, em ordem. Veja Ações

O que a tela mostra

  • A lista, com filtros Todas, Ligadas, Desligadas e Precisam de atenção, e uma busca por nome. Cada linha traz o gatilho, a primeira ação e quando foi a última execução.
  • O estado: ligada, desligada, rodando, falhou ou precisa de atenção. O interruptor no canto liga e desliga a automação.
  • Precisa de atenção aparece, por exemplo, quando uma automação por evento perdeu o gatilho ao ser salva por uma versão antiga do Elyra. Edite, escolha o gatilho de novo, e ela volta a rodar.
  • O que acontece, em ordem: o gatilho e cada ação, na sequência em que rodam.
  • O histórico: uma linha por execução, com status, “X de N ações” e o motivo quando não rodou. Veja Execuções e histórico.

O menu Mais ações (os três pontos) tem Executar agora, Duplicar e Excluir.

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

  • Ela roda com o Elyra aberto. Com o Elyra fechado no horário, a execução não acontece e não é feita depois; ela fica registrada no histórico como “não executada”. A exceção é o servidor sem janela do Elyra Cloud, que executa a cadeia sem precisar de janela (veja Webhook).
  • Ela pode executar um agente, mas também um comando simples. Quando há um agente, o pedido é texto em linguagem natural e o agente decide como cumpri-lo, com as ferramentas e permissões que ele tem.
  • Ela para na primeira falha. Se uma ação da cadeia falha, as seguintes não rodam.
  • 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. É no repositório dele que o trabalho acontece.

Desligar não é apagar

O interruptor desliga e liga a automação. Desligar interrompe as execuções e mantém tudo: o gatilho, as ações e o histórico. Apagar é outra operação, e é destrutiva (veja Editar e remover).

Linha de comando

Tudo isto também se faz pelo terminal, com elyra automations; os gatilhos, as ações e o webhook trazem os comandos de cada caso.

Próximos passos