---
title: Introdução e Conceitos
description: Vocabulário e conceitos do Argos — o que é cada entidade e como se relacionam.
---

# 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](/docs/guias/cameras)** 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:

| IA | O que detecta |
|----|--------------|
| **Fogo** | Chamas ou fumaça |
| **EPI** | Ausência de equipamento de proteção individual |
| **Aglomeração** | Concentração de pessoas acima do limite configurado |
| **Perambulação** | Pessoa permanecendo em área restrita por tempo prolongado |
| **Abandono** | Objeto deixado sem dono por tempo configurado |
| **Queda** | Pessoa caindo ou no chão |
| **Crime** | Comportamentos suspeitos ou armas |
| **Invasão** | Pessoa adentrando zona proibida |
| **Veículo** | Detecção e identificação de veículos |

### 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

| Papel | Capacidade |
|-------|-----------|
| **Administrador da conta** | Gerencia a organização inteira: câmeras, usuários, notificações, calibração, gravadores |
| **Usuário** | Somente leitura: visualiza câmeras e alertas da organização |

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

## Próximos passos

- **[Quickstart](/docs/guias/quickstart)** — autentique e leia eventos em minutos.
- **[Plugar câmeras](/docs/guias/cameras)** — conectar câmeras diretamente ou via Gravador.
- **[Autenticação](/docs/guias/autenticacao)** — Bearer token e OAuth/MCP.