Leer resultados de análisis

​

El orden de lectura

​

El sobre de extractedData

{
  "extractedData": {
    "company": {
      "legal_name": {
        "value": "ACME TRADING LLC",
        "reasoning": "The legal name on the certificate of good standing matches the account holder on the bank verification letter.",
        "sourceStep": 1
      },
      "state_file_number": {
        "value": null,
        "reasoning": "The state file number was not included in the extraction result.",
        "sourceStep": 1
      }
    },
    "ubo_register": [
      { "name": { "value": "John Carter", "reasoning": "Row 1 of the beneficial ownership certification", "sourceStep": 6 },
        "share_pct": { "value": 60, "reasoning": "Row 1 of the beneficial ownership certification", "sourceStep": 6 } }
    ]
  }
}

• Un campo que no obtuvo valor mantiene su sitio, con value: null. La lista de campos de extractedData siempre coincide con el output schema.
• Cuando el propio objeto padre no se produjo, las rutas por debajo no se crean. En ese caso, details[] lleva una entrada para el padre con reasonCode: "PARENT_MISSING".
• reasoning se guarda en el momento en que el análisis se completa. Volver a leer el análisis nunca lo cambia.
• sourceStep es un número de orden de ejecución, así que puede cambiar a partir del siguiente análisis si edita el workflow. Para señalar un paso de forma fiable, use agentAuditLog.steps[].work_id.
• 0 y false son valores válidos. Vacío significa null / "" / [] / {}.

​

Cuando no hay sobre

​

Por qué un campo está vacío

{
  "category": "JSON_OUTPUT",
  "type": "OUTPUT_MISSING",
  "target": "company.state_file_number",
  "reasonCode": "NOT_IN_FINAL_OUTPUT",
  "message": "The legal name and the registered agent were confirmed on the certificate, but no state file number entry was found.",
  "stepId": 1
}

• reasonCode es un enumerado ampliable. Maneje sin error un valor fuera de la tabla. Es un eje distinto de type (un conjunto fijo de seis, como OUTPUT_MISSING y OUTPUT_EMPTY).
• reasonCode, message y stepId aparecen solo en entradas JSON_OUTPUT, nunca en entradas STEP ni TOOL.
• message son los fundamentos que registró el paso responsable, mientras que el reasoning del sobre da el motivo a nivel de campo. Las dos frases pueden diferir, así que lea primero reasoning para el contexto del campo.
• target es una ruta de instancia real. Los arrays se despliegan por índice, uno por elemento (ubo_register[0].name). Un array vacío, o una clave de array ausente, cuenta como una sola entrada ubo_register.
• Omni no vuelve a examinar el documento original. Nunca afirma que “el valor no estaba en el documento”; lo máximo que dice es que “no se incluyó en el resultado de la extracción” (NOT_IN_FINAL_OUTPUT).

​

Cuando no se puede suministrar un motivo

​

No use extractionStatus

​

Leer los veredictos

​

confidence frente a confidenceScore

​

Qué playbook produjo este veredicto

​

Leer el registro de auditoría

• Identificar un paso: step es el orden de ejecución y work_id es el ID fijo de la acción del playbook. Se corresponde con workflowActions[].workId de GET /workflows/:workflowId.
• Veredictos de paso: status (passed / needs_review / failed) y reasoning son lo que la pestaña Summary muestra como línea de razonamiento en el panel. rule es la instrucción que llevó a cabo ese paso.
• Llamadas a motores externos: juzgue el fallo por success y error_code en mcpcalls[]. No hay código de estado HTTP. fallback_to_rag: true significa que, tras fallar el motor, se recurrió a la búsqueda documental.
• Para ver esas mismas llamadas organizadas por acción, use rawActionResults.{acción}.mcpResults[]. Ese lado usa camelCase (durationMs, errorCode, fallbackToRag).
• Un paso que nunca se ejecutó tampoco aparece en systemMetadata.workflowHistory[]. Las definiciones completas de los pasos están en workflowActions de la respuesta del workflow, y un paso no ejecutado queda registrado en details[] como STEP_NOT_EXECUTED.

​

Un patrón para el procesamiento posterior

a = get_analysis(analysis_id)
if a["status"] != "completed":
    return retry_later()

fmt = a.get("systemMetadata", {}).get("outputFormatting")
raw_mode = fmt is None and a["outputSchema"] is None or (fmt and fmt["status"] in ("skipped", "fallback_raw"))

if a["verificationStatus"] == "verified" and a["confidence"]["score"] >= 80 and not raw_mode:
    approve(a["extractedData"])
elif a["verificationStatus"] == "rejected":
    reject(reason=[s for s in a["agentAuditLog"]["steps"] if s["status"] == "failed"])
else:
    route_to_reviewer(a, missing=[d for d in a["details"] if d["category"] == "JSON_OUTPUT"])

• Mostrar a un revisor el target, el reasonCode y el message de details[] junto al reasoning del sobre hace que encuentre la causa mucho antes.
• Volver a analizar el mismo perfil tras mejorar los ítems emite un analysisId nuevo. El resultado anterior se conserva, y puede compararlos con el selector de ejecución del panel.
• Cuando necesite un informe que pueda leer una persona, obtenga el PDF con GET /analyses/:analysisId/report.