No era un bot de respuestas. Era un empleado digital por negocio.
EtherCode OS corre sobre Cloudflare Workers y opera por demoId para dar contexto específico por negocio, memoria de conversación y ejecución comercial conectada a catálogo y pagos.
Problema real#
Los equipos comerciales pierden oportunidades cuando cada conversación depende de operadores humanos sin contexto continuo, sin memoria útil y sin integración directa con catálogo o checkout.
Solución#
Diseñé una arquitectura multi-tenant por demoId que combina intención, memoria de lead, contexto dinámico y guardrails de respuesta para convertir conversaciones en oportunidades calificadas y operables.
Qué es la app#
Es un backend de IA para atención comercial y captación de leads, montado en Cloudflare Workers. Actúa como Empleado Digital para demos por negocio (demoId), con memoria de conversación, reglas de respuesta y soporte de e-commerce/pagos.
Base técnica (stack)#
Runtime: Cloudflare Workers + Durable Objects + D1 + KV.
IA: binding AI de Cloudflare (modelo configurable, por defecto @cf/meta/llama-3-8b-instruct).
Integraciones: Tienda Nube, Mercado Pago, Supabase.
Código principal: src/index.js y wrangler.toml.
Cómo funciona (flujo técnico)#
Cliente pega a /chat o /v1/demo/chat.
Rate limit por IP (Durable Object RateLimiterDO) y por sesión/día (ChatSessionDO).
Para modo demo: carga perfil del negocio y contexto dinámico (agent-context-service.js).
Enriquecimiento comercial con catálogo Tienda Nube y checkout Mercado Pago (commerce-runtime-service.js).
Clasifica intención, arma contexto estructurado e invoca LLM.
Valida/sanea respuesta (longitud, preguntas, frases prohibidas, CTA y no inventar precio).
Persiste mensajes en D1 y devuelve respuesta por SSE streaming.
Módulos integrados#
Motor conversacional y router API: src/index.js.
Clasificación de intención: intent-classifier.js.
Memoria operativa de lead: memory-summary.js.
Construcción de contexto para LLM: context-builder.js.
Prompt, política y validación: system-prompt.js, response-policy.js, response-validator.js.
Integraciones externas: tiendanube-client.js, mercadopago-client.js, supabase-source.js.
Esquema de base de datos: migrations.
Endpoints funcionales#
Salud: /health, /v1/health.
Chat general: /chat, /v1/chat.
Chat demo por negocio: /v1/demo/chat.
Lead capture: /lead, /v1/lead.
Config negocio: /v1/demo/business, /v1/demo/business/get, /v1/demo/business/list.
Admin runtime/integraciones: /v1/admin/agent/source, /v1/admin/agent/integration, /v1/admin/messages, /v1/admin/runtime/ip-rate-limit.
Vista pública demo: /v1/demo/public.
Arquitectura#
Sistema serverless con aislamiento por negocio (demoId), control de estado en Durable Objects, persistencia liviana en D1/KV e integración comercial en tiempo real para transformar conversación en acción.
Runtime
Cloudflare Workers + Durable Objects
Data
D1 para conversación y KV para estados rápidos
IA
Cloudflare AI binding con modelo configurable
Commerce
Tienda Nube + Mercado Pago + Supabase
Puntos fuertes
Arquitectura serverless escalable y de bajo costo operativo.
Multi-tenant por demoId con contexto por negocio.
Memoria conversacional útil para calificación de leads.
Integración comercial real: catálogo y checkout.
Guardrails de respuesta para calidad comercial y control de riesgo.
Observabilidad y gobernanza vía endpoints admin protegidos por X-Admin-Key.
Resultado#
EtherCode OS permite desplegar un Empleado Digital por negocio con contexto propio y control operacional, reduciendo fricción comercial y acelerando la captura de oportunidades.
| Capacidad | Antes | Con EtherCode OS |
|---|---|---|
| Contexto por negocio | Manual y fragmentado | Automático por demoId |
| Atención comercial | Dependiente de operadores | Asistida por agente con guardrails |
| Integración de venta | Desconectada | Catálogo y checkout integrados |
Resumen del proyecto#
Desarrollé EtherCode OS como backend conversacional B2B sobre Cloudflare Workers, con arquitectura multi-tenant por demoId, memoria de conversación y guardrails de respuesta. Integré catálogo en tiempo real (Tienda Nube), checkout (Mercado Pago) y contexto externo (Supabase), además de endpoints admin para gobernanza y observabilidad del runtime.
Si están contratando para construir plataformas de IA en producción, quiero aportar en ese equipo.
Me enfoco en arquitectura robusta, ejecución técnica y resultados medibles en sistemas reales.