Unidades de Trabajo (UT)

Las Unidades de Trabajo (UT) son la métrica estandarizada que utiliza Orbis para medir la capacidad de ejecución consumida por la flota de empleados digitales.

Internamente en el motor de ejecución, las UT se contabilizan con precisión entera en milliWU (1 UT = 1.000 milliWU), garantizando que no existan errores de redondeo de punto flotante en el libro mayor de auditoría (_ledger_).

---

Por qué no vendemos "Créditos" ni "Tokens"

En la industria del software con IA, los esquemas de "créditos virtuales" generan fricción y desconfianza por tres razones concretas:

1. Opacidad algorítmica: El comprador nunca sabe cuántos créditos cuesta resolver un caso de uso específico.

2. Terror al desborde (_bill shock_): Un loop anómalo en un agente autónomo puede consumir miles de dólares en minutos sin aviso previo.

3. Desconexión con el valor de negocio: Facturar millones de "tokens de entrada y salida" traslada la complejidad técnica del proveedor al cliente final.

Orbis resuelve esto con tres principios innegociables:

1. Predecible y en Retainer: Los planes se adquieren con un paquete garantizado de Unidades de Trabajo mensuales dimensionado holgadamente para la operación habitual de la empresa.

2. Estimación honesta pre-ejecución: Para tareas complejas, el sistema proyecta el consumo basándose en la mediana histórica de ejecuciones previas (Estimado: ~2.4 UT → Real: 2.1 UT).

3. Protección contra descontrol (maxWuPerDay): Cada plan cuenta con un tope diario inquebrantable enforceado por el motor de ejecución (jobs.db). Si un pico imprevisto ocurre, el sistema frena de manera preventiva y consulta al dueño antes de generar sobrecostos.

---

¿Cómo se calcula una Unidad de Trabajo?

Una Unidad de Trabajo normaliza cuatro vectores computacionales reales:

$$\text{UT} = f(\text{Tokens Normalizados}, \text{Tiempo de Cómputo}, \text{Operaciones de Navegador}, \text{I/O Transaccional})$$

┌─────────────────────────────────────────────────────────────┐
│                 VECTORES DE CONSUMO EN UT                   │
├─────────────────────────────────────────────────────────────┤
│ 1. INFERENCIA NORMALIZADA    Ponderada por tier de modelo   │
│                              (Generic, Reasoning, Browser)  │
│ 2. NAVEGACIÓN HEADLESS       Páginas cargadas, clicks y DOM │
│ 3. LLAMADAS A HERRAMIENTAS   Consultas a PMS, ERPs y APIs   │
│ 4. TIEMPO DE CPU ACTIVO      Procesamiento local en Edge    │
└─────────────────────────────────────────────────────────────┘

• Modelo por tarea (_taskKind_): No todas las tareas requieren modelos gigantes. Una consulta de horarios utiliza un modelo liviano (GENERIC), mientras que la resolución de un conflicto de reservas utiliza un modelo de razonamiento profundo (REASONING). Las UT normalizan esta diferencia para que el cliente siempre tenga un costo predecible.
• Automatización web: Acceder a un sistema PMS legacy sin API pública mediante un navegador headless consume más recursos de máquina que una llamada REST simple. La metrología en UT refleja esa carga de forma transparente.

---

Matriz de Consumo por Operación Típica

En la operación real de una empresa de hospitalidad o servicios, el gasto de UT varía según la profundidad de la tarea:

Tipo de Tarea	Descripción Técnica	Rango Habitual
Consulta informativa simple	Respuesta inmediata sobre horarios, servicios o ubicación vía WhatsApp. Solo inferencia básica.	0.05 a 0.10 UT
Cotización con políticas	Lectura de inventario en PMS, aplicación de reglas de temporada y cálculo de tarifas dinámicas.	0.30 a 0.50 UT
Modificación de reserva	Búsqueda de reserva existente, validación de políticas de cancelación y reprogramación de fechas.	0.80 a 1.20 UT
Reserva completa & link de pago	Bloqueo temporal en PMS, creación de enlace de cobro seguro y emisión de comprobante al cliente.	1.50 a 2.50 UT
Cierre de caja y conciliación	Conciliación de comprobantes bancarios contra reservas registradas y reporte diario de ocupación.	3.00 a 5.00 UT

---

Presupuestos Diarios y Circuit Breaker (`maxWuPerDay`)

El motor de ejecución de Orbis integra un guardián de presupuesto en tiempo real (SqliteUsageBudget) que corre antes de invocar cualquier modelo o herramienta:

[Nueva Invocación]
       │
       ▼
[Verificación de Presupuesto] ─── ¿Consumo acumulado hoy + estimado > maxWuPerDay?
       │
       ├── SÍ ──► [Evento: budget.exceeded] ──► Rutinas pausadas + Alerta WhatsApp
       │
       └── NO ──► [Ejecución Autorizada] ──► Descuento en Ledger inmutable

• Sin sorpresas: Si un script externo o una campaña masiva de marketing genera 10 veces más tráfico del habitual, la empresa nunca recibirá una factura desproporcionada.
• Control en el dueño: El dueño recibe una alerta clara en su WhatsApp: _"Se alcanzó el tope diario de seguridad (50 UT). Respondé 'ampliar 20' para autorizar capacidad extra o aguardá el reinicio de las 00:00."_

---

Notificaciones Proactivas de Consumo

El dueño o supervisor del negocio no necesita ingresar a paneles de control complejos para saber cómo va su mes. El sistema vigila los umbrales de manera continua:

1. Umbral del 80% (Aviso Temprano)

Cuando el consumo del ciclo mensual alcanza el 80% del paquete contratado, Orbis envía un mensaje automático al WhatsApp registrado:

_"⚠ Unidades de Trabajo: consumiste el 80% del paquete mensual incluido. Te avisamos con anticipación para que estés al tanto — la operación continúa con normalidad."_

2. Umbral del 100% (Gestión de Capacidad)

Al alcanzar el 100% del paquete incluido:

• Modo Soft: Continúa operando con tarifa acordada de sobreuso (_overage_), registrando cada fracción de UT con el mismo nivel de transparencia.
• Modo Hard: Pausa las rutinas automáticas no esenciales y prioriza exclusivamente la atención a clientes ya confirmados, garantizando costo cero adicional.