Agente Document Check

Versión: 1.9.10-public.beta.4

El Agente Document Check es un sistema multiagente diseñado para garantizar la autenticidad de los documentos de identidad, asegurando que estén vigentes, no hayan sido manipulados, y cumplan con los estándares de seguridad. Se puede hacer uso de este agente cuando se requiera validar la autenticidad de un documento y extraer información de manera precisa.

Este agente tiene la capacidad de extraer información de 1400 tipos de documentos de 255 países diferentes.

Experiencia de usuario

Solicitamos al usuario que proporcione fotografías del documento de identidad por ambas caras y realizamos algunas validaciones.

Validaciones

Detección y Clasificación del Documento

Identificamos automáticamente el tipo de documento presentado, como cédula, pasaporte o licencia de conducción.

Extracción y Verificación de Elementos (OCR)

Utilizando tecnología de OCR, extraemos y validamos texto, foto del titular y otros elementos clave, asegurando la correcta lectura de datos como nombre, número de documento y nacionalidad.

Verificación de Autenticidad e Integridad

Comprobamos que el documento no haya sido alterado, verificando elementos de seguridad como hologramas, formato de número y autenticidad de la foto del titular. Además, cruzamos la información de la zona MRZ, el OCR visible y el código de barras para asegurar la coherencia y consistencia de todos los datos.

Detección de Adulteraciones Físicas

Detectamos cualquier manipulación física en el documento, como la suplantación de la foto o la modificación de datos impresos, garantizando que el documento sea genuino.

Consulta a entidad gubernamental país

Se realiza la consulta a las bases de datos de entidad gubernamental de cada país:

🇪🇨 Ecuador: Consulta a Registro civil
🇨🇱 Chile: Consulta a Registro civil
🇨🇴 Colombia: Consulta a la ANI (Base de Registraduría nacional)
🇲🇽 México: Consulta a INE y Renapo
🇵🇪 Perú: Consulta a Reniec

Configuración

Inputs
Outputs

País

string

Variable: countryAgent. País del documento que se va a validar.Valores disponibles: Ecuador, Colombia, Chile, Perú, México, Todos

Validar calidad de documento

string

default:"medio"

Variable: validateQACheck. Nivel de validación en la calidad de documento.Valores disponibles: bajo, medio, alto

Deshabilitar solicitud de imágenes

boolean

default:"false"

Variable: disableImagesDocument. Habilitar la solicitud de imágenes del documento.

Este parámetro solo aplica para Ecuador.

Valores disponibles: false, true

Cant. máxima intentos en Document check

Cant. máxima intentos Document check

number

default:"3"

Variable: maxBiometricAttempts. Cantidad máxima de intentos.Valores disponibles: 1-6

Email notificación reintentos excedidos

string

Variable: customerServiceEmail. Correo al que se notificará cuando se supere la cantidad máxima de intentos.

Verificar fecha de expiración del documento

string

default:"Desactivado"

Variable: dateExpiracyCheck. Verifica la fecha de expiración del documento.Valores disponibles: Desactivado, Activado

Habilitar validación gubernamental

boolean

default:"true"

Variable: flagGovValidation. Habilita validación gubernamental; en false no se consulta al registro civil respectivo.Valores disponibles: false, true

Verificar mayoría de edad

boolean

Variable: validateAgeCheck. Permite validar si el usuario cumple con la mayoría de edad.Valores disponibles: false, true

Habilitar Human in the loop

boolean

default:"false"

Variable: enableHumanInLoop. Indica si se activa el proceso de revisión con un asesor humano.Valores disponibles: false, true

Cant. máxima intentos del Agente

string

default:"Indefinida"

Variable: retriesAgent. Cantidad máxima de intentos del Agente para bloquear al usuario.Valores disponibles: Indefinida, 1, 2, 3

Tiempo de Bloqueo del usuario

string

default:"1 dia"

Variable: blockingInHours. Tiempo de bloqueo tras exceder intentos.Valores disponibles: 1 dia, 1 semana, 1 mes

✅ Éxito

Validación de Documento exitosa

