Integración con agentes IA
Descripción general
Una vez que tu Catálogo de Ventas está configurado con productos, categorías y propiedades, puedes conectarlo a uno o varios agentes IA. Cuando un agente está conectado, tus clientes pueden preguntar por productos en lenguaje natural —"¿tienen abrigos impermeables?", "algo de menos de $500", "color azul talla M"— y el agente busca en el catálogo, filtra por los criterios mencionados y responde con resultados concretos: nombre, precio desde, marca, variantes disponibles. La conexión se hace por agente, no a nivel de cuenta: puedes elegir qué agente consulta el catálogo y restringirlo a una rama del árbol de categorías.
Cómo acceder
- Navega a Herramientas > Aurora AI > Base de Conocimiento en el agente que quieras configurar.
- Selecciona la pestaña Catálogo de Ventas.
- Rol requerido: Admin de Chatbots.
Vista general de la interfaz
La pestaña Catálogo de Ventas dentro de Base de Conocimiento muestra:
- Un interruptor de activación para conectar/desconectar el catálogo del agente.
- Cuando está activo, un selector de categoría límite opcional —para restringir lo que el agente puede ver a una rama del árbol.
- Un panel informativo que explica los requisitos (modelo Avanzado) y el alcance (el agente puede consultar todos los productos del catálogo en estado Activo).
Requisito del modelo Avanzado
El Catálogo de Ventas usa búsqueda híbrida —combinando comprensión semántica con filtros estructurados— y requiere un modelo IA con capacidades suficientes. Por eso, al activar el catálogo, si el agente no está usando el modelo Avanzado, Aurora te pedirá confirmación para actualizarlo automáticamente al modelo Avanzado.
Mientras el catálogo esté activo en el agente, no podrás bajar el modelo desde la pestaña de configuración del agente: la opción aparece bloqueada con una indicación clara. Si necesitas cambiar el modelo, primero desactiva el catálogo en ese agente.
Límite por categoría (opcional)
Después de activar el catálogo, opcionalmente puedes restringir el agente a una categoría y todos sus descendientes. Útil cuando un mismo catálogo sirve a varios agentes con responsabilidades distintas:
- Un agente de "Cuidado del hogar" ve solo esa rama del árbol.
- Un agente de "Electrónica" ve otra rama distinta.
- Un agente general ve todo el catálogo (sin restricción).
El límite se aplica del lado del servidor: el agente nunca recibe ni menciona productos fuera de su rama, sin importar cómo se exprese el cliente.
Funciones y acciones
Activar el catálogo en un agente
Qué hace: Conecta el Catálogo de Ventas al agente.
Pasos:
- Abre el agente y navega a Base de Conocimiento > pestaña Catálogo de Ventas.
- Activa el interruptor.
- Si el agente no usa el modelo Avanzado, aparece un diálogo de confirmación: "Activar y actualizar modelo". Confirma para continuar.
- (Opcional) Selecciona una categoría límite para restringir el alcance del agente.
- Los cambios se guardan automáticamente.
Notas importantes:
- Solo los productos en estado Activo son visibles para el agente. Los productos en Borrador, Descontinuado o Archivado se ignoran.
- Las propiedades personalizadas se exponen al agente automáticamente —no necesitas configurarlas en cada agente.
Cambiar la categoría límite
Qué hace: Restringe (o amplía) el alcance del agente sobre el catálogo.
Pasos:
- Con el catálogo activo, abre el selector de Categoría límite.
- Elige una categoría —el agente verá esa categoría y todas sus subcategorías.
- Para quitar el límite, deja la categoría en "Sin restricción" (todo el catálogo).
Desactivar el catálogo en un agente
Qué hace: Desconecta el catálogo. El agente deja de tener acceso a los productos.
Pasos:
- Desactiva el interruptor.
- Confirma. Una vez desactivado, puedes volver a cambiar el modelo del agente si quieres.
Probar la búsqueda del agente
Qué hace: Verifica cómo responde el agente a preguntas reales antes de pasarlo a producción.
Pasos:
- Una vez activado el catálogo, abre el chat de prueba del agente.
- Haz preguntas en lenguaje natural, por ejemplo:
- "¿Qué tienen en cuidado del hogar?"
- "¿Algo color azul talla M?"
- "Productos de menos de $500"
- "¿Tienen X marca?"
- El agente debería responder con productos concretos: nombre, precio desde, marca y, si aplica, las opciones de variantes.
Cómo el agente usa el catálogo
Cuando un cliente hace una pregunta de producto, el agente IA:
- Pasa la consulta tal como la dijo el cliente al motor de búsqueda híbrida. No agrega filtros que el cliente no mencionó (por ejemplo, si el cliente dice "una sudadera", el agente busca "sudadera" —no agrega "para hombre" o "para mujer").
- Cuando el cliente sí menciona un atributo concreto (color, marca, precio máximo, una propiedad personalizada), el agente lo traduce a un filtro estructurado y lo aplica.
- El motor combina comprensión semántica (entiende sinónimos: "campera" = "abrigo" = "chamarra") con palabras clave y filtros estructurados, y devuelve los resultados más relevantes.
- El agente presenta esos resultados de forma natural en la conversación —no como una tabla cruda, sino integrados a la respuesta.
Si una búsqueda no devuelve resultados, el agente puede ofrecer relajar uno de los filtros ("No encontré nada en color azul talla M; ¿quieres ver otras tallas en azul?") en lugar de simplemente decir "no hay".
Buenas prácticas
Asegúrate de que los productos estén en Activo
La causa más común de "el agente no menciona mi producto" es que el producto está en Borrador o Archivado. Cambia el estado a Activo antes de probar.
Llena la marca y la categoría
La marca y la categoría son filtros frecuentes ("¿tienen marca X?", "muéstrame algo de Y categoría"). Tener ambos campos llenos mejora notablemente la precisión.
Define propiedades personalizadas claras
Si tu negocio diferencia productos por color, talla, peso, voltaje o cualquier otro atributo, define propiedades personalizadas con nombres claros. El agente las usa para filtrar con precisión.
Usa el límite por categoría
Si tienes varios agentes para distintas líneas de negocio, restringe cada uno a su rama. Mejora la pertinencia de las respuestas y evita que un agente recomiende productos fuera de su contexto.
Prueba con preguntas reales
Antes de exponer el agente a clientes, prueba con las preguntas más comunes que tu equipo de atención recibe. Si el agente no las responde bien, suele ser un problema de datos —no de configuración. Revisa la marca, la categoría y las propiedades del producto.
Notas importantes
- La activación por agente es independiente de los Catálogos de Aurora AI (
/aurora-ai/catalogs). Puedes usar ambos al mismo tiempo en distintos agentes o en el mismo —son fuentes de datos complementarias. - Cuando agregas productos nuevos al catálogo, el agente puede tardar algunos minutos en empezar a recomendarlos por búsqueda semántica. Mientras tanto, la búsqueda por palabras y los filtros estructurados ya los encuentran.
- El uso del catálogo por agentes contribuye al consumo de mensajes IA según tu plan; no hay un costo adicional por activar el catálogo.
Preguntas frecuentes
P: ¿Por qué Aurora me pide cambiar el modelo del agente al activar el catálogo? R: La búsqueda híbrida y el manejo correcto de filtros estructurados requieren un modelo con capacidad suficiente. El modelo Avanzado garantiza que el agente entienda preguntas complejas y filtre con precisión.
P: ¿Puedo activar el catálogo en varios agentes a la vez? R: Sí. Cada agente se configura por separado, con su propio límite de categoría si aplica.
P: ¿Cómo evito que el agente recomiende productos fuera del segmento que atiende? R: Usa el límite por categoría. El agente respeta la rama del árbol y nunca menciona productos fuera del subárbol asignado.
P: ¿Qué hago si el agente "inventa" atributos al buscar? R: Aurora está configurado para no agregar contexto que el cliente no proporcionó. Si observas que el agente está agregando filtros no solicitados, repórtalo —es un problema que tomamos en serio porque degrada la calidad de los resultados.
P: ¿El agente puede agregar productos al carrito o cerrar la venta? R: Por ahora, la integración es de consulta y recomendación. El cierre de venta sigue ocurriendo por las vías comerciales habituales (tu equipo humano, tu tienda en línea, etc.).