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

# Regras e workflows

> Como as regras AML se relacionam com as automações e o gatilho rule_triggered. Consulte o esquema do request, códigos de resposta e autenticação.

## Dois sistemas distintos

| Camada                           | Papel                                                                                                                                                                         |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Regras AML (motor de regras)** | Avaliam transações, entidades ou outros sujeitos; condições e **ações de regra** no rule builder (scores, alertas, `trigger_workflow` / `trigger_automation`, etc.).          |
| **Automações (workflows)**       | **Esta documentação:** gatilhos como `alert_created`, `transaction_created`, **`rule_triggered`**, ações como `create_investigation`, `run_risk_matrix`, `send_webhook`, etc. |

**Não** são a mesma superfície de produto, mas **integram**.

## Ponte: regra → automação

Quando uma regra **dá match**, uma ação de regra pode **iniciar uma ou mais automações**. A automação roda com **`triggerType: `**`rule_triggered` e `event.data` com:

* **Resumo da regra:** ex. `rule.id`, `rule.name`, `rule.externalId`, `rule.score`.
* **Contexto do sujeito avaliado:** tipicamente **entidade**, **transação** e opcionalmente **alerta** / **KYC**, conforme a regra.

Serve para encadear **decisões de regras** a **gestão de casos**, **notificações** ou **enriquecimento** sem duplicar toda a lógica de regras dentro do workflow.

## Desenhar automações `rule_triggered`

* Use ações permitidas para **`rule_triggered`** em [Sinergia](/pt/workflows/synergy) (ex. `create_investigation`, `set_entity_status`, `run_risk_matrix`, `create_kyc_validation`, webhooks).
* Condições podem usar contexto de **regra** ([Gatilhos](/pt/workflows/triggers)).

## Onde ler sobre regras

Gatilhos, scores e ações próprias do motor de regras estão nas seções **Regras** deste site; não são duplicados aqui.

***

**Manutenção:** nomes de ações de regra e parâmetros vivem no rules engine e na API; do lado automações é `runAutomationById` + evento sintético `rule_triggered`.