> ## 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.

# Como Gerenciar Alertas e Investigações

> Fluxo completo de alertas: triagem, análise, investigação e resolução com IA — no painel gu1 com orientação passo a passo, com exemplos para gerenciar alertas.

## Tutorial Interativo

<Info>
  **Em breve**: Vídeo interativo com Clueso estará disponível aqui. Por enquanto, siga o guia passo a passo abaixo.
</Info>

## Visão Geral

Os **alertas** no gu1 são notificações automáticas geradas quando uma regra detecta um potencial risco. O sistema de gestão de alertas permite:

* **Triagem rápida** de alertas por prioridade
* **Consolidação automática** de alertas relacionados
* **Análise com IA** para contexto e recomendações
* **Workflow de investigação** estruturado
* **Auditoria completa** de todas as decisões

<Tip>
  **Produtividade**: Use filtros, atalhos de teclado e ações em lote para processar alertas 10x mais rápido.
</Tip>

## Ciclo de Vida de um Alerta

<Steps>
  <Step title="Criação Automática">
    Uma regra detecta um risco e cria um alerta com prioridade e tipo definidos.
  </Step>

  <Step title="Triagem">
    Analista revisa o alerta e decide:

    * **Descartar** (falso positivo)
    * **Escalar** para investigação
    * **Resolver** imediatamente (risco aceitável)
  </Step>

  <Step title="Investigação (se necessário)">
    Alertas complexos são agrupados em uma investigação com análise aprofundada.
  </Step>

  <Step title="Resolução">
    Decisão final é tomada e documentada (aprovar, rejeitar, solicitar mais info).
  </Step>

  <Step title="Auditoria">
    Todo o histórico fica registrado para compliance e auditorias futuras.
  </Step>
</Steps>

## Painel de Alertas

<CardGroup cols={3}>
  <Card title="Critical" icon="circle-exclamation" color="#dc2626">
    **Ação imediata**

    * Sanctions hit
    * PEPs de alto risco
    * Fraude detectada
    * Revisar em \< 1 hora
  </Card>

  <Card title="High" icon="triangle-exclamation" color="#f59e0b">
    **Prioridade alta**

    * Múltiplos fatores de risco
    * Notícias adversas recentes
    * Documentos ausentes críticos
    * Revisar em \< 4 horas
  </Card>

  <Card title="Medium" icon="circle-info" color="#3b82f6">
    **Revisão padrão**

    * Validações pendentes
    * Dados incompletos
    * Mudanças cadastrais
    * Revisar em \< 24 horas
  </Card>
</CardGroup>

### Filtros Disponíveis

<Tabs>
  <Tab title="Por Status">
    * **New** - Alertas não revisados
    * **In Review** - Sendo analisados
    * **Investigating** - Escalados para investigação
    * **Resolved** - Finalizados (aprovado/rejeitado)
    * **Dismissed** - Descartados (falso positivo)
  </Tab>

  <Tab title="Por Tipo">
    * **AML** - Anti-Money Laundering
    * **Fraud** - Detecção de fraude
    * **KYC** - Know Your Customer
    * **Compliance** - Validações regulatórias
    * **Credit** - Risco de crédito
  </Tab>

  <Tab title="Por Entidade">
    * **Person** - Pessoas físicas
    * **Company** - Empresas
    * **Transaction** - Transações
    * **Relacionadas** - Entidades conectadas
  </Tab>

  <Tab title="Por Time">
    * **Meus alertas** - Atribuídos a você
    * **Meu time** - Do seu time
    * **Não atribuídos** - Sem responsável
    * **Todos** - Visão geral
  </Tab>
</Tabs>

## Revisando um Alerta

### Passo a Passo

<Steps>
  <Step title="Abra o Alerta">
    Clique no alerta no painel. Você verá:

    * **Entidade afetada** com dados principais
    * **Regra que disparou** o alerta
    * **Motivo** da detecção
    * **Score de risco** calculado
    * **Contexto adicional** (documentos, transações, relacionamentos)
  </Step>

  <Step title="Revise os Dados">
    Analise cuidadosamente:

    **Painel Esquerdo**:

    * Informações da entidade
    * Documentos anexados
    * Histórico de alertas
    * Transações recentes

    **Painel Central**:

    * Detalhes do alerta atual
    * Regras violadas
    * Timeline de eventos

    **Painel Direito**:

    * Análise de IA (se disponível)
    * Recomendações
    * Comentários do time
  </Step>

  <Step title="Solicite Análise de IA (Opcional)">
    Clique em **Analyze with AI** para obter:

    * Resumo contextualizado
    * Identificação de padrões
    * Recomendação de ação
    * Justificativa detalhada

    <Warning>
      **Custo**: Análises de IA consomem tokens. Use para casos complexos ou de alto risco.
    </Warning>
  </Step>

  <Step title="Tome uma Decisão">
    Escolha a ação apropriada:

    **Descartar**:

    * Falso positivo confirmado
    * Erro na regra
    * Dados incorretos

    **Resolver**:

    * Risco aceitável dentro da política
    * Documentação suficiente
    * Sem necessidade de investigação

    **Escalar**:

    * Múltiplos fatores de risco
    * Requer análise aprofundada
    * Decisão de senior analyst
  </Step>

  <Step title="Documente">
    **Sempre adicione um comentário** explicando sua decisão:

    * Por que você tomou essa decisão?
    * Quais evidências você considerou?
    * Há alguma ação de follow-up?

    Isso é **crítico para auditoria e compliance**.
  </Step>
