Criando automações

Para criar uma automação, abra a aba Automations do seu projeto e clique em Create automation. O Buildprint abrirá o editor de automação, que guiará você por três etapas: nome, gatilho e ações.

Nome

Dê à automação um nome descritivo para que você possa identificá-la na lista. Bons nomes descrevem o que acontece e o porquê, por exemplo: "Executar testes de fumaça ao fazer deploy" ou "Notificar Slack na mesclagem de branch".

Escolhendo um gatilho

Selecione quando a automação deve ser acionada. O Buildprint suporta seis tipos de gatilhos:

• Manual / API — executado apenas quando você o enfileira sob demanda por meio da API REST pública do Buildprint, servidor MCP ou manualmente pela interface do usuário.

• Live deployed — acionado sempre que uma nova versão do seu app é implantada em produção (live).

• Branch merged — acionado quando uma branch é mesclada. Inclui as branches de origem e destino como parâmetros.

• Branch created — acionado quando uma nova branch é criada. Inclui a nova branch como parâmetro.

• Branch removed — acionado quando uma branch é excluída. Inclui a branch removida como parâmetro.

• Recurring — acionado com base em um cronograma. Escolha uma predefinição (a cada hora, todos os dias às 9h UTC, toda segunda-feira, todo domingo) ou insira uma expressão cron personalizada.

Expressões cron personalizadas

Se as predefinições não atenderem às suas necessidades, selecione Custom no menu suspenso de agendamento e insira uma expressão cron padrão (cinco campos: minuto, hora, dia-do-mês, mês, dia-da-semana). Você também pode digitar uma descrição como "every weekday at 3pm" (todos os dias úteis às 15h) e o Buildprint gerará a expressão para você.

Adicionando ações

Cada automação precisa de pelo menos uma ação. Clique em Add action para adicionar mais. As ações são executadas na ordem em que aparecem. Você pode escolher entre três tipos de ação:

• Run tests — executa testes individuais ou grupos de testes em uma branch específica.

• Deploy agent — executa um agente de IA com um prompt definido por você e encaminha a resposta final por e-mail, webhook ou Slack.

• Send webhook — envia um POST com carga útil JSON para uma URL externa.

Cada tipo de ação possui suas próprias opções de configuração, detalhadas no artigo de Actions.

Editando uma automação

Clique no ícone de menu em qualquer automação na lista e selecione Edit para reabrir o editor com a configuração atual. As alterações entram em vigor imediatamente após o salvamento.

Ativando e desativando

Use a alternância (toggle) na lista de automações para ativar ou desativar uma automação. Automações desativadas mantêm sua configuração, mas não serão acionadas. No caso de automações recorrentes, a desativação cancela a próxima execução agendada e a ativação a reagenda.

Excluindo uma automação

Para remover permanentemente uma automação da lista, clique no ícone de menu e selecione Delete. O Buildprint a arquiva nos bastidores, oculta-a da lista e interrompe execuções futuras. Esta ação não pode ser desfeita.