Gaia: asistente virtual de IA para Spapperi

Diseño, hardening y puesta en producción de un asistente conversacional de IA integrado en la web corporativa de un fabricante de maquinaria agrícola, además del rediseño de la propia web.

El cliente

SPAPPERI NT S.r.l.: empresa italiana de Città di Castello (PG) especializada en la producción de maquinaria agrícola (trasplantadoras, remolques, colocadoras de film, acaballonadoras, cosechadoras, escardadoras, etc.), con un catálogo amplio organizado por líneas de negocio (Hortícolas, Tabaco, Plantas Medicinales, Arbóreas) y datos agronómicos estructurados (tipos de trasplante, marcos de plantación, tipos de planta).

Web multiidioma (IT, EN, FR, DE, ES, PT, ZH) basada en Next.js + Payload CMS, en producción en un VPS con stack Docker (PostgreSQL, Caddy, capa de caché).

Antes y después

Hemos rediseñado desde cero la web corporativa y todo el catálogo de producto, modernizando la experiencia de escritorio y móvil: desde la homepage a la navegación por línea de negocio, hasta las fichas de máquina con especificaciones técnicas, configurador y galería.

Homepage

Antes

Después

Navegación por línea de negocio

El antiguo catálogo era una lista plana. Ahora los productos están organizados por línea de negocio (Hortícolas, Tabaco, Medicinales/Aromáticas, Arbóreas, Usado) con filtros por maquinaria, cultivo, tipo de terreno y tipo de planta.

Antes

Después

Ficha de máquina

De la página de producto estática a una ficha técnica completa: especificaciones de trasplante, características técnicas, configurador de equipamientos/accesorios, galería y descarga del catálogo.

Antes

Después

El reto

El cliente quería un asistente virtual capaz de:

• responder sobre todo el catálogo de productos y los datos agronómicos sin que el usuario tenga que navegar por la web;
• derivar de forma correcta a contactos, recambios, candidaturas y servicios;
• funcionar en 7 idiomas;
• ser conforme con las obligaciones legales (transparencia sobre IA, RGPD);
• ofrecer una UX móvil a la altura de un chat moderno.

Un primer lanzamiento había recogido un feedback detallado del cliente (9 puntos, con capturas de las conversaciones) que evidenciaba problemas de tono, estructura de las respuestas, enlaces erróneos y falta de identidad/disclosure de la IA. En paralelo, la infraestructura presentaba límites de escalabilidad (caché ausente, rate limiting en memoria) y una laguna de compliance (las políticas no mencionaban el chatbot).

Cómo funciona Gaia

Gaia no es un chatbot de respuestas preconfeccionadas: es un agente conversacional conectado en tiempo real al CMS de la web. Cuando un usuario hace una pregunta, el modelo no "adivina": usa el function calling para consultar directamente los contenidos reales de Spapperi.

• Acceso al CMS vía function calling: el modelo dispone de un conjunto de tools (funciones) que leen en tiempo real desde Payload CMS: catálogo de productos, series y modelos, datos agronómicos (tipos de trasplante, marcos de plantación, tipos de planta), páginas de servicio, recambios y contactos. La IA decide qué tool llamar y con qué parámetros, recibe los datos estructurados y construye la respuesta sobre esos datos.
• Siempre alineada con los contenidos reales: dado que las respuestas se generan sobre los datos en vivo del CMS, cuando el cliente actualiza un producto o un precio el asistente responde enseguida con la información correcta: nada de knowledge base que reentrenar, nada de respuestas obsoletas. Un hook de invalidación vacía la caché con cada modificación de los contenidos.
• Recuperación multimodelo y multiidioma: un único tool puede devolver varias máquinas en una sola petición (p. ej. "ficha técnica de AS PT y AS AT") con sus respectivos catálogos, en los 7 idiomas soportados.
• Nada de alucinaciones de enlaces: las URL provienen del CMS, siempre relativas y válidas: eliminadas las rutas que generaban 404 y las referencias a páginas que ya no existen.

Conformidad: Reglamento Europeo de IA + RGPD

