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

> Revisión humana para casos biométricos que el agente no puede resolver con certeza.

Human in the Loop (HIL) suma un operador humano al proceso biométrico quien revisa los casos en los que el agente no tiene certeza suficiente para aprobar o rechazar de forma automática, antes de resolver la verificación.

<Info>
  HIL está disponible **únicamente para cuentas Enterprise**. No es una funcionalidad estándar del producto.
</Info>

## Cómo activarlo

No puedes activar HIL desde Brain Studio: **gestiona la activación a través de tu Account Manager asignado**, quien coordina la habilitación con el equipo de producto.

## Qué hace un operador HIL

Los operadores humanos asignados por parte de tu empresa tienen acceso a una plataforma de revisión donde pueden **aprobar o rechazar** los casos que el agente biométrico deriva por duda, indicando el motivo, o **rechazar y enviar a blacklist** de forma inmediata cuando el caso lo amerita.

### Detección de fraude coordinado

HIL identifica cuando un mismo documento está vinculado a múltiples números de teléfono, con un nivel de riesgo automático:

* **Alto:** tres o más clientes vinculados al mismo documento.
* **Medio:** dos clientes vinculados.

La relación se visualiza en un grafo de red.

### Gestión de blacklist

* Bloqueo o remoción masiva de hasta cien usuarios en una sola acción.
* Soporte para bloqueos temporales con vigencia programada.
* Log histórico filtrable por empresa, fecha, estado y operador.

### Trazabilidad y roles

HIL registra cada caso con quién lo revisó, cuándo y bajo qué criterio.

<Info>
  HIL puede aumentar la tasa de aprobación entre un **cinco y un quince por ciento** frente al rechazo automático puro, al resolver casos ambiguos que de otra forma se rechazarían.
</Info>

## ¿En qué situaciones se envía una solicitud a HIL?

HIL recibe un caso cuando el agente biométrico detecta una señal de duda que no es suficiente para rechazar el proceso de forma definitiva.

### Según el nivel de verificación documental

En WebView, el disparador principal es un error en cualquier parámetro definido como **requerido** para el nivel de verificación documental que configures en el nodo Biometría. Consulta el [nivel de verificación documental](/guides/integraciones/identidad/biometria-webview) para revisar y ajustar estos parámetros.

| Nivel        | Parámetros requeridos que derivan a HIL                                                                                                                       |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Estándar** | Tipo y origen del documento, fecha de vigencia y elementos de seguridad físicos.                                                                              |
| **Avanzado** | Todo lo de Estándar, más el resultado global del documento y, si están habilitados, la zona de lectura automática y la coherencia de datos del documento.     |
| **Custom**   | Depende exclusivamente de los parámetros que configures como requeridos para tu empresa. Cualquier parámetro requerido que arroje error deriva el caso a HIL. |

### Otras señales que activan HIL

Estas señales derivan un caso a revisión humana sin importar el nivel de verificación documental configurado:

* Exceso de reintentos en documento con HIL activo (máximo tres intentos; la prueba de vida tiene un límite de intentos separado).
* Detección de screenshot — la selfie proviene de una pantalla en vez de una captura en vivo.
* Detección de manipulación documental — foto sustituida o datos modificados.

<Tip>
  Solo los parámetros marcados como **requeridos** generan una derivación a HIL cuando fallan. Revisa esta configuración en el nodo Biometría antes de activar HIL para evitar derivaciones que no esperas.
</Tip>

<Warning>
  El sistema rechaza algunos casos de forma definitiva, sin pasar por HIL: liveness fallido, facematch por debajo del umbral, menor de edad, documento que no corresponde al tipo aceptado, o fallo en la validación gubernamental.
</Warning>

## Qué no cubre HIL

* Búsqueda 1:N contra la base facial completa del cliente.