Endpoint
Petición
Parámetros de ruta
Estructura de la respuesta
Los campos de la respuesta se dividen en dos grupos.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
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.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
- status
- verificationStatus
- Resultado de paso
- findings result
- riskLevel
- outputFormatting.status
- reasonCode
- snapshotStatus
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.