Agentes IA
¿Para qué sirve este módulo?
Los Agentes son asistentes de IA configurables que pueden responder preguntas, generar resúmenes o atender clientes de forma automática. Se crean sin código: definís el comportamiento en texto y el agente opera con los datos reales de tu organización. Hay dos tipos: agentes internos (para el equipo) y agentes de soporte (para clientes por WhatsApp).
Conceptos clave
- Agente interno: disponible dentro de Smart Storages para el equipo. Responde preguntas operativas, genera resúmenes de stock, analiza ventas, etc. Es como Nova pero enfocado a una tarea específica.
- Agente de soporte (WhatsApp): conectado a WhatsApp Business a través de la API de Meta. Responde a clientes de forma automática según el prompt configurado.
- Prompt / Comportamiento: el texto que define cómo se comporta el agente: su rol, tono, qué puede y no puede responder, ejemplos de respuesta. Es el corazón de cada agente.
- Webhook: URL que el agente de soporte publica para recibir mensajes de WhatsApp. Debe configurarse en la consola de Meta.
- Ámbito: qué parte del sistema puede consultar el agente (todos los datos, solo ventas, solo inventario, etc.).
Tipos de agente
| Tipo | Canal | Caso de uso típico |
|---|---|---|
| Interno (INTERNAL) | App Smart Storages | Análisis de KPIs, resumen de stock, asistencia operativa para el equipo |
| Soporte (SUPPORT) | WhatsApp Business | Atención de consultas de clientes, estado de pedidos, tracking |
Tareas principales
Cómo crear un agente interno
- Ir a Agentes en el menú lateral.
- Hacer clic en Nuevo Agente.
- Completar los datos:
- Nombre: identificador del agente (ej. "Asistente de Compras").
- Tipo: seleccionar Interno.
- Ámbito: elegir a qué datos del sistema puede acceder.
- Comportamiento de IA (prompt): describir en texto cómo debe comportarse. Ver las plantillas de prompt más abajo.
- Guardar y probar el agente con el chat de prueba integrado.
Cómo crear un agente de WhatsApp
- En Agentes, hacer clic en Nuevo Agente y seleccionar tipo Soporte.
- Completar nombre, ámbito y comportamiento (prompt orientado a atención al cliente).
- Al guardar, el sistema muestra las credenciales de conexión:
- Webhook URL: URL para pegar en la consola de Meta.
- Verify Token: token de verificación para la configuración del webhook.
- En la consola de Meta (developers.facebook.com):
- Ir a la app de WhatsApp → Webhooks.
- Pegar la Webhook URL y el Verify Token.
- Subscribirse al evento
messages.
- De vuelta en Smart Storages, ingresar el Phone Number ID y el WhatsApp Access Token de tu cuenta de Meta.
- Guardar y probar enviando un mensaje al número de WhatsApp configurado.
Necesitás una cuenta Meta Business
Para el agente de WhatsApp, necesitás tener configurada una cuenta de WhatsApp Business API en Meta. El proceso de verificación puede tomar varios días.
Cómo probar un agente
- En el detalle del agente, hacer clic en Probar en chat.
- Escribir preguntas como si fueras un usuario o cliente.
- Si la respuesta no es la esperada, ajustar el Comportamiento de IA y probar de nuevo.
Cómo mejorar el comportamiento de un agente
El prompt es la clave. Cuanto más específico, mejor el agente:
- Definí el rol: "Sos un asistente de inventario de Smart Storages..."
- Aclará el tono: formal, amigable, conciso.
- Incluí ejemplos: "Si preguntan por stock, responde con el nombre del producto y el ATP disponible."
- Limitá el alcance: "Solo respondo preguntas sobre inventario. Para ventas, derivá al equipo."
Plantillas de prompt recomendadas
Agente interno de operaciones:
Sos un asistente operativo de Smart Storages. Respondés en español, de forma concisa y con pasos accionables.
Si el usuario pregunta por stock, consultá el ATP disponible.
Si la pregunta es ambigua, pedí clarificaciones antes de responder.
No inventes datos: si no encontrás la información, decí que no está disponible.Agente de soporte WhatsApp:
Sos el asistente de atención al cliente de [Nombre de empresa].
Saludá al cliente por su nombre si lo conocés.
Si pregunta por el estado de su pedido, buscá por su nombre o número de venta.
Ofrecé opciones claras y resumidas. Derivá al equipo humano si el caso es complejo.
Respondé siempre en el mismo idioma en que te escriben.Qué tener en cuenta
- Un agente sin prompt bien definido responde de forma genérica y puede dar información incorrecta. Invertí tiempo en el comportamiento.
- Los agentes tienen acceso solo a los datos de tu organización. No acceden a información de otros tenants.
- Para el agente de WhatsApp, el número de teléfono debe ser uno exclusivo para el bot. Un número compartido con el equipo causará confusión.
- Revisá regularmente las conversaciones del agente de soporte para detectar preguntas no respondidas y mejorar el prompt.
Preguntas frecuentes
¿Puedo tener múltiples agentes de WhatsApp? Sí, cada uno puede estar vinculado a un número distinto (ej. uno para ventas, otro para soporte técnico).
¿El agente puede hacer operaciones en el sistema (crear ventas, ajustar stock)? Por defecto, los agentes solo consultan datos y responden preguntas. No realizan operaciones de escritura a menos que se configure explícitamente.
¿Qué pasa si el cliente escribe en inglés? El agente responde en el idioma del cliente si el prompt lo indica. Si no, responde en español por defecto.
¿Puedo pausar un agente de WhatsApp? Sí. En el detalle del agente, podés desactivarlo temporalmente. Los mensajes de WhatsApp quedarán sin respuesta automática.
¿El agente recuerda conversaciones previas de un cliente? Dentro de la misma sesión de chat sí. Entre sesiones diferentes, no tiene memoria persistente a menos que se configure un contexto adicional.