La validación del Documento fue exitosa.Variable: documentCheckSuccess

Para acceder a la información de esta variable utilizar el comando $memory.get("response_document_check_success")

Ejemplo de respuesta:

{
  "response_document_check_success": {
    "document_check": {
      "verified_fields": {
        "...": "Datos principales del documento"
      },
      "secondary_fields": {
        "...": "Datos secundarios del documento"
      },
      "details": {
        "...": "Detalles del tipo de documento"
      },
      "image_quality_details": {
        "...": "Detalles de la calidad de la imagen"
      },
      "images_extracted": {
        "...": "Imágenes extraídas del documento"
      },
      "gov_entity_fields": {
        "...": "Datos utilizados para validar con la entidad gubernamental"
      }
    },
    "gov_entity_data": {
      "...": "Datos obtenidos de la entidad gubernamental del país (Variables según el país)"
    },
    "document_image_front_url": "Url de la imagen frontal del documento",
    "document_image_back_url": "Url de la imagen posterior del documento",
    "document_face_image_url": "Url del rostro del documento"
  }
}

Ejemplos por país:

🇨🇴 Colombia

{
  "gov_entity_data": {
    "primer_nombre": "",
    "segundo_nombre": "",
    "primer_apellido": "",
    "segundo_apellido": "",
    "nombres": "",
    "apellidos": "",
    "fecha_expedicion": "",
    "estado_documento": "0",
    "usuario_fallecido": false
  }
}

🇪🇨 Ecuador

{
  "gov_entity_data": {
    "nUI": "09xxxxxxxx",
    "sexo": "",
    "calle": "",
    "error": "",
    "firma": "",
    "nombre": "",
    "conyuge": "",
    "nombres": "",
    "apellidos": "",
    "domicilio": "",
    "profesion": "",
    "fotografia": "https://....",
    "numeroCasa": "5",
    "codigoError": "",
    "estadoCivil": "",
    "instruccion": "",
    "nombreMadre": "",
    "nombrePadre": "",
    "nacionalidad": "",
    "fechaCedulacion": "dd/mm/yyyy",
    "fechaNacimiento": "dd/mm/yyyy",
    "lugarNacimiento": "",
    "condicionCedulado": "",
    "fechaFallecimiento": "",
    "provincia": "",
    "ciudad": "",
    "parroquia": "",
    "primerNombre": "",
    "segundoNombre": "",
    "primerApellido": "",
    "segundoApellido": ""
  }
}

Campos importantes:

document_check: Información completa del documento validado
gov_entity_data: Datos obtenidos de la entidad gubernamental (varía según el país)
document_image_front_url: URL de la imagen frontal
document_image_back_url: URL de la imagen posterior
document_face_image_url: URL de la foto del rostro extraída del documento

Información guardada en Memory:El agente guarda automáticamente la siguiente información en variables de memoria:

