# Agente general OMEGA — multicanal (WhatsApp, web, Cursor) — cómo dejarlo activo

**Para el dueño (admin):** esto aclara qué **ya existe**, qué **no es mágico**, y el **checklist** para que te respondan desde WhatsApp/sitio y la cola siga alimentando trabajo real (Cursor + agentes humanos).

---

## 1) Verdad operativa (sin marketing)

| Expectativa | Realidad |
|-------------|----------|
| “Una IA que edita todo el código sola 24/7 desde WhatsApp” | **No existe** como producto listo. El motor de **cambios en repo** es **Cursor / humano / code-server** con workspace abierto. |
| “Que las IAs sigan trabajando solas al momento” | Lo que sí hay: **cola** (`omega-solicitud-desarrollo.php`, `TASK_QUEUE`, `omega-drain-orders.php`) + **respuestas IA** (LiteLLM) + **planificar** (parte en tareas). **Ejecutar** código sigue siendo otro paso. |
| “Premium Cursor = agente en todos lados” | Cursor Premium **no** conecta solo tu VPS. Hay que **configurar** Base URL + API key y, a menudo, usar **Chat** (no Agent) con API custom. |

**Cadena sana:** vos mandás orden (WA / web) → queda **registrada** → **vos o un agente Cursor** con repo abierto **ejecuta** y **reporta** en REGISTRO/handoff.

---

## 2) Lo que YA tenés (no partir de cero)

### WhatsApp (número **admin** en `DIRECTOR_WHATSAPP`)

En `crm.cescac.com/crm.php`, si tu número está en `.env` como admin:

- **`menu admin`** / **`ayuda`** → menú completo (OMEGA, CRM, modos).
- **`tarea …`** o **`orden …`** → POST a `omega-solicitud-desarrollo.php` → cola OMEGA + notificación WA si `omega-wa-notify` funciona.
- **`planificar …`** (texto largo) → planificador en VPS → hasta varias tareas encoladas.
- **Cualquier otro texto** (admin) → intenta **LiteLLM** (`cescac-auto`) con contexto `TASK_QUEUE`/memoria; si responde, puede **también** encolar; si falla IA, usá **`tarea …`**.

### Web

- **Centro:** `https://vps.cescac.com/omega-centro-unificado.php` (PIN / login admin según configuración).
- **Solicitud desarrollo:** `https://vps.cescac.com/omega-solicitud-desarrollo.php` → misma cola.
- **Agente único (web, sesión centro):** `https://vps.cescac.com/omega-agente-unico.php` — chat + planificar encolando.

### Cursor / API

- Hub: `https://vps.cescac.com/omega-api-cursor-hub.html`
- Base URL: `https://vps.cescac.com/omega-litellm/v1` + `LITELLM_MASTER_KEY` (ver `omega-api-key-helper.php` logueado).

### Paralelo / continuo

- Órdenes en `orders.jsonl` + cron **`omega-drain-orders.php`** (ver TASK_QUEUE **CADENA-01**).
- Oleadas **`[MASIVA-*]`**, **`[CADENA-*]`** en `admin-docs/memory-bank/PENDIENTES.md`.

---

## 3) Checklist “dejarlo activo” (orden recomendado)

1. **`.env` CRM:** `DIRECTOR_WHATSAPP` = tu número (593… o 099…). `META_ACCESS_TOKEN`, `WHATSAPP_PHONE_NUMBER_ID`, `WHATSAPP_VERIFY_TOKEN` correctos. Webhook Meta apunta a `https://crm.cescac.com/crm.php`.
2. **Probar WA:** desde tu celular → `menu admin` → debe contestar el menú OMEGA.
3. **Probar cola:** `tarea prueba cola omega 123` → debe responder éxito; revisar `dev-requests` / TASK_QUEUE si es escribible.
4. **LiteLLM:** contenedor arriba, keys en `.env` del stack (TASK-153). Probar `GET …/omega-litellm/v1/models` con Bearer.
5. **Cursor:** una vez LiteLLM OK, configurar OpenAI-compatible en **Chat** con `cescac-auto` o `groq-fast`.
6. **Cron:** verificar `omega-drain-orders.php` en crontab (CADENA-01).
7. **Hábito:** cada orden grande → **`planificar`** en WA **o** en web; cada ítem cerrado → línea en **REGISTRO** + **handoff**.

---

## 4) Si “no interactúa” o “no hace nada”

| Síntoma | Revisar |
|---------|---------|
| WA no responde | Webhook Meta, token, `diagnostico.php` en CRM, logs `crm/logs/webhook_*.log`. |
| No sos “admin” en menú | `DIRECTOR_WHATSAPP` no coincide con tu número (normalización 593…). |
| IA en WA muda | LiteLLM caído o sin cuota → mensaje de error o usar **`tarea`** igual (encola sin IA). |
| “Tarea” falla | `omega-solicitud-desarrollo.php` 403 → token `dev-ingest.token`; o red/firewall CRM→VPS. |
| Cursor no usa tu API | Usar **Chat** + modelo existente en LiteLLM; ver hub (Agent a veces ignora custom API). |

---

## 5) Roadmap (siguiente nivel — TASK_QUEUE)

- **TASK-151:** acuse automático WA cuando entra orden + estado de cola (puente más fino).
- **TASK-155 / VENTANA-UNICA:** un solo panel que muestre cola + últimos mensajes sin abrir 10 chats.
- **Background Agents Cursor** (producto Cursor): documentar en `docs/USO_REMOTO_POR_MOVIL.md` si aplica a tu cuenta.

---

## 6) Una línea para el agente Cursor (siempre)

> LEE INDEX: `https://vps.cescac.com/lee-index-todos-agentes.html` → TASK_QUEUE → ejecutar una PENDING de tu rol → REGISTRO + handoff.

## 7) Plan A / Plan B — IA que orienta y paraleliza (no solo Cursor)

- **Plan A:** vos mandás la orden (WA / web / centro).
- **Plan B:** `omega-ejecutor-plan-b.php` usa LiteLLM (APIs baratas/caros según stack) + contexto TASK_QUEUE/MSI y deja **rastro** en `.omega-data/worker-plan-b-*.json`.
- **Ver actividad:** tras PIN del centro → `https://vps.cescac.com/omega-worker-vivo.php` (auto-refresh).
- **Doc:** `docs/PLAN_A_PLAN_B_EJECUTOR_OMEGA.md`

---

*CESCAC — guía admin multicanal. Actualizado 2026-02-24.*