Conceptos clave - ARGOS Identity

Estos conceptos aparecen a lo largo de toda la documentación de Omni. Trabaje en el panel o con la API, los términos de esta página son los que se usan para explicarlo.

Jerarquía de datos

Project                 Proyecto — la unidad de API keys, miembros y créditos
└── Workflow            Workflow — política + playbook + output schema
    └── Profile         Perfil — un sujeto de verificación (un proveedor, por ejemplo)
        └── Folder      Carpeta — un grupo de documentos dentro de un perfil (se crea una por defecto)
            └── Item    Ítem — un archivo, texto o JSON
        └── Analysis    Análisis — el resultado de verificar todo el perfil con el playbook

Nivel	Prefijo de ID	Se crea en	Límite
Project	`proj_`	Panel	5 por usuario
Workflow	`wf_`	Panel	10 por proyecto
Profile	`pf_`	Panel · API	Sin límite por workflow
Folder	`fd_`	Panel · API	Varias por perfil, con una carpeta por defecto creada automáticamente
Item	`item_`	Panel · API	Sin límite de cantidad. 10MB por archivo, 100MB en total por perfil
Analysis	`analysis_`	Panel · API	10 al día en un proyecto de prueba

Los proyectos y los workflows se crean solo en el panel. La API key se emite por proyecto, y solo puede trabajar con los workflows, perfiles, ítems y análisis de ese proyecto.

Workflows y playbooks

Un workflow se compone de una política (lenguaje natural), un modelo de IA y un output schema. Al guardar un workflow, Omni lee la política y construye un playbook: el plan de ejecución que sigue realmente un análisis.

Componente	Descripción	Campo de la API
ID del playbook	Con formato `PB-YYYYMMDD-XXXXXX`. Solo se reemite cuando el playbook se regenera porque cambió el texto o un documento de la política	`playbookId`
Versión del playbook	La versión de parche aumenta cada vez que edita acciones, motores o notas de referencia. El ID no cambia	`playbookVersion`
Acción	Un paso del playbook. Tiene nombre (`snake_case`) y descripción, y se ejecuta en orden	`workflowActions[]`
ID de acción	El identificador estable de una acción. No cambia al reordenar	`workflowActions[].workId`, y `work_id` en el registro de auditoría
Motor de paso	El motor de verificación externo adjunto a una acción (una búsqueda AML, por ejemplo). Se adjunta automáticamente a partir de la política y se puede cambiar en la pantalla de edición	`workflowActions[].engines[]`
Notas de referencia	Instrucciones adicionales que se dan al agente por acción. Hasta 20 por acción, de 500 caracteres cada una	`workflowActions[].referenceNotes[]`

Editar el playbook no cambia los análisis ya terminados. Un análisis congela y guarda el playbook tal como estaba al ejecutarse, y playbookSnapshot, playbookVersion y snapshotStatus en la respuesta indican qué versión se usó.

Ciclo de vida del análisis

POST /analyses/:id/analyze  →  pending  →  processing  →  completed
                                                       └→  failed

Estado	Significado	Qué hacer
`pending`	En cola	Siga sondeando
`processing`	El agente está ejecutando el playbook	Siga sondeando
`completed`	El resultado es definitivo	Bifurque según `verificationStatus`
`failed`	La ejecución falló. Consulte `error.code` y `error.message`	Revise el estado de los ítems y vuelva a ejecutarlo

Los análisis son asíncronos. La petición devuelve 202 Accepted y un analysisId de inmediato, y usted sondea GET /analyses/:analysisId para obtener el resultado. Mientras hay un análisis en curso en un perfil, una nueva petición sobre ese perfil se rechaza con 409. Para ejecutar un análisis, todos los ítems del perfil deben estar ACTIVE.

Estado del ítem	Significado
`PENDING`	Subido, con la extracción de texto (OCR) en curso
`ACTIVE`	Listo para usarse en un análisis
`FAILED`	El procesamiento falló. Elimínelo y vuelva a subirlo

Tres niveles de veredicto

El resultado de un análisis lleva veredictos en tres niveles distintos. Bifurque su procesamiento posterior según el verificationStatus de nivel superior.

Nivel	Campo	Valores
Todo el análisis	`verificationStatus`	`verified` · `pending_review` · `rejected`
Un paso del playbook	`agentAuditLog.steps[].status`	`passed` · `needs_review` · `failed`
Una comprobación concreta	`findings[].result`	`passed` · `warning` · `failed`

`verificationStatus`	Cómo se decide	Tratamiento recomendado
`verified`	Todos los pasos `passed`	Aprobar automáticamente
`pending_review`	Al menos un paso en `needs_review`	Enviar a una cola de revisión
`rejected`	Al menos un paso `failed`	Rechazar o escalar

Analysis Score

Una medida de 0 a 100 de cuán completamente se llevó a cabo el análisis tal como estaba definido. No es la confianza de la IA. La API lo proporciona como el objeto confidence.

Parte	Peso	Cómo se calcula
Step Execution	40%	Proporción de los pasos del playbook que se ejecutaron realmente
Step Quality	20%	Si los pasos ejecutados pasaron, y si se llamó a sus motores asignados
Output Completeness	40%	Proporción de campos finales del output schema que recibieron un valor (los arrays se cuentan por elemento)

La puntuación recibe un nivel de HIGH (80–100), MEDIUM (65–79) o LOW (0–64). confidenceScore (0–1) es independiente: es la confianza que registró el agente, y puede estar vacío.

Output schema y datos extraídos

El output schema es un JSON Schema que usted define por workflow. extractedData en el resultado de un análisis sigue esa estructura exactamente, y cada campo final trae su valor junto con los fundamentos.

"company": {
  "legal_name": {
    "value": "ACME TRADING LLC",
    "reasoning": "Extracted from the entity name field on the certificate of good standing",
    "sourceStep": 1
  }
}

Un workflow sin esquema, o un análisis en el que falló el ensamblado, devuelve la estructura bruta por acción, sin este sobre. Cómo distinguirlo, y cómo leer un campo que volvió vacío, está en leer resultados de análisis.

Créditos

El uso de créditos de un proyecto se agrupa en tres categorías.

Categoría	Se cobra	Ejemplo
Environment	00:00 UTC diario, sea cual sea el estado del proyecto	Mantener un workflow disponible
Operation	Cuando una petición a la API tiene éxito	Crear un perfil, añadir un ítem de archivo, ejecutar un análisis
Tools	Cuando una llamada a un motor externo durante un análisis tiene éxito	Búsqueda AML

El desglose está en la pestaña uso de créditos del panel.

Siguientes pasos

Inicio rápido

De crear un proyecto a leer su primer resultado de análisis.

Leer resultados de análisis

El sobre de extractedData, los motivos de los valores ausentes y el registro de auditoría.

​Jerarquía de datos

​Workflows y playbooks

​Ciclo de vida del análisis

​Tres niveles de veredicto

​Analysis Score

​Output schema y datos extraídos

​Créditos

​Siguientes pasos

Inicio rápido

Leer resultados de análisis

Jerarquía de datos

Workflows y playbooks

Ciclo de vida del análisis

Tres niveles de veredicto

Analysis Score

Output schema y datos extraídos

Créditos

Siguientes pasos