​

Agent

Agent recibe mensajes de canales como WhatsApp, interpreta intención del usuario y llama a Platform para ejecutar acciones de negocio.

​

Responsabilidades

Agent es dueño de:

• Webhooks de canales.
• Normalización de mensajes.
• Llamadas a LLM.
• Detección de intención.
• Clarificaciones.
• Estado conversacional temporal.
• Formato de respuestas.

Agent no es dueño de datos durables de producto.

​

Diseño channel-agnostic

La lógica de negocio no debe vivir en handlers de WhatsApp. El código de WhatsApp solo recibe, valida y mapea mensajes.

​

Diseño LLM-agnostic

Agent debe poder usar distintos providers mediante adapters. El core depende de una interfaz, no de Gemini/OpenAI/Claude directamente.

​

Uso de Redis

Redis guarda estado temporal:

• Clarificaciones pendientes.
• Último contexto de interacción.
• Cache breve de contexto de usuario.

​

Integración con Platform

Agent usa APIs internas para resolver usuarios, obtener contexto y registrar comidas, peso o workouts.