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

# Human in the Loop (HIL)

> Revisão humana para casos biométricos que o agente não consegue resolver com certeza.

Human in the Loop (HIL) adiciona um operador humano ao processo biométrico: revisa os casos em que o agente não tem certeza suficiente para aprovar ou rejeitar automaticamente, antes de concluir a verificação.

<Info>
  HIL está disponível **somente para contas Enterprise**. Não é uma funcionalidade padrão do produto.
</Info>

## Como ativar

Você não pode ativar o HIL pelo Brain Studio: **gerencie a ativação por meio do seu Account Manager designado**, que coordena a habilitação com a equipe de produto.

## O que um operador HIL faz

Os operadores humanos designados pela sua empresa têm acesso a uma plataforma de revisão onde podem **aprovar ou rejeitar** os casos que o agente biométrico encaminha por dúvida, indicando o motivo, ou **rejeitar e enviar para a blacklist** imediatamente quando o caso justificar.

### Detecção de fraude coordenada

O HIL identifica quando o mesmo documento está vinculado a múltiplos números de telefone, com um nível de risco automático:

* **Alto:** três ou mais clientes vinculados ao mesmo documento.
* **Médio:** dois clientes vinculados.

A relação é exibida em um grafo de rede.

### Gestão de blacklist

* Bloqueio ou remoção em massa de até cem usuários em uma única ação.
* Suporte a bloqueios temporários com vigência programada.
* Log histórico filtrável por empresa, data, status e operador.

### Rastreabilidade e papéis

O HIL registra cada caso com quem o revisou, quando e sob qual critério. Você gerencia o acesso por papel (administrador / operador), com segmentação por empresa e/ou país.

<Info>
  O HIL pode aumentar a taxa de aprovação entre **cinco e quinze por cento** em comparação à rejeição automática pura, ao resolver casos ambíguos que de outra forma seriam rejeitados.
</Info>

## Em quais situações uma solicitação é enviada ao HIL?

O HIL recebe um caso quando o agente biométrico detecta um sinal de dúvida que não é suficiente para rejeitar o processo definitivamente.

### Segundo o nível de verificação documental

No WebView, o principal gatilho é um erro em qualquer parâmetro definido como **obrigatório** para o nível de verificação documental configurado no nó Biometria. Consulte o [nível de verificação documental](/pt/guias/integracoes/identidade/validacao-webview) para revisar e ajustar esses parâmetros.

| Nível        | Parâmetros obrigatórios que encaminham para o HIL                                                                                                                            |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Padrão**   | Tipo e origem do documento, data de vigência e elementos de segurança físicos.                                                                                               |
| **Avançado** | Tudo do Padrão, mais o resultado global do documento e, quando habilitados, a zona de leitura automática e a coerência de dados do documento.                                |
| **Custom**   | Depende exclusivamente dos parâmetros que você configurar como obrigatórios para sua empresa. Qualquer parâmetro obrigatório que apresente erro encaminha o caso para o HIL. |

### Outros sinais que acionam o HIL

Estes sinais encaminham um caso para revisão humana independentemente do nível de verificação documental configurado:

* Excesso de tentativas no documento com HIL ativo (máximo de três tentativas; a prova de vivacidade tem um limite de tentativas separado).
* Detecção de screenshot — a selfie vem de uma tela em vez de uma captura ao vivo.
* Detecção de manipulação documental — foto substituída ou dados modificados.

<Tip>
  Somente os parâmetros marcados como **obrigatórios** geram um encaminhamento ao HIL quando falham. Revise essa configuração no nó Biometria antes de ativar o HIL para evitar encaminhamentos que você não espera.
</Tip>

<Warning>
  O sistema sempre rejeita alguns casos definitivamente, sem passar pelo HIL: vivacidade reprovada, facematch abaixo do limite, usuário menor de idade, documento que não corresponde ao tipo aceito, ou falha na validação governamental.
</Warning>

## O que o HIL não cobre

* Deduplicação ou identificação de identidades biométricas sintéticas ou recicladas por meio de busca 1:N na base facial completa do cliente.
* Controle de permissões por papel em nível de sistema (leitura/gravação por perfil) — atualmente em avaliação.