{
  "isValid_document_check": true,
  "isValid_government_entity": true,
  "response_document_check_success": {
    "document_check": {
      "secondary_fields": {
        "mrz_strings": "Líneas MRZ completas extraídas del documento.",
        "second_surname": "Segundo apellido del titular.",
        "nationality_code": "Código de nacionalidad en formato ISO.",
        "personal_number_checkdigit": "Dígito verificador del número personal.",
        "date_of_registration": "Fecha en que el documento fue registrado.",
        "date_of_birth": "Fecha de nacimiento en formato MRZ.",
        "sex": "Sexo del titular (M/F).",
        "date_of_birth_checkdigit": "Dígito de verificación de la fecha de nacimiento.",
        "date_of_expiry": "Fecha de expiración del documento en formato MRZ.",
        "final_checkdigit": "Dígito de verificación general del MRZ.",
        "issuing_state_code": "Código del país emisor del documento.",
        "document_class_code": "Código de tipo de documento (ej. pasaporte, ID).",
        "optional_data": "Datos opcionales definidos por el país.",
        "line2_optional_data": "Datos opcionales adicionales en MRZ línea 2.",
        "mrz_type": "Formato de MRZ (ej. ID-1, ID-2).",
        "given_names": "Nombres del titular.",
        "date_of_expiry_checkdigit": "Dígito de verificación de la fecha de expiración.",
        "personal_number": "Número personal asignado al titular.",
        "surname": "Apellido principal del titular.",
        "surname_&_given_names": "Apellidos y nombres concatenados.",
        "date_of_issue": "Fecha en que se emitió el documento."
      },
      "details": {
        "issuing_country": "País emisor del documento.",
        "document_name": "Nombre del modelo del documento reconocido.",
        "document_title": "Título o tipo de documento.",
        "document_description": "Descripción breve del documento.",
        "document_country_name": "Nombre del país emisor en texto."
      },
      "status_fields": {
        "optical": "Estado general de la validación óptica.",
        "details_optical": {
          "expiry": "Resultado de la validación de fecha de expiración.",
          "security": "Estado de validaciones de seguridad.",
          "overall_status": "Resultado global de verificaciones ópticas.",
          "text": "Estado de lectura de texto OCR.",
          "image_QA": "Resultado de la calidad de imagen.",
          "doc_type": "Resultado de validación de tipo de documento.",
          "mrz": "Resultado de la validación de MRZ."
        },
        "overall_status": "Estado global del chequeo de campos."
      },
      "security_fields": {
        "barcode_format_check": {
          "status": "Resultado numérico del chequeo de código de barras.",
          "validations": [
            {
              "element_result": "Resultado de la validación del código de barras.",
              "element_diagnose": "Diagnóstico de la validación.",
              "element_type": "Tipo de elemento validado."
            }
          ],
          "status_text": "Texto del resultado de la validación de código de barras."
        }
      },
      "images_extracted": {
        "portrait": {
          "image": "Imagen del retrato extraída del documento.",
          "format": "Formato de la imagen extraída."
        },
        "ghost_portrait": {
          "image": "Imagen del retrato fantasma en el documento.",
          "format": "Formato del retrato fantasma extraído."
        }
      },
      "image_quality_details": {
        "glares": {
          "status": "Resultado numérico de chequeo de reflejos.",
          "status_text": "Estado del chequeo de reflejos."
        },
        "portrait": {
          "status": "Resultado numérico de detección de retrato.",
          "status_text": "Estado del retrato detectado en el documento."
        },
        "focus": {
          "status": "Resultado numérico del enfoque de la imagen.",
          "status_text": "Estado del enfoque de la imagen."
        },
        "bounds": {
          "status": "Resultado numérico del encuadre del documento.",
          "status_text": "Estado del encuadre del documento."
        },
        "perspective_angle": {
          "status": "Resultado numérico del ángulo de perspectiva.",
          "status_text": "Estado del ángulo de perspectiva."
        },
        "overall_result": "Resultado global de la calidad de la imagen.",
        "resolution": {
          "status": "Resultado numérico de la resolución de la imagen.",
          "status_text": "Estado de la resolución de la imagen."
        }
      },
      "verified_fields": {
        "mrz_strings": "Líneas MRZ verificadas extraídas del documento.",
        "second_surname": "Segundo apellido validado.",
        "nationality_code": "Código de nacionalidad verificado.",
        "remainder_term": "Tiempo restante de validez en meses.",
        "other": "Texto OCR adicional extraído del documento.",
        "personal_number_checkdigit": "Dígito verificador del número personal.",
        "date_of_registration": "Fecha en que se registró el documento.",
        "date_of_expiry": "Fecha de expiración del documento verificada.",
        "sex": "Sexo del titular validado.",
        "date_of_birth_checkdigit": "Dígito de verificación de la fecha de nacimiento.",
        "date_of_birth": "Fecha de nacimiento validada.",
        "years_since_issue": "Años transcurridos desde la emisión.",
        "final_checkdigit": "Dígito de verificación global de MRZ.",
        "issuing_state_code": "Código del país emisor.",
        "nationality": "Nacionalidad del titular.",
        "document_class_code": "Código del tipo de documento.",
        "age_at_issue": "Edad del titular al emitir el documento.",
        "surname_and_given_names": "Apellidos y nombres concatenados verificados.",
        "mrz_type": "Formato de MRZ validado.",
        "given_names": "Nombres validados del titular.",
        "issuing_state_name": "Nombre del país emisor.",
        "date_of_expiry_checkdigit": "Dígito de verificación de expiración.",
        "personal_number": "Número personal del titular.",
        "age": "Edad actual del titular.",
        "surname": "Apellido principal validado.",
        "date_of_issue": "Fecha de emisión del documento."
      }
    },
    "gov_entity_data": {
      "apellidos": "Apellidos completos de la persona según el registro civil.",
      "codigoError": "Código de error devuelto por el sistema de consulta.",
      "condicionCedulado": "Condición del ciudadano en relación con su cédula.",
      "conyuge": "Nombre del cónyuge en caso de estar registrado.",
      "error": "Mensaje informativo sobre el resultado de la consulta.",
      "estadoCivil": "Estado civil actual de la persona.",
      "fechaCedulacion": "Fecha en que se emitió la cédula de identidad.",
      "fechaNacimiento": "Fecha de nacimiento del ciudadano.",
      "instruccion": "Nivel de instrucción o educación registrado.",
      "lugarNacimiento": "Provincia, ciudad y parroquia de nacimiento.",
      "nUI": "Número Único de Identificación del ciudadano.",
      "nacionalidad": "Nacionalidad registrada oficialmente.",
      "nombre": "Nombre completo del ciudadano con apellidos y nombres.",
      "nombreMadre": "Nombres y apellidos completos de la madre.",
      "nombrePadre": "Nombres y apellidos completos del padre.",
      "nombres": "Nombres propios de la persona.",
      "profesion": "Profesión u ocupación registrada en el sistema.",
      "sexo": "Sexo de la persona según registro civil.",
      "calle": "Nombre de la calle registrada como dirección.",
      "domicilio": "Dirección completa registrada en el sistema.",
      "numeroCasa": "Número de casa o domicilio registrado.",
      "fechaFallecimiento": "Fecha de fallecimiento, si aplica.",
      "firma": "Imagen digital de la firma del ciudadano.",
      "fotografia": "Imagen digital del rostro del ciudadano.",
      "provincia": "Provincia registrada en el domicilio.",
      "ciudad": "Ciudad registrada en el domicilio.",
      "parroquia": "Parroquia registrada en el domicilio.",
      "primerNombre": "Primer nombre registrado de la persona.",
      "segundoNombre": "Segundo nombre registrado de la persona.",
      "primerApellido": "Primer apellido registrado de la persona.",
      "segundoApellido": "Segundo apellido registrado de la persona."
    },
    "document_image_front_url": "Url de la imagen frontal del documento",
    "document_image_back_url": "Url de la imagen posterior del documento",
    "document_face_image_url": "Url del rostro del documento"
  }
}