El asistente se ha diseñado para ser conforme con las obligaciones normativas europeas:

• Reglamento Europeo de IA, transparencia: el Reglamento de IA exige que los usuarios sepan que están interactuando con un sistema de inteligencia artificial. Gaia se presenta explícitamente como asistente virtual de IA (nombre, avatar y disclosure), con saludo localizado en cada idioma: ninguna ambigüedad sobre el hecho de estar hablando con una máquina.
• RGPD: las políticas legales se han actualizado para cubrir el tratamiento de los datos vía chatbot: Política de Privacidad, Política de Cookies y Términos del Servicio, en los puntos correctos de los documentos y en los 7 idiomas (OpenAI indicado entre los encargados del tratamiento y en las transferencias fuera de la UE). Ver el detalle en la sección Compliance RGPD más abajo.

La solución

1. Identidad y calidad conversacional

Del análisis del feedback del cliente se derivaron intervenciones específicas sobre el system prompt y sobre los tools:

• Identidad "Gaia" + disclosure de IA: el asistente se presenta explícitamente como asistente virtual de IA (obligación de transparencia), con nombre, avatar dedicado y saludo localizado en todos los idiomas.
• "Líneas de negocio primero": las respuestas sobre los productos se enmarcan partiendo de las líneas de actividad, y después bajan al detalle de series y modelos.
• Gestión rigurosa de los enlaces: nada de enlaces proactivos si no se piden; URL siempre relativas y válidas (eliminadas las rutas que generaban 404); eliminadas las referencias a páginas que ya no existen.
• Recambios: derivación directa a la plataforma de recambios oficial en lugar de a la sección genérica de servicios.
• Recuperación multimodelo: el tool de detalle de máquina acepta varios modelos en una sola petición, de modo que preguntas como "ficha técnica de AS PT y AS AT" devuelven todos los modelos con sus respectivos catálogos.
• Nada de leakage técnico: eliminada la aparición de marcadores internos ([slug:...]) en el texto mostrado al usuario.

2. Rendimiento: caching en Redis

Cada mensaje reconstruía el contexto con ~11 consultas al CMS. Se ha introducido un servicio Redis en la infraestructura Docker y un caching en dos niveles:

• System prompt cacheado por idioma;
• Respuestas FAQ (primer turno) servidas desde la caché, saltándose por completo el modelo;
• Invalidación automática: hooks en las collections/globals origen del chatbot vacían la caché con cada modificación de los contenidos en el CMS;
• Fallback graceful: si Redis es inalcanzable, la aplicación sigue funcionando sin caché (nunca un error en la cara del usuario).

3. Seguridad: rate limiting distribuido

El rate limiting en memoria (que se reseteaba con cada deploy y no soportaba varias instancias) se ha migrado a Redis con script Lua atómico, compartido entre procesos y persistente, con fallback en memoria. Cubre ~17 endpoints de API (contactos, búsqueda, login del área reservada, candidaturas, RGPD, etc.).

4. Compliance RGPD

Las políticas legales no mencionaban el tratamiento vía chatbot. Se han insertado, en los puntos correctos de los documentos (no al final) y en los 7 idiomas:

• Política de Privacidad: nueva subsección sobre los datos tratados por el asistente, fila en las tablas "Finalidad" y "Conservación", OpenAI entre los encargados y en las transferencias fuera de la UE;
• Política de Cookies: filas en la tabla de las tecnologías técnicas para el localStorage del widget;
• Términos del Servicio: cláusula dedicada al asistente de IA (carácter informativo, no vinculante).

La inserción se realizó mediante un script idempotente que localiza secciones y tablas de forma robusta en todos los idiomas, con backup preventivo de los contenidos.

5. UX/UI móvil

Experiencia rediseñada al estilo de un chat moderno:

• panel fullscreen en móvil;
• nada de zoom indeseado al abrirse el teclado (input de 16px);
• layout estable con el teclado abierto (altura anclada al viewport visible);
• animación de apertura/cierre;
• avatar dedicado de Gaia (header + launcher).

6. Puesta en producción

