Endpoint
Solicitud
Estructura de la respuesta — dos grupos distintos
Lo primero que hay que distinguir al leer una respuesta de análisis es qué campos devuelve el sistema y qué campos definió en su workflow.Campos del sistema
Se devuelven bajo las mismas claves con independencia de la configuración del workflow. Historial de ejecución, resultados por paso y métricas agregadas.
Campos del output schema
outputSchema, extractedData y extractionStatus. Su estructura interna cambia por completo de un workflow a otro.Campos del sistema
Campos del output schema
Campos de nivel superior
string
requerido
ID único del análisis (prefijo
analysis_)string
requerido
ID del perfil al que pertenece este análisis
string | null
requerido
ID de la carpeta analizada.
null cuando se analizó el perfil completo sin especificar carpetastring | null
requerido
ID del motor cuando se especificó uno explícitamente.
null cuando se usó la configuración de motores del propio workflowobject | null
requerido
Detalle del motor cuando
engineId está definido. En caso contrario, nullstring
requerido
ID del playbook usado en el análisis (prefijo
PB-). Referencia el plan de ejecución generado a partir del policy text del workflowstring
requerido
Estado de procesamiento del trabajo:
pending / processing / completed / failednumber
requerido
Tiempo de procesamiento del análisis en milisegundos
string
requerido
Veredicto del sistema para el análisis:
verified / pending_review / rejected.
Consulte Tres tipos de estado de verificación más abajonumber | null
requerido
Confianza calculada junto con el veredicto de verificación (0.0 – 1.0). Para
verified es la media de confianza de las acciones superadas; para los demás veredictos es un valor fijo según el veredicto. Es una métrica distinta de confidenceobject | null
requerido
Información de error cuando el análisis falla; contiene
code, message y, opcionalmente, details. null cuando finaliza correctamenteobject | null
Opciones enviadas al solicitar el análisis.
null si no se enviaronobject | null
Metadatos que el cliente envió al solicitar el análisis.
null si no se enviaronstring | null
ID del informe principal generado para este análisis (prefijo
rpt_)string | null
Campo heredado con el mismo valor que
primaryReportId. Use primaryReportId en integraciones nuevasstring
requerido
Momento de la solicitud del análisis (ISO 8601)
string | null
requerido
Momento de finalización del análisis (ISO 8601).
null mientras no haya terminadostring
requerido
Momento de creación del registro en base de datos (ISO 8601)
Tres tipos de estado de verificación
La respuesta contiene estado de verificación en tres capas, y los conjuntos de valores son distintos. Confirme siempre qué capa está leyendo.La segunda fila es un resultado de ejecución de acciones del playbook, no datos del output schema. Si su output schema define un campo con el mismo nombre, pertenece a la tercera fila y es independiente del veredicto del sistema.
rejected si alguna acción falló, verified si todas se superaron y pending_review en el resto de casos. agentAuditLog.summary.overall_decision se obtiene de esos mismos resultados, por lo que ambos se corresponden así.
confidenceScore frente a confidence — métricas distintas
Los nombres se parecen, pero miden cosas completamente diferentes.
confidence — Analysis Score
Este campo es el Analysis Score que aparece en la parte superior del detalle del análisis en el panel de Omni.
Los tres components se combinan en una media ponderada que produce score, y level es la banda en la que cae ese score.
confidence.components
100 / 97,22 / 76,98 dan un score de 90 y un level de HIGH.
Si algún insumo es
null porque no se pudo medir, la puntuación se normaliza con los pesos de los insumos restantes. Si los tres son null, score y level también son null.details[] — qué redujo la puntuación
Lista los elementos que bajaron la puntuación de confidence. Array vacío cuando no hubo deducciones.
riskAssessment
Nivel de riesgo derivado del resultado global del análisis.
systemMetadata — metadatos de ejecución
Información interna de ejecución registrada mientras el agente de IA realizaba el análisis.
systemMetadata.workflowHistory[]
Solo aparecen las unidades de trabajo ejecutadas. Los pasos definidos en el playbook que nunca se ejecutaron no figuran aquí. Para obtener la definición completa de pasos, consulte también
GET /workflows/:workflowId y lea workflowActions.systemMetadata.tokenUsage
tokenUsagePerWorkId asocia cada ID de trabajo a un objeto con la misma forma.
outputSchema · extractedData · extractionStatus — área del output schema
outputSchema es una instantánea congelada en el momento del análisis. Editar después el output schema del workflow no cambia el outputSchema almacenado en análisis anteriores.Campos sin valor
Cuando la IA no encuentra en los documentos el valor de un campo del schema, ese campo no se rellena enextractedData y se marca como missing en extractionStatus. Al mismo tiempo se añade una entrada OUTPUT_MISSING a details[], lo que reduce la puntuación de confidence.components.outputCompleteness.
Las claves de
extractedData coinciden siempre con los nombres de los campos de primer nivel de su output schema. Use extractionStatus para saber qué campos se rellenaron realmente.rawActionResults — resultados sin procesar por acción
Salida en bruto devuelta por cada acción de IA. Las claves son nombres de acción (actionName), y qué acciones existen depende de la definición workflowActions del workflow.
agentAuditLog — registro de auditoría del agente
Registro detallado de cada paso ejecutado por el agente de IA. Más granular que rawActionResults e incluye las llamadas a motores externos.
agentAuditLog.steps[]
agentAuditLog.steps[].mcpcalls[]
Solo tiene contenido en los pasos que invocaron un motor externo (screening AML, comparación de texto, etc.).
agentAuditLog.summary
findings[] — elementos del resultado de verificación
Resumen ordenado del resultado de cada acción, pensado para visualización.
result se corresponde con agentAuditLog.steps[].status — passed → passed, needs_review → warning, failed → failed.
recommendations[]
Acciones de seguimiento generadas por el sistema.
targetItems[] — ítems analizados
Ítems referenciados por este análisis.
Ejemplo de respuesta
El ejemplo siguiente es ficticio y sirve únicamente para ilustrar la estructura. Los campos dentro de
outputSchema y extractedData varían según el workflow.Referencia de enumeraciones
- Estado del análisis
- Veredicto de verificación
- Estado de paso
- Resultado de finding
- Nivel de riesgo