Variables disponibles:

$memory.isValid_document_check: Indica si la validación del documento fue exitosa (true) o no (false)
$memory.isValid_government_entity: Indica si la validación con la entidad gubernamental fue exitosa (true) o no (false)
$memory.response_document_check_success: Respuesta completa del proceso de validación con todos los parámetros detallados

El objeto gov_entity_data dentro de response_document_check_success depende de la respuesta de la entidad gubernamental del país consultado. Los campos disponibles varían según el país (Colombia, Ecuador, Chile, México, Perú). El ejemplo mostrado corresponde a Ecuador.

Estructura para Perú (RENIEC):Dependiendo de la conexión utilizada con nuestros proveedores, la respuesta de RENIEC puede contener dos conjuntos de datos: aquellos que siempre están presentes y aquellos que solo retornan en ciertos casos.Campos siempre presentes:

{
  "documentNumber": "Número único de identificación asignado al DNI.",
  "documentType": "Tipo de documento emitido.",
  "fullName": "Nombre completo registrado en RENIEC",
  "firstName": "Primer nombre registrado en RENIEC",
  "lastName": "Apellidos completos registrados en RENIEC",
  "maternalLastName": "Apellido materno registrado en RENIEC",
  "paternalLastName": "Apellido paterno registrado en RENIEC",
  "dateOfBirth": "Fecha de nacimiento del ciudadano en formato ISO.",
  "sex": "Sexo de la persona registrado en RENIEC."
}

