Vigil

Controle seus agentes de IA. Acompanhe custos. Mantenha a conformidade. Código aberto

---

O que faz

Um painel para gerenciar sua equipe de IA.

Recurso	Como ajuda
Conecte seus agentes	Integre OpenAI, Anthropic ou agentes personalizados
Defina metas e orçamentos	Atribua tarefas, limite custos, defina sucesso
Acompanhe em tempo real	Veja o que cada agente está fazendo agora
Receba alertas	Slack, e-mail ou PagerDuty quando algo sair do esperado
Comprove conformidade	Exporte trilhas de auditoria para SOC 2, ISO 42001

---

Início rápido (5 minutos)

1. Inicie o banco de dados

docker compose up -d postgres

2. Instale e configure

npm install
cp apps/api/.env.example apps/api/.env
cp apps/web/.env.example apps/web/.env

Ou execute um único comando:

npm run setup:local

3. Execute

# Terminal 1: API
npm run dev:api

# Terminal 2: Dashboard
npm run dev:web

Ou execute ambos em um terminal:

npm run dev:all

4. Abra http://localhost:5173

Verifique se tudo está conectado

npm run check:stack

Se API + web estiverem em execução, carregue os dados de demonstração:

npm run seed:demo

---

Solução de problemas (macOS)

1) cp .env.example ... falha

Use os caminhos corretos a partir da raiz do repositório:

cp apps/api/.env.example apps/api/.env
cp apps/web/.env.example apps/web/.env

2) Cannot connect to the Docker daemon

• Inicie o Docker Desktop
• Aguarde até o Docker informar que está em execução
• Tente novamente:

docker compose up -d postgres

3) Erro de API ECONNREFUSED ... :5432

O PostgreSQL não está acessível. Confirme:

docker compose ps

Em seguida, reinicie a API:

npm run dev:api

---

Exemplo: Equipe de suporte ao cliente

Crie uma equipe

POST /api/teams
{
  "name": "Support Squad",
  "agents": [
    { "provider": "openai", "model": "gpt-4", "role": "triage" },
    { "provider": "anthropic", "model": "claude-3", "role": "escalation" }
  ],
  "goals": [
    { "metric": "response_time", "target": "< 2 min" }
  ]
}

Atribua tarefas

POST /api/tasks
{
  "team_id": "<your-team-id>",
  "description": "Handle refund requests",
  "budget": { "usd": 5.00, "tokens": 10000 },
  "policies": ["no_pii_exposure", "enforce_budget_limits"]
}

Receba alertas quando os agentes saírem do script

• Orçamento excedido -> Notificação no Slack
• Ferramenta não autorizada -> Alerta por e-mail + parada automática
• PII detectada -> Escalonamento no PagerDuty

Exporte relatórios de conformidade

GET /api/compliance/report?type=SOC_2_Type_II

---

Painel

Tela	O que você vê
Visão geral	Todas as equipes, agentes ativos, custo do dia
Agentes	Adicionar/editar equipes, conectar provedores
Tarefas	Fila, atribuir trabalho, monitorar progresso
Custos	Orçamentos, tendências de gastos, previsões
Governança	Violações de política, logs de auditoria
Alertas	Feed em tempo real, histórico de escalonamento

---

Construído com

• Backend: Node.js + Express + PostgreSQL
• Frontend: React + Vite
• Integrações: OpenAI, Anthropic, Slack, PagerDuty, e-mail

---

Pronto para controlar sua equipe de IA?