Introdução e Conceitos

O Argos é uma plataforma de monitoramento inteligente de câmeras. Um servidor central analisa streams de vídeo em tempo real usando visão computacional para detectar eventos, que são verificados por IA antes de gerar alertas — reduzindo falsos positivos e entregando apenas detecções confiáveis.

Como a plataforma funciona

Câmeras (stream de vídeo)
    ↓
Detecção por visão computacional
    ↓
Verificação por IA
    ↓
Eventos + Vereditos
    ↓
Painel (SPA) / MCP (agentes) / Canais de Notificação

Conceitos principais

Empresa

A Empresa é a sua organização dentro do Argos — dona das câmeras monitoradas. Toda câmera, usuário e canal de notificação pertence à sua Empresa.

Câmera

Uma fonte de vídeo monitorada pelo Argos. Cada câmera tem:

• Um conjunto de IAs habilitadas (análises ativas).
• Zonas e Linhas para delimitar regiões de interesse.
• Calibração para ajustar os limiares das análises.
• Agenda para definir janelas de monitoramento.

Quando as câmeras estão agrupadas em um DVR/NVR, são representadas como canais de um Gravador.

Gravador

DVR ou NVR que hospeda múltiplos canais de vídeo. Armazena a credencial de acesso (host, porta, usuário, senha) uma única vez; as câmeras filhas derivam a URL de stream automaticamente a partir do template do fabricante e do canal.

Veja o guia Plugar câmeras para conectar câmeras via Gravador.

IA (análise)

Uma análise que uma câmera pode ligar ou desligar. Cada IA detecta uma categoria de evento.

Análises disponíveis:

Evento

Uma detecção persistida — a câmera identificou algo de interesse num instante. Cada evento tem tipo, gravidade e um Veredito.

Veredito

A decisão da verificação por IA sobre um Evento: confirmado (detecção real) ou refutado (falso alarme), com confiança e motivo descritivo.

Somente eventos com veredito confirmado disparam Canais de Notificação.

Alerta

Um Evento exibido no painel ao operador. Por padrão lista todos; filtros (veredito, gravidade, tipo, câmera) reduzem o ruído visual.

Alerta não é uma entidade separada do Evento — é a visão de um Evento no Painel.

Zona e Linha

• Zona: região poligonal desenhada sobre a câmera para delimitar a área monitorada por uma IA.
• Linha: segmento configurado para detecção de cruzamento (ex.: linha de perímetro para Invasão).

Calibração

Ajuste dos limiares de cada IA por câmera via o campo config_ia:

• Confiança mínima de detecção.
• Tempo de permanência (Perambulação, Abandono).
• Limite de pessoas (Aglomeração).
• Taxa de frames analisados.

Partindo de templates de use-case, a calibração reduz falsos positivos sem perder eventos reais.

Agenda

Janela de horário e dias em que uma IA fica ativa numa câmera. Ex.: perímetro monitorado das 18h às 6h. Fora da janela, a IA não dispara.

Canal de Notificação

Destino externo configurado para onde o Argos envia um Evento confirmado.

Tipos disponíveis: webhook (HTTP POST), WhatsApp e Email.

Canais podem ter filtros (tipo de IA, gravidade mínima, câmeras específicas) e agenda.

Instrução de Verificação

Texto personalizado que orienta a IA na etapa de verificação de um evento. Permite adaptar o critério de confirmação ao contexto específico da câmera (ex.: "ignorar reflexos de vidro ao verificar fogo").

MCP

Superfície da API para agentes de IA (Claude Code/Desktop, Cursor) operarem o Argos — ler Eventos, cadastrar/calibrar Câmeras, gerir Canais de Notificação — autenticados por OAuth e escopados pelo papel do usuário.

Papéis e capacidades

O token de autenticação carrega o papel do usuário. Todas as operações são escopadas automaticamente.

Próximos passos

• Quickstart — autentique e leia eventos em minutos.
• Plugar câmeras — conectar câmeras diretamente ou via Gravador.
• Autenticação — Bearer token e OAuth/MCP.