Skip to main content

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.
Lo que aparece dentro de extractedData lo determina el output schema que definió en su workflow. Omni no impone un conjunto fijo de campos. Esta página documenta campo a campo únicamente los campos del sistema; el área del output schema se describe solo de forma estructural.

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 carpeta
string | null
requerido
ID del motor cuando se especificó uno explícitamente. null cuando se usó la configuración de motores del propio workflow
object | null
requerido
Detalle del motor cuando engineId está definido. En caso contrario, null
string
requerido
ID del playbook usado en el análisis (prefijo PB-). Referencia el plan de ejecución generado a partir del policy text del workflow
string
requerido
Estado de procesamiento del trabajo: pending / processing / completed / failed
number
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 abajo
number | 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 confidence
object | null
requerido
Información de error cuando el análisis falla; contiene code, message y, opcionalmente, details. null cuando finaliza correctamente
object | null
Opciones enviadas al solicitar el análisis. null si no se enviaron
object | null
Metadatos que el cliente envió al solicitar el análisis. null si no se enviaron
string | 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 nuevas
string
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 terminado
string
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.
El veredicto de nivel superior se decide agregando los resultados por acción: 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.
Un confidenceScore alto no implica un confidence.score alto. El caso clásico: la IA aprobó con confianza todos los pasos pero no se rellenó ni un solo valor del output schema. Si construye lógica de aprobación automática, revise también confidence y details.

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

Por ejemplo, unos componentes de 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

La estructura interna de estos tres campos sigue íntegramente el output schema de su workflow. No existe un conjunto de campos común definido por Omni. Un workflow distinto significa nombres de clave y anidamiento distintos.
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 en extractedData 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 es un objeto, no un array, y sus campos internos usan snake_case (executed_at, item_ids, duration_ms). Difiere de la convención camelCase del nivel superior de la respuesta — tenga cuidado al parsear.

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[].statuspassedpassed, needs_reviewwarning, failedfailed.

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