</Steps>

## Análise com IA

O gu1 oferece análise de IA para contextualizar alertas complexos:

### Como Funciona

1. **Clique em "Analyze with AI"** no canto superior direito do alerta
2. O sistema envia para GPT-4:
   * Todos os dados da entidade
   * Contexto do alerta
   * Regras violadas
   * Histórico relevante
3. A IA retorna:
   * **Resumo executivo** (2-3 parágrafos)
   * **Fatores de risco identificados** (lista priorizada)
   * **Recomendação** (descartar, resolver, investigar)
   * **Justificativa** detalhada
   * **Próximos passos** sugeridos

### Exemplo de Output

```markdown theme={null}
## Resumo Executivo

João Silva apresenta múltiplos indicadores de risco moderado. Foi identificado
como PEP (Senador Federal), possui notícias recentes sobre investigação de
corrupção, e realizou transações acima de R$ 100.000 para paraísos fiscais
nos últimos 30 dias.

## Fatores de Risco

1. **PEP de Alto Nível** (Score: 85/100)
   - Cargo: Senador Federal (Nacional)
   - Exposição: Alta

2. **Notícias Adversas** (Score: 70/100)
   - 3 notícias nos últimos 60 dias
   - Temas: Corrupção, Lavagem de Dinheiro
   - Fontes confiáveis: Folha, Estadão

3. **Transações Suspeitas** (Score: 65/100)
   - 5 transações > R$ 100k
   - Destinos: Ilhas Cayman, Panamá
   - Frequência: Acima do padrão histórico

## Recomendação

🔴 **ESCALAR PARA INVESTIGAÇÃO**

Este caso requer Enhanced Due Diligence (EDD). Recomendamos:
- Solicitar source of funds para as transações internacionais
- Verificar relacionamentos com outras entidades investigadas
- Consultar bases de dados adicionais (World Check, ComplyAdvantage)

## Próximos Passos

1. Criar investigação de EDD
2. Solicitar documentação adicional ao cliente
3. Consultar compliance officer para decisão final
```

<Tip>
  **Personalização**: Você pode editar o prompt da análise de IA em **Settings** > **AI Configuration** para adaptar às necessidades da sua organização.
</Tip>

## Consolidação de Alertas

Quando múltiplos alertas são sobre a **mesma entidade** ou **relacionados**, o gu1 pode consolidá-los automaticamente em uma **investigação**.

### Quando Consolidar?

* **Mesma pessoa/empresa** com múltiplos alertas em curto período
* **Entidades relacionadas** (sócios, familiares, empresas conectadas)
* **Padrão coordenado** (ex: múltiplas transações suspeitas)
* **Alertas de alta criticidade** que requerem análise conjunta

### Como Consolidar Manualmente

<Steps>
  <Step title="Selecione Alertas">
    No painel, marque os checkboxes dos alertas relacionados.
  </Step>

  <Step title="Clique em 'Consolidate'">
    Botão aparece no topo quando 2+ alertas estão selecionados.
  </Step>

  <Step title="Configure a Investigação">
    * **Título**: Descrição do caso
    * **Tipo**: Due Diligence, EDD, Fraud Investigation, etc.
    * **Prioridade**: Herdada do alerta mais crítico
    * **Atribuir a**: Senior analyst ou time especializado
  </Step>

  <Step title="Adicione Contexto">
    Escreva um resumo explicando por que esses alertas foram consolidados e o que deve ser investigado.
  </Step>
</Steps>

### Consolidação Automática

Configure em **Settings** > **Rules** > **Alert Consolidation**:

```json theme={null}
{
  "rules": [
    {
      "name": "Consolidar PEPs com múltiplos alertas",
      "condition": {
        "alertCount": { "min": 2 },
        "entityType": "person",
        "entityProperties": {
          "isPEP": true
        },
        "timeWindow": "7d"
      },
      "action": {
        "type": "auto_investigate",
        "investigationType": "enhanced_dd",
        "priority": "high"
      }
    }
  ]
}
```

## Investigações

Investigações são **processos estruturados** para casos complexos que requerem:

* Múltiplas fontes de evidência
* Aprovação de senior analysts
* Documentação extensa para auditoria
* Decisões de negócio (aceitar, rejeitar, solicitar docs)

