Introducción y modelo de la API
La Scoring API de vario es una API REST stateless que analiza texto en busca de señales de conductas irregulares en comunicaciones corporativas. Por cada request, devuelve un score de riesgo junto con contexto regulatorio estructurado: frases clave, marcos normativos aplicables y una recomendación de acción.
Modelo stateless
vario no almacena ni retiene el texto analizado. Cada llamada a POST /v1/analyze es independiente: el texto entra, se analiza, y el resultado se retorna en el response. Nada persiste en la base de datos del lado de vario.
Este diseño es deliberado. Los compradores forenses y de e-discovery con frecuencia trabajan sobre comunicaciones privilegiadas de sus clientes — comunicaciones que no pueden custodiarse en sistemas de terceros. El modelo stateless de vario hace que esa restricción no sea un obstáculo técnico.
cliente
│
│ POST /v1/analyze
│ { text, playbook, language, mode }
▼
┌──────────────────────────────────────┐
│ análisis stateless │
│ (el texto no se almacena en DB) │
└──────────────────────────────────────┘
│
│ 200 OK
│ { combined_score, should_alert,
│ severity, reasoning,
│ key_phrases, regulatory_frameworks,
│ recommended_action, ... }
▼
cliente
Caso de uso principal
La Scoring API está diseñada para firmas forenses y de e-discovery que necesitan clasificar grandes volúmenes de comunicaciones corporativas para identificar cuáles requieren revisión manual.
Un caso típico: una firma tiene 80.000 documentos de un corpus de investigación. Enviarlos todos a revisión humana es inviable en tiempo y costo. Con la API, el equipo puede procesar el corpus completo, filtrar los documentos con should_alert: true, y concentrar la revisión en los que el sistema marcó como de riesgo.
El output de la API — el score, las frases clave, el marco regulatorio y la recomendación — está estructurado para mapear directamente a los flujos de trabajo de plataformas de e-discovery como Relativity o Nuix.
Qué analiza la API
La API detecta señales de nueve conductas irregulares en comunicaciones corporativas:
| Conducta | Valor del campo playbook | Idiomas |
|---|---|---|
| Coordinación de precios | price_fixing | es, en |
| Manipulación de licitaciones | bid_rigging | es, en |
| Soborno y anticorrupción | bribery | es, en |
| Abuso de mercado | market_manipulation | es, en |
| Intercambio de información | information_exchange | es, en |
| Boicot colectivo | group_boycott | es, en |
| Conflicto de interés no declarado | conflict_of_interest | es, en |
| Uso de información privilegiada | insider_trading | es, en |
| Fraude interno y malversación | internal_fraud | es, en |
Estas conductas corresponden a categorías regulatorias cubiertas por marcos como CADE, COFECE, FNE, CNDC, FCPA, Ley 27.401, Lei Anticorrupção, MAR y CMF, entre otros. La API retorna en el campo regulatory_frameworks los marcos aplicables al análisis de cada request.
Para consultar el catálogo actualizado de playbooks disponibles, usa GET /v1/playbooks.
Modos de análisis
Cada llamada a POST /v1/analyze acepta un parámetro mode que controla la profundidad del análisis y el costo en créditos:
| Modo | Descripción | Créditos por llamada | Latencia típica |
|---|---|---|---|
screening | Solo capa L1 (keyword + embedding, sin LLM). Descarte masivo de documentos irrelevantes. | 1 crédito | ~50 ms |
fast | L1 + L2 (LLM ligero). Clasificación con precisión moderada. | 2 créditos | ~200 ms |
full | L1 + L2 + L3 (LLM profundo). Análisis con razonamiento completo y mayor precisión. | 3 créditos | ~2–8 s |
El modo por defecto es "full". Para triage de grandes volúmenes, la práctica recomendada es un embudo de tres etapas: "screening" para descartar el grueso del corpus, "fast" sobre los documentos que superaron el umbral L1, y "full" para los que requieren análisis profundo. Ver Créditos y modos para el patrón detallado.
Precisión del sistema de detección
El sistema de detección de vario ofrece alta precisión validada, con cobertura específica para comunicaciones corporativas en español y portugués de contexto latinoamericano. Los playbooks tienen en cuenta terminología y patrones de lenguaje propios de los casos investigados por reguladores como CADE, COFECE y FNE.
Comenzar
Consulta el Quickstart para registrarte, obtener tu API key y enviar tu primer request en menos de cinco minutos.