Skip to main content
Esta página cubre solo las definiciones de campos. El orden en que leer la respuesta y cómo interpretarla están en leer resultados de análisis.

Endpoint

Petición

Parámetros de ruta

Estructura de la respuesta

Los campos de la respuesta se dividen en dos grupos.
Qué campos aparecen en extractedData lo decide el output schema del workflow. Omni no impone ninguna clave común. Lo que sí es fijo es que cada valor final va envuelto en el mismo sobre (value · reasoning · sourceStep).

Campos de nivel superior


confidence Analysis Score

La puntuación que aparece en la parte superior de la pantalla de detalle del análisis en el panel.

confidence.components

Cuando una parte es null, los pesos de las restantes se normalizan. Cuando las tres son null, score y level también son null.

details penalizaciones de la puntuación

Enumera cada elemento que bajó la puntuación confidence. Array vacío si no se penalizó nada. reasonCode es un enumerado ampliable. Los valores actuales y cómo leerlos están en leer resultados de análisis.

riskAssessment

Cómo se calcula riskScore

Se calcula solo a partir de los veredictos por acción. El contenido de los documentos y los resultados de extracción no intervienen.
La base es 25, así que riskScore nunca baja de 25. Cuando todas las acciones pasan, es exactamente 25 (low). El rango 0–25 de la tabla anterior es el límite del nivel; en la práctica no se dan valores de 0 a 24.
riskFactors lleva una línea {actionName} verification failed por cada acción fallida, más una única línea {count} action(s) need manual review cuando alguna acción requiere revisión.

systemMetadata

systemMetadata.outputFormatting

Bifurque según este status antes de leer extractedData. Cómo hacerlo está en leer resultados de análisis.

systemMetadata.workflowHistory

Contiene solo el trabajo que se ejecutó realmente. Las definiciones completas de los pasos están en workflowActions de GET /workflows/:workflowId.

systemMetadata.tokenUsage

tokenUsagePerWorkId usa los IDs de trabajo como claves y la estructura anterior como valores.

rawActionResults

Los resultados brutos, previos al ensamblado, que devolvieron las acciones. Las claves son nombres de acción, y qué acciones existen depende de la definición workflowActions del workflow.

rawActionResults mcpResults

Las mismas llamadas que agentAuditLog.steps[].mcpcalls[], organizadas por acción. Usa camelCase, como el nivel superior.

agentAuditLog

Un objeto con dos claves, steps y summary.
agentAuditLog es un objeto, no un array, y sus campos internos usan snake_case (work_id · executed_at · duration_ms). Eso difiere del camelCase de los campos de nivel superior.

agentAuditLog.steps

agentAuditLog.steps mcpcalls

agentAuditLog.summary


findings

result es agentAuditLog.steps[].status traducido para la interfaz (needs_review pasa a warning).

recommendations

targetItems


Ejemplo de respuesta

Una respuesta real es mucho más larga. El ejemplo siguiente incluye todas las claves de nivel superior pero muestra una sola entrada representativa por array y objeto anidado.

Resumen de enumerados

Códigos de error

Los errores comunes (400 validación · 401 autenticación · 403 permisos · 500 servidor) están en la descripción general de la API.