Inicio rápido - ARGOS Identity

Va a construir un workflow que verifica los tres documentos que presentó un proveedor y, después, a crear un perfil y obtener un resultado de análisis por API.

Cómo usar Omni

Usted le indica a su Review Ops Agent cómo se hace el trabajo en el panel, y lo ejecuta para cada sujeto por API.

Diagrama del flujo de proceso de Omni — Configuración (política, motores, output schema) → ingesta de datos (OCR, normalización) → análisis y validación → generación del informe, el JSON y el registro de auditoría → entrega a su servidor.

Componentes

Política en lenguaje natural

Escriba cómo se hace el trabajo y sus criterios de decisión como frases corrientes. Una cláusula se convierte en un paso de ejecución.

Asignación automática de motores

Nunca elige qué motor necesita una comprobación. Los motores se adjuntan a partir del contenido de la política, y el orden de ejecución se decide por usted.

Output schema

Defina la estructura JSON que recibe. Los resultados llegan con la forma exacta que espera su sistema, sin conversiones posteriores.

Fundamentos de cada veredicto

No solo obtiene valores, sino por qué cada valor salió así, con el registro paso a paso y todas las consultas externas en el registro de auditoría.

El flujo completo

Configure el workflow (panel)

Escriba la política y defina el output schema que quiere recibir. Al guardar se genera el playbook.

Cree un perfil (API)

Cree un perfil por sujeto de verificación. Un proveedor o un solicitante es un perfil.

Añada documentos (API)

Suba los documentos al perfil. Las imágenes y los PDF pasan por OCR; los documentos de ofimática, por extracción de texto.

Ejecute el análisis (API)

El playbook se ejecuta en orden y usted recibe el veredicto junto con resultados con la forma de su output schema.

Crear y editar workflows ocurre solo en el panel. Todo lo demás se puede automatizar por API. El paso 1 lo ejecuta usted en la sección 1 y los pasos 2–4, en la sección 2.

1. Cree un proyecto y un workflow en el panel

Cree un proyecto

En el panel, seleccione Create Project e introduzca un nombre y una descripción. Esta documentación usa como ejemplo un proyecto llamado Demo.Junto con el proyecto se emite una API key. La encontrará en la pestaña API Key de la configuración del proyecto — gestión de la API key.

Cree un workflow

Dentro del proyecto, seleccione Create New Workflow para abrir el asistente de cuatro pasos.

Información básica — llámelo Vendor Onboarding Document Verification Policy
Definición de la política — escriba en lenguaje natural qué verifica y con qué criterios
Modelo de IA — sin elección, se usa el modelo por defecto
Output schema — defina la estructura JSON que quiere recibir de un análisis

Al guardar se genera un playbook (el plan de ejecución) a partir del texto de la política. Tarda 2–3 minutos. El procedimiento completo está en crear un workflow.

Ya tiene los dos valores que necesita el resto de esta página: una API key y un ID de workflow (prefijo wf_). También puede obtener el ID del workflow leyendo el proyecto.

curl "https://client-omni-api.argosidentity.com/v1/projects/proj_75hgxoxamzn9" \
  -H "x-api-key: your-api-key-here"

2. Ejecute un análisis con la API

Cree un perfil

Un perfil es la unidad que contiene un sujeto de verificación. Un proveedor o un solicitante es un perfil.

curl -X POST "https://client-omni-api.argosidentity.com/v1/workflows/wf_3p8k2m5r9v1t/profiles" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "example",
    "description": "Example profile for document verification",
    "metadata": { "vendor_id": "VND-2026-0142" }
  }'

El id de la respuesta es el ID del perfil, y folders[0].id es la carpeta por defecto creada con él. Necesita ambos en el paso siguiente.

{
  "id": "pf_6h4y8s2f0v9n",
  "folders": [{ "id": "fd_9pq2mklt83bx", "name": "default", "isDefault": true }]
}

Añada los documentos

Suba los documentos a la carpeta por defecto. Puede enviar un archivo o texto plano.

curl -X POST "https://client-omni-api.argosidentity.com/v1/folders/fd_9pq2mklt83bx/items/upload" \
  -H "x-api-key: your-api-key-here" \
  -F "file=@/path/to/certificate-of-good-standing.pdf" \
  -F "name=certificate of good standing" \
  -F "metadata={\"doc_type\":\"certificate_of_good_standing\"}"

