Qué es y cuándo usarlo
@lemabot/agent-core es el motor común de los agentes de WhatsApp que vende LemaBot. Antes, cada proyecto tenía su
propia copia del agente (prompt en un campo de texto, reglas dentro del prompt, sin pruebas); cada arreglo había que
repetirlo en cada proyecto. Ahora:
- Un motor (este repo) con prompt por capas, guardrails, atajos deterministas, herramientas y evals.
- Adaptadores por proyecto: cada proyecto solo dice de dónde salen su catálogo, sus documentos y sus leads.
- Un canal estándar: WhatsApp oficial de Meta conectado con Conecta de Lema Engine.
Qué incluye
Sección titulada «Qué incluye»| Pieza | Ubicación | Para qué |
|---|---|---|
| Motor | src/*.ts |
ejecutarMotor(): entrada → atajos → agente (AI SDK 7) → guardrails → reparación o traspaso |
| Canal | src/canal/*.ts |
Cliente Conecta, verificación del relay, normalización del webhook, envío por Cloud API, cifrado |
| Casos base | src/casos.ts |
9 conversaciones que todo agente debe pasar antes de encenderse |
| Casos de uso | ejemplos/*.ts |
Restaurante, ferretería, materiales B2B, servicios: configuración + conocimiento + casos |
| Plantillas | plantillas/ |
TanStack/Lovable (probada), Next.js, esquema Supabase, mensaje para Lovable |
| Sync | scripts/sync.sh |
Copia el motor a un proyecto con manifiesto de versión y detección de cambios locales |
| Evals | evals/correr.ts |
Corre las conversaciones contra un modelo real, con juez opcional |
Qué no es
Sección titulada «Qué no es»- No es un servicio que corre aparte. Se ejecuta dentro de cada proyecto (Workers, Next.js…), con los datos en la base de cada cliente. Lema Engine sigue siendo solo el puente con Meta.
- No es un asistente de propósito general. Meta prohíbe en la API de WhatsApp Business los asistentes de IA generales; el motor rechaza temas ajenos al negocio. Véndelo como atención y ventas del negocio.
- No reemplaza al asesor. Cotizaciones formales, quejas, reservas sin agenda conectada y todo lo que no tiene fuente pasa a una persona.
Cuándo usarlo
Sección titulada «Cuándo usarlo»Siempre que un proyecto (de LemaBot o de un cliente) necesite un agente que conteste WhatsApp. Si el proyecto aún no tiene WhatsApp, primero Conecta.