Introdução e modelo da API
A Scoring API do vario é uma API REST stateless que analisa textos em busca de sinais de condutas irregulares em comunicações corporativas. Para cada requisição, ela retorna um score de risco junto com contexto regulatório estruturado: frases-chave, marcos normativos aplicáveis e uma recomendação de ação.
Modelo stateless
O vario não armazena nem retém o texto analisado. Cada chamada a POST /v1/analyze é independente: o texto entra, é analisado, e o resultado é retornado na resposta. Nada persiste no banco de dados do vario.
Esse design é deliberado. Compradores forenses e de e-discovery frequentemente trabalham com comunicações privilegiadas de seus clientes — comunicações que não podem ser custodiadas em sistemas de terceiros. O modelo stateless do vario faz com que essa restrição não seja um obstáculo técnico.
cliente
│
│ POST /v1/analyze
│ { text, playbook, language, mode }
▼
┌──────────────────────────────────────┐
│ análise stateless │
│ (o texto não é armazenado no BD) │
└──────────────────────────────────────┘
│
│ 200 OK
│ { combined_score, should_alert,
│ severity, reasoning,
│ key_phrases, regulatory_frameworks,
│ recommended_action, ... }
▼
cliente
Caso de uso principal
A Scoring API é projetada para escritórios forenses e de e-discovery que precisam classificar grandes volumes de comunicações corporativas para identificar quais requerem revisão manual.
Um cenário típico: um escritório tem 80.000 documentos em um corpus de investigação. Enviar todos para revisão humana é inviável em tempo e custo. Com a API, a equipe pode processar o corpus completo, filtrar os documentos com should_alert: true e concentrar a revisão naqueles que o sistema marcou como de risco.
O output da API — o score, as frases-chave, o marco regulatório e a recomendação — é estruturado para mapear diretamente aos fluxos de trabalho de plataformas de e-discovery como Relativity ou Nuix.
O que a API analisa
A API detecta sinais de nove tipos de condutas irregulares em comunicações corporativas:
| Conduta | Valor do campo playbook | Idiomas |
|---|---|---|
| Fixação de preços | price_fixing | es, en |
| Fraude em licitações | bid_rigging | es, en |
| Suborno e anticorrupção | bribery | es, en |
| Abuso de mercado | market_manipulation | es, en |
| Troca de informações | information_exchange | es, en |
| Boicote coletivo | group_boycott | es, en |
| Conflito de interesse não declarado | conflict_of_interest | es, en |
| Uso de informação privilegiada | insider_trading | es, en |
| Fraude interna e desvio de recursos | internal_fraud | es, en |
Essas condutas correspondem a categorias regulatórias cobertas por marcos como CADE, COFECE, FNE, CNDC, FCPA, Ley 27.401, Lei Anticorrupção, MAR e CMF, entre outros. A API retorna no campo regulatory_frameworks os marcos aplicáveis à análise de cada requisição.
Para consultar o catálogo atualizado de playbooks disponíveis, use GET /v1/playbooks.
Modos de análise
Cada chamada a POST /v1/analyze aceita um parâmetro mode que controla a profundidade da análise e o custo em créditos:
| Modo | Descrição | Créditos por chamada | Latência típica |
|---|---|---|---|
screening | Apenas camada L1 (keyword + embedding, sem LLM). Descarte massivo de documentos irrelevantes. | 1 crédito | ~50 ms |
fast | L1 + L2 (LLM leve). Classificação com precisão moderada. | 2 créditos | ~200 ms |
full | L1 + L2 + L3 (LLM profundo). Análise com raciocínio completo e maior precisão. | 3 créditos | ~2–8 s |
O modo padrão é "full". Para triagem de grandes volumes, a prática recomendada é um funil de três etapas: "screening" para descartar a maior parte do corpus, "fast" nos documentos que superaram o limiar L1, e "full" para os que requerem análise profunda. Veja Créditos e modos para o padrão detalhado.
Precisão do sistema de detecção
O sistema de detecção do vario oferece alta precisão validada, com cobertura específica para comunicações corporativas em espanhol e português em contexto latino-americano. Os playbooks levam em conta terminologia e padrões de linguagem característicos dos casos investigados por reguladores como CADE, COFECE e FNE.
Começar
Consulte o Quickstart para se registrar, obter sua API key e enviar sua primeira requisição em menos de cinco minutos.