Vigil

Controla tus agentes de IA. Realiza un seguimiento de costos. Mantén el cumplimiento normativo. Código abierto

---

Qué Hace

Un solo panel para gestionar tu equipo de IA.

Función	Cómo Ayuda
Conecta tus agentes	Conecta OpenAI, Anthropic o agentes personalizados
Establece metas y presupuestos	Asigna trabajo, limita costos, define el éxito
Observa en tiempo real	Ve lo que cada agente está haciendo ahora mismo
Recibe alertas	Slack, correo electrónico o PagerDuty cuando algo falla
Demuestra cumplimiento	Exporta registros de auditoría para SOC 2, ISO 42001

---

Inicio Rápido (5 Minutos)

1. Inicia la base de datos

docker compose up -d postgres

2. Instala y configura

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

O ejecuta un solo comando:

npm run setup:local

3. Ejecútalo

# Terminal 1: API
npm run dev:api

# Terminal 2: Dashboard
npm run dev:web

O ejecuta ambos en una sola terminal:

npm run dev:all

4. Abre http://localhost:5173

Verifica que Todo Esté Conectado

npm run check:stack

Si la API y la web están en ejecución, siembra los datos de demostración:

npm run seed:demo

---

Solución de Problemas (macOS)

1) cp .env.example ... falla

Usa las rutas correctas desde la raíz del repositorio:

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

2) Cannot connect to the Docker daemon

• Inicia Docker Desktop
• Espera hasta que Docker indique que está en ejecución
• Reintenta:

docker compose up -d postgres

3) Error de API ECONNREFUSED ... :5432

PostgreSQL no es accesible. Confirma:

docker compose ps

Luego reinicia la API:

npm run dev:api

---

Ejemplo: Equipo de Soporte al Cliente

Crea un equipo

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" }
  ]
}

Asigna trabajo

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"]
}

Recibe alertas cuando los agentes se desvían del guion

• Presupuesto excedido -> Notificación de Slack
• Herramienta no autorizada -> Alerta por correo electrónico + detención automática
• PII detectado -> Escalamiento de PagerDuty

Exporta informes de cumplimiento

GET /api/compliance/report?type=SOC_2_Type_II

---

Panel de Control

Pantalla	Lo Que Ves
Resumen	Todos los equipos, agentes activos, costo de hoy
Agentes	Agregar/editar equipos, conectar proveedores
Tareas	Cola, asignar trabajo, monitorear progreso
Costos	Presupuestos, tendencias de gasto, pronósticos
Gobernanza	Violaciones de políticas, registros de auditoría
Alertas	Fuente en tiempo real, historial de escalamientos

---

Construido Con

• Backend: Node.js + Express + PostgreSQL
• Frontend: React + Vite
• Integraciones: OpenAI, Anthropic, Slack, PagerDuty, correo electrónico

---

¿Listo para controlar tu equipo de IA?