Recursos · 81
Extracción con IA: validar JSON antes de integrarlo
Separar análisis sintáctico, esquema, evidencia documental y reglas de negocio para convertir documentos en datos utilizables.
Actualizado · 4 min
Lo que esta guía ayuda a lograr
- Definir el contrato del resultado
- Vincular cada valor con una evidencia
- Validar en un orden explícito
- Probar documentos difíciles
- Preparar recuperación y corrección
Comprobación rápida
- ¿Puede un JSON válido contener un error?
- ¿Debe un campo ausente convertirse en cero?
- ¿Cuándo se necesita revisión humana?
Método paso a paso
- 1
Definir el contrato del resultado
Enumere los campos necesarios, sus tipos, unidades y estados de ausencia. JSON Schema distingue propiedades descritas y campos obligatorios: declarar una propiedad no la convierte en obligatoria. Decida si se admiten campos adicionales. Conserve la versión del esquema en cada lote y evite recoger campos sin una finalidad.
Entregable: esquema versionado y ejemplos aceptados o rechazados.
- 2
Vincular cada valor con una evidencia
Solicite referencias a página, pasaje o celda para los valores que desencadenan una acción. Permita un estado desconocido cuando falte información. Un importe con el tipo correcto puede pertenecer a otro documento; una fecha plausible puede ser la de emisión en lugar del vencimiento.
Entregable: relación entre campo, fuente y regla de interpretación.
- 3
Validar en un orden explícito
Compruebe primero el análisis JSON, después el esquema y finalmente reglas de negocio: moneda permitida, identificador existente, suma de líneas y cronología. La conformidad con el esquema no garantiza exactitud ni autorización para escribir en un sistema. Bloquee la acción hasta reunir sus condiciones.
Entregable: clases de error y decisiones de aceptación separadas.
- 4
Probar documentos difíciles
Incluya tablas divididas, varios idiomas, valores contradictorios, documentos vacíos e instrucciones hostiles dentro del texto. Pruebe rechazos, truncamiento y reintentos. Mantenga casos de evaluación independientes del ajuste y compare errores por campo, sin convertir una tasa global en garantía.
Entregable: conjunto de referencia y errores críticos.
- 5
Preparar recuperación y corrección
Relacione documento, versión del modelo, esquema y resultado con un identificador de procesamiento. Un reintento no debe crear dos registros. Conserve la justificación de las correcciones humanas y localice las salidas derivadas. Evite copiar documentos completos en registros sin necesidad.
Entregable: procedimiento de corrección y reintento controlado.
Del resultado legible a la acción autorizada
Superar una comprobación no sustituye la siguiente. Detenga el proceso si falta una condición necesaria.
Analizar JSON
¿La respuesta está completa y puede analizarse?
Validar el contrato
¿Tipos, campos, unidades y ausencias corresponden al esquema?
Verificar valores
¿Las fuentes y reglas de negocio respaldan los valores?
Autorizar la acción
¿Se cumplen identidad, alcance y condiciones de escritura?
Ejemplo ficticio: pasan análisis y esquema, pero dos importes se contradicen. La escritura queda bloqueada y el registro pasa a revisión.
Hoja de cálculo reutilizable
Complete con sus observaciones autorizadas. Estos campos son una plantilla de trabajo, no resultados observados.
| Campo | Información a registrar |
|---|---|
| Contrato | Campos, tipos, unidades, ausencia y versión del esquema |
| Evidencia | Documento y pasaje de cada campo decisivo |
| Validación | Análisis JSON, esquema, reglas de negocio y motivo del rechazo |
| Recuperación | Identificador de procesamiento, duplicados evitados y correcciones propagadas |
Ejemplo trabajado ficticio
Situación ilustrativa
Ejemplo ficticio: un extractor encuentra dos totales de factura y selecciona el importe sin impuestos, pero el conector espera el importe a pagar.
Decisión y pruebas esperadas
El esquema acepta el número; la conciliación de líneas y moneda bloquea la escritura y envía el documento a revisión.
Distinguir los mecanismos
| Mecanismo | Propósito | Verificación o limitación |
|---|---|---|
| JSON legible | Permitir el análisis sintáctico | No valida campos esperados ni significado |
| Conformidad del esquema | Comprobar tipos y restricciones | No demuestra fidelidad al documento |
| Conciliación de negocio | Comprobar utilidad y coherencia | Necesita reglas y referencias explícitas |
Indicadores de gestión
| Indicador | Qué mide | Primera acción |
|---|---|---|
| Exactitud por campo | Valores correctos entre los campos evaluables | Priorizar errores que cambien una acción |
| Abstención útil | Casos sin decisión por falta de evidencia | Revisar la cola sin incentivar valores inventados |
| Duplicados al reintentar | Registros repetidos para una operación | Corregir la deduplicación |
Errores comunes
- No valida campos esperados ni significado
- No demuestra fidelidad al documento
- Necesita reglas y referencias explícitas
Preguntas frecuentes
¿Puede un JSON válido contener un error?
Sí. Puede cumplir sintaxis y esquema y contener un importe, identidad o fecha incorrectos. Contraste los valores decisivos con sus fuentes.
¿Debe un campo ausente convertirse en cero?
Solo si el contrato asigna ese significado a cero. En otro caso utilice el estado de ausencia previsto; los valores inventados alteran los cálculos.
¿Cuándo se necesita revisión humana?
Cuando una contradicción, evidencia ausente o error crítico quede fuera del alcance aceptado. Defina esos casos antes de procesar lotes.
Referencias oficiales
Las referencias respaldan el método. Adapte los controles a su contexto; no constituyen certificación. Los títulos de referencia originales y los documentos fuente pueden estar en otro idioma.
Referencias consultadas el .
