Uma automação reage a algo que acontece no Coroid. Você escolhe um evento, escreve instruções em linguagem simples e a automação é executada quando o evento ocorre.
Encontre-as em Configurações → Automação → Automações.
Eventos nos quais você pode reagir
| Categoria | Exemplos |
|---|---|
| Tarefa | Criada, status alterado, fase alterada, concluída, falhou |
| Agente | Iniciado, iteração, ferramenta chamada, concluído, erro |
| Repositório | Commit enviado, ramificação criada, pull request aberto, pull request mesclado |
| Análise | Dependência encontrada, problema de segurança, análise concluída |
| Sincronização | Fonte externa atualizada |
| Implantação | Iniciada, concluída, falhou |
Somente leitura por padrão
As automações analisam e geram relatórios. Elas podem criar tarefas subsequentes; não modificam seu código diretamente.
Esse padrão é o que as torna seguras para adoção. Uma automação que edita código em resposta a um evento age no momento menos provável de ser supervisionada. Uma automação que abre uma tarefa produz o mesmo resultado pelo caminho normal — specificação, planejamento, verificação, revisão, pull request.
Escrevendo boas instruções
As instruções da automação são processadas por um modelo, portanto parecem instruções para um colega em vez de código. O padrão de qualidade é o mesmo de uma specificação: indique o que observar, o que importa e o que fazer.
Seja específico sobre o caso de "não fazer nada". Sem isso, uma automação encontrará algo para dizer toda vez que for executada, e automações que disparam constantemente são ignoradas pelas pessoas.
Proteções
Existem três proteções porque a automação baseada em eventos falha de maneiras previsíveis:
Limites de taxa. Por minuto, por hora e por dia, configuráveis por automação. Uma automação em um evento de alta frequência pode disparar centenas de vezes durante uma mesclagem movimentada.
Profundidade da cadeia. As automações podem disparar eventos que, por sua vez, disparam outras automações. Uma profundidade máxima da cadeia evita que isso se torne um loop.
Permissões de ferramenta. O que uma automação pode acessar é controlado — o acesso somente leitura, chamadas MCP e criação de tarefas são gerenciados separadamente.
Permissões
O gerenciamento de automações é exclusivo de administradores; todos os membros podem ver as automações e seu histórico de execução. Como uma automação tem alcance em nível de organização, essa assimetria é intencional.
Monitorando-as
Cada automação mantém um log de entrega e análises. Verifique o log após habilitar uma nova automação — o modo de falha não é um erro, mas o disparo constante sem gerar nenhuma ação das pessoas.
Automações, agendamentos e Sentinel
| Mecanismo | Disparado por |
|---|---|
| Automação | Um evento da plataforma |
| Agendamento | Hora |
| Sentinel | Uma condição sendo observada |