Campos adicionales (no siempre presentes):

{
  "address": "Dirección del domicilio registrado del ciudadano según RENIEC.",
  "civilStatus": "Estado civil del ciudadano.",
  "expeditionDate": "Fecha en que fue emitido el documento.",
  "expirationDate": "Fecha de vencimiento del documento de identidad.",
  "photo": "Fotografía oficial del ciudadano.",
  "ubigeoReniec": "Código de ubicación geográfica oficial de RENIEC.",
  "verificationDigit": "Dígito de verificación que valida el número de DNI."
}

Puedes acceder a esta información en cualquier momento del flujo usando $memory.get("isValid_document_check"), $memory.get("isValid_government_entity") o $memory.get("response_document_check_success").

🔴 Errores

Error en el Servicio

Se generó un error en el proceso de validación del documento.Variable: serviceError

Tiempo Expirado

El tiempo para completar el proceso ha expirado.Variable: timeExpiredError

Proceso Abandonado

El usuario abandonó el proceso.Variable: userExitProcess

Validación de Documento NO exitosa

No se logró validar el documento del usuario.Variable: documentCheckError

Usuario Bloqueado

Usuario Bloqueado.Variable: userBlocked

Integración

Seleccionar el skill

Te ubicas en el Skill dentro de la company donde requieres instalar este Agente. Busca en la barra de la izquierda “Skills” → “Abrir Marketplace” y allí escribes el nombre del Agente y lo descargas.

Configuración inicial

Lo primero que debes configurar es la Versión que se encuentra en “configuración avanzada”.Ninguno de los inputs es campo obligatorio porque se tienen asignados valores por defecto. Si requieres cambiarlo puedes ingresarlo en el campo correspondiente.También podrás editar los textos en caso de que el cliente requiera “customizar” el tono de la conversación.

Configurar Outputs

Este Agente cuenta con 4 outputs de error y 1 de success. Cada uno de ellos puedes dirigirlo a:

Una cajita de texto con mensaje personalizado
Al PMA (Panel Multiagente) si el cliente cuenta con este módulo

Realizar pruebas

Con la configuración que acabas de realizar, puedes proceder a realizar las pruebas utilizando como precursor un skill u otro agente.

Preguntas frecuentes

¿Este agente es considerado como proceso biométrico?

No, el proceso de “Document Check” es tan solo una “etapa” del proceso biométrico, por lo tanto no se considera como biometría facial.

¿Qué documentos se requieren durante la interacción de este proceso?

Únicamente se requiere la foto del documento de identidad.

¿Puedo deshabilitar la validación gubernamental y solo extraer la información del documento?

Sí, puedes deshabilitar la validación gubernamental en el input Habilitar validación gubernamental (false). Por defecto esta opción viene habilitada.

Empezando

Agentes IA

Nodos

Variables

Tools

Configuración

Marketplace

Identidad y firma

Enterprise

Facturación

Experiencia de usuario

Validaciones

Detección y Clasificación del Documento

Extracción y Verificación de Elementos (OCR)

Verificación de Autenticidad e Integridad

Detección de Adulteraciones Físicas

Consulta a entidad gubernamental país

Configuración

✅ Éxito

🔴 Errores

Integración

Preguntas frecuentes

Empezando

Agentes IA

Nodos

Variables

Tools

Configuración

Marketplace

Identidad y firma

Enterprise

Facturación

​Experiencia de usuario

​Validaciones

Detección y Clasificación del Documento

Extracción y Verificación de Elementos (OCR)

Verificación de Autenticidad e Integridad

Detección de Adulteraciones Físicas

​Consulta a entidad gubernamental país

​Configuración

​✅ Éxito

​🔴 Errores

​Integración

​Preguntas frecuentes

Experiencia de usuario

Validaciones

Consulta a entidad gubernamental país

Configuración

✅ Éxito

🔴 Errores

Integración

Preguntas frecuentes