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

# Agente Investigator: revisión con IA de KYC, AML y casos

> El Investigator de Didit prepara un informe con citas para cada verificación, alerta y caso en revisión; tú eliges cuánto puede decidir solo.

> [!WARNING]
>
> El Investigador es nuevo y todavía no está habilitado en todas las organizaciones. Pide a Didit que lo active. Requiere el plan Growth o superior, y nunca se ejecuta en aplicaciones de sandbox.

El Investigador revisa los elementos que esperan la intervención de una persona. En cada uno lee el registro, redacta un informe con una recomendación y la evidencia que la respalda, y después espera a tu revisor o, cuando lo permites, decide por su cuenta.

## Qué revisa

| Cola | Elemento | Empieza cuando |
| - | - | - |
| KYC | Una sesión de verificación | La sesión pasa a **In Review**. |
| KYB | Una verificación de empresas | La sesión pasa a **In Review**. |
| AML | Una sesión con una coincidencia de la monitorización AML continua | Llega una nueva coincidencia. |
| Transacciones | Una alerta de transacción | La transacción pasa a **En Revisión**. |
| Casos | Un caso | El caso se abre o se reabre. |

Si tu equipo decide el elemento antes, la ejecución del Investigador se cierra sin decisión.

## El informe

Cada informe incluye:

* una **recomendación**: aprobar, rechazar, solicitar más información (reenvío de una verificación, a la espera del usuario en una transacción) o escalar,
* una **confianza**: alta, moderada o baja,
* un resumen y el razonamiento,
* **evidencia**: cada punto se clasifica como correcto, un riesgo, algo que requiere revisión, explicado o contexto, y cita sus fuentes,
* en las coincidencias de análisis, si cada coincidencia es la misma persona, no es la misma persona o no está claro,
* los siguientes pasos sugeridos, como abrir un registro vinculado o un caso.

### Fuentes que cita

El Investigador lee los mismos datos que tus revisores ven en la consola y en la API: la decisión de la verificación, la decisión de la verificación de empresas, el detalle de la transacción o el detalle del caso. También puede abrir sesiones, transacciones y casos vinculados. Cada punto de evidencia cita la sección del registro que leyó o el registro vinculado que abrió. El informe también muestra **Qué he comprobado**: el resumen, las secciones y los registros que leyó, en orden.

Trabaja únicamente a partir de ese registro. Antes de que el registro llegue al modelo, Didit elimina los archivos multimedia, los enlaces y los identificadores internos, y enmascara las características protegidas. El Investigador no puede modificar datos. Solo redacta su informe.

## Etapas

| Etapa | Qué ocurre | Se cobra |
| - | - | - |
| **Sin configurar** | El Investigador no se ejecuta. | No |
| **Modo de observación** | Redacta informes y se evalúa a sí mismo frente a las decisiones de tu equipo. Los revisores deciden como siempre. | No |
| **La automatización está activa** | Los informes están disponibles para los revisores, y las colas pueden decidir por su cuenta con el nivel de autonomía que elijas. | Sí |

Mantén el modo de observación durante 7, 14 (el valor predeterminado) o 30 días antes de pasar a producción. La configuración, el modo de observación y los backtests nunca se cobran.

## Niveles de autonomía

Define un nivel de autonomía para cada cola:

| Nivel | Qué hace |
| - | - |
| **Desactivado** | Los elementos llegan a los revisores sin informe. |
| **Sugerir** (predeterminado) | Prepara el informe. Una persona decide cada elemento. |
| **Automático** | Decide los elementos que cubre tu política, con confianza **alta**, cuando su concordancia histórica con tu equipo alcanza el umbral de la cola. |
| **Totalmente automático** | También decide los elementos con confianza **moderada**. Una muestra sigue yendo a una persona para controles de calidad. |

El Investigador decide por su cuenta solo cuando se cumplen todas estas condiciones:

* la aplicación está en producción y la cola está en **Automático** o **Totalmente automático**, y no está en pausa,
* la política de tu equipo cubre el elemento e indica que se tome la acción recomendada,
* ninguna salvaguarda retiene el elemento,
* su concordancia con las decisiones anteriores de tu equipo alcanza el umbral, en al menos 20 decisiones de los últimos 90 días,
* el elemento no se ha seleccionado para la muestra de calidad, está dentro del porcentaje de despliegue y no se ha alcanzado el límite diario.

| Ajuste de la cola | Valores |
| - | - |
| Umbral | 80, 85, 90 (predeterminado) o 95% de concordancia |
| Muestra de calidad | El 2, 5 (predeterminado) o 10% de los elementos decididos va a una persona |
| Límite diario | 200 elementos al día de forma predeterminada |
| Despliegue | Gradual (el 25% de los elementos durante 14 días) o todos los elementos |
| Tope de importe | Las transacciones que lo superan siempre van a una persona. 25,000 de forma predeterminada, en la moneda de tu aplicación. |
| Avanzar automáticamente | Subir de nivel cuando la concordancia alcanza el 98% |

Para subir una cola a **Automático** o **Totalmente automático**, primero ejecutas un backtest sobre decisiones anteriores y confirmas el resultado. Las colas de **Casos** y **AML** nunca se aceptan en lote, y los casos escalados o los casos a la espera de un segundo revisor nunca se deciden automáticamente.

