> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Conceptos clave
> La jerarquía de datos, los playbooks, el ciclo de vida del análisis, los valores de veredicto y las categorías de crédito, todo en una página.
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`](/es/omni/api-reference/get-analysis) 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.
```json theme={null}
"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](/es/omni/guides/reading-analysis-results).
## 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](/es/omni/dashboard/project/credit-usage) del panel.
## Siguientes pasos
De crear un proyecto a leer su primer resultado de análisis.
El sobre de `extractedData`, los motivos de los valores ausentes y el registro de auditoría.