### Tipos de Investigação

<CardGroup cols={2}>
  <Card title="Due Diligence (DD)" icon="magnifying-glass">
    **Validação padrão**

    * KYC básico
    * Validação de documentos
    * Checagem de listas
    * Timeline: 1-3 dias
  </Card>

  <Card title="Enhanced DD (EDD)" icon="magnifying-glass-plus">
    **Análise aprofundada**

    * PEPs e alto risco
    * Source of funds
    * Ultimate beneficial owner
    * Timeline: 5-15 dias
  </Card>

  <Card title="Fraud Investigation" icon="user-secret">
    **Investigação de fraude**

    * Padrões suspeitos
    * Documentos falsificados
    * Identidade sintética
    * Timeline: 3-10 dias
  </Card>

  <Card title="Adverse Media" icon="newspaper">
    **Análise de notícias**

    * Reputação
    * Litígios
    * Escândalos
    * Timeline: 1-5 dias
  </Card>
</CardGroup>

### Workflow de Investigação

<Steps>
  <Step title="Criação">
    Investigação é criada manualmente ou por consolidação automática de alertas.
  </Step>

  <Step title="Coleta de Evidências">
    Analista adiciona:

    * Documentos extras solicitados
    * Resultados de integrações (ComplyAdvantage, etc.)
    * Screenshots de notícias
    * Comentários de análise
  </Step>

  <Step title="Análise de IA (Opcional)">
    Gere um relatório consolidado com todos os achados usando **"Generate Investigation Report"**.
  </Step>

  <Step title="Decisão">
    Senior analyst ou compliance officer toma decisão final:

    * **Approve**: Cliente aceito, risco aceitável
    * **Reject**: Cliente rejeitado, alto risco
    * **Request More Info**: Solicitar documentação adicional
  </Step>

  <Step title="Fechamento">
    Investigação é marcada como resolvida e todos os alertas consolidados são atualizados.
  </Step>
</Steps>

## Atalhos de Teclado

<Tip>
  **Produtividade**: Use atalhos para revisar alertas 10x mais rápido!

  * `j/k` - Navegar entre alertas (próximo/anterior)
  * `o` - Abrir alerta selecionado
  * `a` - Análise de IA
  * `c` - Adicionar comentário
  * `d` - Descartar alerta
  * `r` - Resolver alerta
  * `i` - Escalar para investigação
  * `?` - Ver todos os atalhos
</Tip>

## Ações em Lote

Para processar múltiplos alertas simultaneamente:

<Steps>
  <Step title="Selecione Alertas">
    Marque os checkboxes dos alertas desejados.
  </Step>

  <Step title="Escolha Ação">
    Menu aparece no topo:

    * **Assign to** - Atribuir a analista/time
    * **Change priority** - Alterar prioridade
    * **Add tags** - Adicionar tags
    * **Consolidate** - Criar investigação
    * **Dismiss** - Descartar em lote (com justificativa)
  </Step>

  <Step title="Confirme">
    Ações em lote requerem confirmação e comentário obrigatório.
  </Step>
</Steps>

<Warning>
  **Cuidado**: Ações em lote são irreversíveis. Sempre revise a seleção antes de confirmar.
</Warning>

## Relatórios e Métricas

Acesse **Reports** > **Alerts Dashboard** para visualizar:

### KPIs Principais

* **Volume de alertas** (por dia/semana/mês)
* **Taxa de falsos positivos** (% de alertas descartados)
* **Tempo médio de resolução** (por prioridade/tipo)
* **Backlog** (alertas não revisados)
* **Produtividade por analista** (alertas resolvidos/dia)

### Análise de Regras

* **Alertas por regra** (quais regras geram mais alertas?)
* **Precisão de regras** (% de alertas válidos)
* **Ajuste de regras** (sugestões para reduzir falsos positivos)

<Tip>
  **Otimização**: Se uma regra tem taxa de falsos positivos > 30%, considere ajustar as condições ou score threshold.
</Tip>

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Criar Regras" icon="gavel" href="/pt/tutoriais/criar-regras">
    Configure regras para gerar alertas automaticamente
  </Card>

  <Card title="Configurar Times" icon="users-gear" href="/pt/tutoriais/configurar-equipes">
    Organize sua equipe e atribua alertas por área
  </Card>

  <Card title="Webhooks" icon="webhook" href="/pt/webhooks/configuration">
    Receba notificações em tempo real de novos alertas
  </Card>

  <Card title="API de Alertas" icon="code" href="/pt/api-reference/alerts/list">
    Integre alertas com seus sistemas
  </Card>
</CardGroup>

## Precisa de Ajuda?

* **Documentação**: Navegue por nossas guias completas
* **Email**: [support@gueno.com](mailto:support@gueno.com)
* **Dashboard**: Acesse sua conta em [app.gu1.ai](https://app.gu1.ai)

***

**Última atualização**: Janeiro 2025