Anote el id (prefijo item_) de la respuesta: lo pasará en la petición de análisis. Añada los tres documentos de la misma forma.

Un archivo está limitado a 10MB, y un perfil a 100MB de subidas en total. No hay límite de cantidad por carpeta. Los formatos admitidos están en añadir un ítem, y un formato que no esté en esa lista se rechaza al subirlo.

Espere a que termine el procesamiento

Un ítem añadido pasa por la extracción de texto y avanza de PENDING a ACTIVE. Todos los ítems deben estar ACTIVE antes de poder ejecutar un análisis.

curl "https://client-omni-api.argosidentity.com/v1/profiles/pf_6h4y8s2f0v9n/items/status" \
  -H "x-api-key: your-api-key-here"

{
  "profileId": "pf_6h4y8s2f0v9n",
  "isRagReady": true,
  "summary": { "total": 3, "pending": 0, "active": 3, "failed": 0 },
  "items": [
    {
      "id": "item_axfkh2noof85",
      "name": "certificate of good standing",
      "type": "file",
      "status": "ACTIVE",
      "processedAt": "2026-09-10T05:35:38.902Z"
    }
  ]
}

Sondee una vez por segundo hasta que isRagReady sea true, y deténgase a los 60 segundos. Un ítem que a esas alturas siga sin estar ACTIVE es más rápido de eliminar y volver a subir.

Ejecute el análisis

Pase los IDs de los ítems a incluir en targetItems. La política, los motores y el output schema del workflow se aplican automáticamente.

curl -X POST "https://client-omni-api.argosidentity.com/v1/analyses/pf_6h4y8s2f0v9n/analyze" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "targetItems": [
      { "itemId": "item_axfkh2noof85" },
      { "itemId": "item_lxzzl2vedy9y" },
      { "itemId": "item_wfepr5xxo6w2" }
    ]
  }'

Los análisis son asíncronos. La respuesta devuelve solo el ID del análisis, de inmediato.

{ "id": "analysis_lsc7icgm9cjd" }

Lea el resultado

Sondee el estado con el ID del análisis y lea el resultado cuando status sea completed.

curl "https://client-omni-api.argosidentity.com/v1/analyses/analysis_lsc7icgm9cjd" \
  -H "x-api-key: your-api-key-here"

{
  "status": "completed",
  "verificationStatus": "verified",
  "confidence": { "score": 98, "level": "HIGH" },
  "extractedData": {
    "company": {
      "legal_name": {
        "value": "ACME TRADING LLC",
        "reasoning": "Read from the entity name field on the certificate of good standing.",
        "sourceStep": 1
      }
    }
  }
}

Hay tres cosas que leer.

Campo	Qué es
`verificationStatus`	El veredicto de todo el análisis — `verified` · `pending_review` · `rejected`
`confidence.score`	El Analysis Score. Cuán completa quedó la salida (0–100)
`extractedData`	Los valores extraídos según su output schema. Los campos finales van envueltos en un sobre `value` · `reasoning` · `sourceStep`

Cuando necesite un PDF para que lo lea una persona, obténgalo con GET /analyses/:analysisId/report.

Siguientes pasos

Leer resultados de análisis

La estructura del sobre, por qué un campo está vacío y el orden en que leer los veredictos.

Conceptos clave

La jerarquía de datos del proyecto al análisis, y qué es un playbook.

Crear un workflow

Todo el procedimiento en el panel, de la política al output schema.

Referencia de la API

Definiciones completas de los 23 endpoints.

​Cómo usar Omni

​Componentes

Política en lenguaje natural

Asignación automática de motores

Output schema

Fundamentos de cada veredicto

​El flujo completo

​1. Cree un proyecto y un workflow en el panel

​2. Ejecute un análisis con la API

​Siguientes pasos

Leer resultados de análisis

Conceptos clave

Crear un workflow

Referencia de la API

Cómo usar Omni

Componentes

El flujo completo

1. Cree un proyecto y un workflow en el panel

2. Ejecute un análisis con la API

Siguientes pasos