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

# Administrar o catálogo de automações

> Cadastro de automações, parâmetros, modo desenvolvimento e a máquina de cada automação

Quem pode: só administradores. As ações desta página não aparecem para quem não é administrador.

## O que é uma automação no catálogo

Cada automação cadastrada representa um processo que a Dom Med automatiza, por exemplo "gerar ASO/FC a partir de PDF e subir no SGG". O cadastro define:

* **Nome, setor e descrição**: identificam a automação no catálogo.
* **Parâmetros**: quais dados a automação precisa para rodar, um a um (nome, tipo, descrição). É esse contrato que define o formulário que aparece para quem dispara uma execução.
* **Limite de execuções simultâneas**: quantas execuções dessa automação podem rodar ao mesmo tempo. O padrão é uma por vez; o valor certo depende de como aquela automação foi construída.

Um dos tipos de parâmetro possíveis (lista de clientes do SGG) ainda não pode ser usado: o cadastro aceita escolher esse tipo, mas a execução rejeita hoje.

## Modo desenvolvimento

Toda automação nasce em modo desenvolvimento, e isso não pode ser mudado na criação. Enquanto estiver nesse modo, ninguém consegue disparar nem rodar execuções para ela, mesmo que o cadastro esteja completo.

Isso existe de propósito: dá tempo de terminar a implantação da automação (a máquina dedicada, por exemplo) antes de liberar para uso real. Promover uma automação (tirá-la do modo desenvolvimento) e voltar a colocá-la em modo desenvolvimento são ações administrativas separadas, com botão próprio.

Uma automação só pode ser editada enquanto está em modo desenvolvimento. Para editar uma automação já promovida, é preciso voltar ao modo desenvolvimento primeiro.

## A máquina de cada automação

Cada automação tem exatamente uma máquina dedicada na nuvem. Ela fica **desligada por padrão** e liga automaticamente quando chega uma execução para processar.

O status "desligada" é o estado normal na maior parte do tempo, não é um alerta. Uma automação sem máquina registrada não consegue rodar execuções: o cadastro da automação e o registro da máquina são passos separados, e o segundo precisa acontecer antes que qualquer execução seja aceita.

Ao registrar a máquina, uma chave de acesso é gerada e exibida uma única vez. Ela precisa ser copiada e guardada nesse momento: depois, não é possível visualizá-la de novo. Se a chave for perdida ou vazar, hoje não existe um jeito de trocá-la sem desativar a automação e recriar o cadastro.

## Desativar uma automação

Desativar uma automação desliga a máquina de verdade e não tem volta: não existe reativação. Use com essa certeza.