Contenido
- Cuándo se conecta y quién lo arranca
- Qué sabe hacer el subagente
- Tipos de tareas
- Cómo busca productos el subagente
- Cómo se devuelve el resultado y la comunicación con el cliente
- Configuración del comportamiento mediante instrucciones
El subagente para trabajar con el catálogo es un asistente especializado aparte que se encarga de buscar productos y servicios en el catálogo conectado y de componer con ellos la lista de artículos para el carrito o el pedido. El agente principal no trabaja con el catálogo: cuando en la conversación hace falta seleccionar artículos, comprobar la disponibilidad o preparar el carrito para crear el pedido, le pasa la tarea al subagente, recibe el resultado y continúa el diálogo.
Una particularidad importante: el subagente no se comunica con el cliente directamente. Es un ejecutor «silencioso»: trabaja con el catálogo y le devuelve el resultado al agente principal, y es el agente principal quien decide qué decirle al cliente y cómo. Así, de la conversación siempre se encarga un único agente, y el subagente queda entre bastidores.
Cuándo se conecta y quién lo arranca
El subagente funciona solo con el acceso al catálogo activado en la configuración del agente; ahí mismo se elige de qué tienda tomar los productos (ver «Configuración del agente»). Mientras el catálogo no esté activado, no hay subagente y el agente principal no sabe nada sobre los productos.
Al subagente lo arranca el propio agente principal. Es parte de sus instrucciones: cuando hay que seleccionar productos o armar el carrito, el agente principal recurre al subagente en lugar de buscar por sí mismo. Formula la tarea —qué hay que hacer y con qué productos— y se la pasa. Desde el punto de vista del cliente, todo parece un único diálogo: no ve el cambio al subagente.
Qué sabe hacer el subagente
El subagente conoce la estructura del catálogo (categorías → productos → variantes-ofertas) y sabe:
- buscar productos por nombre, categoría, rango de precios, marca y características;
- analizar la estructura del catálogo: obtener el árbol de categorías y la lista de características disponibles con sus valores (por ejemplo, qué colores y tallas hay y cuántos productos hay para cada uno);
- obtener los detalles de un producto: la descripción completa, los precios, las propiedades, las imágenes y el enlace al sitio (el resultado breve de la búsqueda él mismo lo completa con detalles antes de entregárselo al agente principal);
- comprobar las existencias, pero solo si la tarea lo exige expresamente; por defecto ignora la disponibilidad, porque los datos de existencias a veces no están actualizados;
- consultar el historial del cliente: pedidos anteriores y datos de la ficha, para tenerlos en cuenta en la selección;
- armar el carrito con los artículos encontrados.
El agente principal también tiene acceso a la información del cliente y a la lista de sus pedidos, por eso puede comprobar los datos del cliente o el estado de un pedido por sí mismo, sin recurrir al subagente. El subagente, en cambio, usa ese historial sobre todo para una selección de productos más precisa.
Además, el subagente trabaja estrictamente según los datos reales del catálogo y no inventa productos, precios ni características: si algo no existe, así se lo comunica al agente principal.
Tipos de tareas
El agente principal recurre al subagente planteándole una tarea de uno de los siguientes tipos.
Seleccionar y describir productos. El subagente busca en el catálogo los productos adecuados y le devuelve al agente principal un informe de texto detallado: descripciones, comparaciones, recomendaciones, qué variantes hay disponibles. El carrito no se crea: el agente principal usa el informe para mostrarle los productos al cliente y ayudarlo a elegir.
Armar el carrito. Cuando en un paso del escenario hay una variable de tipo «Contenido del pedido», el agente principal no la completa él mismo: el carrito lo arma el subagente, que encuentra los artículos con la cantidad necesaria y se lo devuelve al agente principal, que a su vez pasa el carrito al campo del paso. Junto con el carrito llega un resumen breve de su contenido, para que el agente lo comente con el cliente si hace falta. Los regalos, descuentos o precios especiales prometidos al cliente se le pasan al subagente junto con la tarea.
Además de estas tareas estructuradas, el agente principal puede pasar una consulta en formato libre, por ejemplo, cuando el cliente solo está mirando el surtido o hace preguntas sobre los productos.
Cómo busca productos el subagente
La búsqueda está organizada como una operación secuencial, no de una sola vez. El subagente primero se familiariza con el catálogo (categorías, características disponibles y sus valores), luego busca con filtros concretos y solo después carga los detalles de los artículos seleccionados. Si hace falta, repite las vueltas: estrecha o cambia los filtros, prueba otras categorías, ajusta el rango de precios.
La técnica clave es ir de lo amplio a lo específico: primero encontrar algo aunque sea por un solo atributo y luego descartar lo sobrante con filtros adicionales. Esto es importante porque las formulaciones del cliente casi nunca coinciden con el catálogo al pie de la letra: el cliente dice «camiseta roja», y en el catálogo aparece «T-shirt Basic Red». Si el catálogo se lleva en otro idioma o con sus propias abreviaturas y nombres, el subagente primero revisa las categorías para entender los nombres reales y solo entonces busca por ellos.
De aquí una dependencia directa: la calidad de la selección no puede ser mejor que el propio catálogo. Cuanto más clara sea la estructura y más completas las descripciones y características de los productos, con más precisión encuentra el subagente lo necesario (sobre la situación contraria, en la sección «Antipatrones»).
Cómo se devuelve el resultado y la comunicación con el cliente
Al terminar su trabajo, el subagente devuelve el control al agente principal y le entrega el resultado: el carrito armado, el informe de texto de la búsqueda, o una solicitud de aclaración. Al cliente, como ya se dijo, no le escribe.
De esto se deriva cómo funcionan las aclaraciones. Si al subagente le falta información para completar la tarea (por ejemplo, el cliente no indicó la talla o no está claro a cuál de las variantes se refiere), el subagente no le pregunta al cliente por sí mismo: le devuelve la pregunta al agente principal. El agente principal le hace esa pregunta al cliente, recibe la respuesta y se la pasa de vuelta al subagente, tras lo cual este continúa su trabajo.
Mostrarle los productos al cliente también lo hace el agente principal, normalmente con tarjetas que llevan imagen, nombre, precio y enlace, no con texto simple. Los identificadores internos de los productos no se le muestran al cliente: solo sirven para el funcionamiento del sistema.
Configuración del comportamiento mediante instrucciones
El comportamiento del subagente se configura con dos slots del prompt (ver «Instrucciones»):
- «Trabajo con catálogo»: instrucciones para el agente principal: en qué situaciones recurrir al catálogo, qué consultas pasarle al subagente, qué es importante tener en cuenta. Si el agente principal no siempre nota a tiempo que es momento de buscar un producto, conviene complementar precisamente este slot.
- «Catálogo de productos»: instrucciones para el propio subagente: en qué campos y características apoyarse en la búsqueda, qué categorías y atributos tener en cuenta, las particularidades de la estructura del catálogo y de los nombres no estándar. Este slot es especialmente útil para catálogos con una estructura compleja o nombres poco habituales: ayuda al subagente a buscar con más precisión.
Mediante estos slots, el subagente se adapta a cada negocio y a la estructura de su catálogo, sin tocar la lógica de búsqueda integrada.