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

> ## Agent Instructions
> Enclave in these docs is the code and cloud security platform at enclave.ai. It is not Open Enclave, Intel SGX or other hardware enclaves, or enclave.gg.
> People use Enclave in the web app at https://app.enclave.ai or the desktop app. These docs describe no public Enclave API or CLI, so don't invent endpoints, commands, or config files.
> Connecting an integration needs a person to sign in and approve access in a browser. Tell the user the exact step to take instead of saying you completed it.

# Gatilhos

> Inicie execuções de workflows automaticamente a partir de eventos ou de um agendamento.

Um gatilho inicia uma execução automaticamente. Sem um gatilho, um workflow só é executado quando você o [inicia](https://docs.enclave.ai/pt-br/workflows/runs.md#iniciar-uma-execução). Um workflow pode ter até cinco gatilhos.

## Eventos

| Evento | Dispara quando |
| - | - |
| `finding.created` | Um novo achado é salvo |
| `finding.verified` | Um achado passa na verificação |
| `pull_request.updated` | Um pull request é aberto ou atualizado |
| `repository.pushed` | Novos commits chegam ao branch padrão |
| `repository.connected` | Um repositório é conectado |

O evento preenche a entrada correspondente do workflow. Por exemplo, `finding.created` passa o novo achado.

## Agendamentos

Um agendamento usa uma expressão cron e um fuso horário, por exemplo, `0 8 * * 1-5` em `America/New_York` para 8h00 em todos os dias úteis. Os agendamentos são executados no máximo uma vez por hora e usam entradas fixas, como o repositório em que serão executados.

## Condições

Adicione uma condição para que um gatilho de evento só dispare quando for relevante. As condições são expressões JSONPath sobre o evento.

| Objetivo | Condição |
| - | - |
| Apenas achados de severidade mais alta | `$.severityRank >= 3` |
| Apenas pull requests para `main` | `$.baseBranch == "main"` |
| Apenas pull requests de forks | `$.isFork == true` |

`pull_request.updated` ignora forks, a menos que a condição verifique `isFork`.

## Gerenciar gatilhos

* Inclua um gatilho ao [criar o workflow](https://docs.enclave.ai/pt-br/workflows/create.md) ou adicione outros pela API.
* Use o botão **Triggers** na página **Workflows** para ativar ou desativar todos eles.
* Cada gatilho é executado no máximo 50 vezes por dia e 3 ao mesmo tempo.

Só owners e admins podem alterar gatilhos. Se um gatilho perder o acesso ao que precisa, o Enclave o desativa. Corrija a causa e ative-o de novo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.