## Salvaguardas

Estas reglas están siempre activas y no se pueden cambiar:

* Las coincidencias con sanciones siempre van a una persona.
* Los motivos de fraude y AML nunca llegan a los usuarios finales.
* Ninguna decisión se basa en características protegidas.
* El Investigador nunca presenta un informe regulatorio.
* Cada decisión queda registrada y se puede anular o reemplazar.

## Revisar un informe

En **Sugerir**, un revisor puede:

* **Aceptar** la recomendación,
* **Editar y aceptar** la recomendación,
* **Anular** la recomendación, con una categoría (falta contexto, necesita información, la política es distinta, evidencia mal interpretada, otra) y un motivo de 10 a 500 caracteres,
* usar **Aceptar en lote** con hasta 50 elementos marcados como **Listos para aceptar**.

Al aceptar una recomendación, la decisión se aplica por la vía habitual del elemento, de modo que se disparan tus webhooks y notificaciones de siempre. Una escalada abre un caso vinculado. Una decisión tomada por el Investigador aparece en el elemento con la etiqueta **Decidido por el Investigador**.

## Política del equipo

Cada cola tiene una política del equipo: tus reglas sobre qué aprobar, rechazar o escalar. El Investigador la sigue, y solo decide por su cuenta cuando la política cubre el elemento. Las políticas tienen control de versiones. La pestaña **Preguntas** reúne los puntos que el Investigador necesita que tu equipo aclare.

## Historial de auditoría

La pestaña **Activity** registra cada informe, aceptación, edición, anulación, decisión automatizada, retención por una medida de protección y cambio de configuración, junto con quién lo hizo: el Investigador, una persona, una clave de API o el sistema. Las entradas no se pueden editar. Puedes exportar hasta 10,000 entradas en CSV.

Cada decisión que el Investigador toma por su cuenta también se escribe en el [registro de auditoría](https://docs.didit.me/es/console/audit-logs.md) de tu organización, bajo **The Investigator** y vinculada a su informe, junto a lo que hicieron tus miembros y tus claves de API.

## Precios

El Investigador tiene un único precio: **\$0.20 por verificación revisada (KYC, KYB o coincidencia AML), alerta de transacción o caso**. Por ese precio lee el registro, redacta un informe con citas y su recomendación, y lo entrega a tu revisor o decide por su cuenta dentro de tu política.

| Elemento revisado | Precio |
| - | - |
| Verificación (KYC, KYB o coincidencia AML), alerta de transacción o caso | \$0.20 |

Se cobra una vez por elemento, y solo cuando la aplicación está en producción y el informe se acepta, se edita y se acepta, o el Investigador decide por su cuenta. Las anulaciones, los elementos que tu equipo decidió por otra vía, las ejecuciones fallidas, el modo sombra, la configuración inicial y los backtests son gratuitos. Se aplican los descuentos de tu plan.

Puedes fijar un límite de gasto mensual opcional en **Settings**. Al alcanzar el límite, los nuevos elementos llegan a los revisores sin informe.

## API y webhooks

La API del Investigador está en `https://verification.didit.me/v3/investigator/` y usa la clave de API de tu aplicación (`x-api-key`).

| Endpoint | Propósito |
| - | - |
| `GET summary/`, `GET queue/` | Recuentos de la cola y los elementos en espera. |
| `GET runs/{id}/` | Un informe. |
| `POST runs/{id}/accept/`, `POST runs/{id}/override/`, `POST runs/batch-accept/` | Actuar sobre los informes. |
| `GET transactions/{id}/` | El informe de una transacción. |
| `GET dashboard/`, `GET performance/`, `GET activity/`, `GET activity/export/` | Resultados y registro de auditoría. |
| `GET guardrails/` | Las salvaguardas bloqueadas. |
| `GET` / `PATCH settings/` | Etapa y límite de gasto mensual. |

Una clave de API restringida necesita el alcance `decisions` para leer informes y actuar sobre ellos, y el alcance `applications` para leer o cambiar la configuración. Los informes de transacciones también necesitan el alcance `transactions`. Las claves limitadas a algunos flujos o a sesiones aprobadas se rechazan, porque la cola abarca todos los flujos. Los esquemas completos de solicitud y respuesta están en [`openapi-25.json`](https://docs.didit.me/openapi-25.json), bajo la etiqueta **Investigator**.

No existe un webhook específico del Investigador. La `decision` de un [`status.updated` webhook](https://docs.didit.me/es/integration/webhooks#bloque-del-investigator) y de `GET /v3/session/{id}/decision/` incluye un bloque `investigator` con los campos `status`, `recommendation`, `confidence`, `summary`, `ready_to_accept`, `automated` y `decided_by` (`investigator` o `member`) de la ejecución.

## Relacionado

> [card] [Revisión manual](https://docs.didit.me/es/console/manual-review.md)
>
> Cómo revisa tu equipo las sesiones de verificación.

> [card] [Casos](https://docs.didit.me/es/console/case-management/cases.md)
>
> Gestión de casos para alertas e investigaciones.


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