Deploy controlado en el VPS: backup de la base de datos de producción, sincronización del código (excluidos secretos y volúmenes de runtime), alineación de datos y rebuild Docker con arranque del nuevo servicio Redis, sin pérdida de datos y con verificaciones end-to-end (contenedores healthy, caché poblada, páginas legales actualizadas, chatbot operativo).

Resultados

• Identidad y compliance: el asistente se declara IA en todos los idiomas; cubierta la laguna RGPD en 3 documentos legales × 7 idiomas (21 actualizaciones, 0 anomalías).
• Rendimiento: el coste por mensaje se desploma en las peticiones repetidas gracias a dos niveles de caché, con coherencia garantizada por la invalidación automática.
• Robustez: rate limiting ahora distribuido y persistente; caché y rate limiting degradan de forma segura si Redis no está disponible.
• Calidad de las respuestas: resueltos los puntos de feedback solucionables desde el producto (identidad, estructura, enlaces, recambios, multimodelo, nada de leakage técnico).
• UX móvil: experiencia de chat fluida, sin zoom y sin roturas de layout con el teclado.
• Cero downtime perceptible y cero pérdida de datos en la fase de lanzamiento.

El valor para el negocio

Detrás del aspecto técnico, Gaia y la nueva web resuelven problemas concretos de una empresa manufacturera que vende productos complejos y trabaja con clientes de todo el mundo.

• Un comercial que nunca desconecta. Gaia responde 24/7 sobre catálogo, datos agronómicos, recambios y servicios: el cliente potencial encuentra enseguida la máquina adecuada sin esperar un email o una llamada. Las solicitudes sencillas se cierran solas, las cualificadas llegan al equipo ya maduras.
• Menos carga en el servicio de asistencia. Las preguntas recurrentes (modelos, compatibilidad con cultivos, dónde encontrar los recambios) las gestiona el asistente, liberando tiempo valioso a las personas para las negociaciones que de verdad cuentan.
• Mercados exteriores realmente alcanzables. Con 7 idiomas nativos, un cliente francés, alemán o chino vive la misma experiencia que uno italiano. Para una empresa Made in Italy que exporta, es un canal comercial más, siempre activo y a coste marginal casi nulo.
• Posicionamiento e imagen. Una web moderna y un asistente de IA propio comunican innovación tanto como los productos: el cliente percibe una empresa al día, y no solo un buen fabricante de máquinas.
• Catálogo siempre actualizado, cero mantenimiento doble. Dado que Gaia lee el CMS en tiempo real, basta con actualizar el producto una vez: web y asistente se mantienen alineados. Nada de catálogos paralelos que mantener, nada de información desfasada que haga perder ventas.
• Conformidad = tranquilidad. Transparencia sobre IA (Reglamento Europeo de IA) y RGPD en regla desde el primer día: ningún riesgo legal o reputacional, un activo sólido también de cara a clientes enterprise y concursos.

En esencia: la misma inversión ha producido más solicitudes cualificadas, menos tiempo perdido en tareas repetitivas y una presencia internacional creíble, con una infraestructura lista para crecer sin rehacerlo todo desde cero.

Stack tecnológico

Ámbito	Tecnologías
Frontend	Next.js (App Router), React, framer-motion
CMS / Backend	Payload CMS, PostgreSQL
IA	OpenAI (function calling / tool use)
Caching y rate limiting	Redis (ioredis, script Lua)
Infraestructura	Docker Compose, Caddy, capa de caché, VPS
i18n	7 idiomas (IT, EN, FR, DE, ES, PT, ZH)

En resumen

De un primer prototipo con feedback abierto a un asistente de IA identificable, conforme, con buen rendimiento y robusto, integrado con el catálogo real del cliente y lanzado a producción de forma segura. La arquitectura introducida (Redis, hooks de invalidación, fallback graceful, rate limiting distribuido) constituye además una base reutilizable para funcionalidades adicionales (tokens de un solo uso, antiabuso, caching de páginas pesadas, analytics).

Chatbot "Gaia" by Rayo Consulting.