El agente precompilado basado en guías de Shopping Assistant proporciona consultas de productos de venta minorista, pedidos, estado de pedidos y cancelación de pedidos. Usa el agente de Search para venta minorista y las cargas útiles de entrega personalizadas para proporcionar una experiencia visual enriquecida.
Diálogo de ejemplo
En este diálogo de ejemplo, se muestran situaciones comunes que controla este agente precompilado.
Comparación de productos y opiniones
- El usuario pide explorar saris tradicionales.
- El agente presenta algunas opciones populares y el usuario selecciona la primera.
- El usuario pide zapatos que combinen.
- El agente presenta algunas opciones populares, y el usuario pide comparar las opiniones y selecciona la opción con la calificación más alta.
- El agente pregunta por el talle y confirma que se agregaron los zapatos al carrito.
| Entrada del usuario | Respuesta del agente |
|---|---|
| muéstrame saris tradicionales | |
| [Presenta los productos] ¿Alguno de estos productos te llama la atención o buscas otras opciones? | |
| La primera se ve bien | |
| Excelente elección. El sari de georgette de moda, con diseño propio y estampado, de Indian Beauty, es una prenda hermosa. Como los saris suelen ser de talla única, te quedará perfecto. ¿Quieres agregarlo al carrito? | |
| ¿Tienes tacones que combinen? | |
| [Presenta los productos] ¿Alguno de estos productos te llama la atención o buscas otras opciones? | |
| Sí, pero ¿puedes revisar las opiniones de los clientes y elegir la mejor de ellas? | |
| Los zapatos de tacón para mujer de Flat n Heels tienen una calificación promedio de 4 estrellas de 5, mientras que los de Glitzy Galz tienen una calificación promedio de 4.5 estrellas de 5. Los clientes que compraron los zapatos de tacón para mujer de Flat n Heels tuvieron opiniones variadas: algunos los encontraron cómodos al principio, pero incómodos después de unas horas, mientras que otros elogiaron su comodidad. Por otro lado, los zapatos de tacón para mujer de Glitzy Galz recibieron opiniones mayormente positivas, en las que los clientes elogiaron su ajuste, calidad y diseño. ¿Cuál quieres agregar al carrito? | |
| el que tenga las mejores opiniones y calificaciones | |
| Los zapatos de tacón para mujer de Glitzy Galz tienen la calificación más alta, de 4.5 estrellas de 5. ¿Qué talle buscas para los zapatos de taco alto Glitzy Galz para mujer? Tenemos talles del 5 al 11. | |
| 6 | |
| ¡Perfecto! Se agregó a tu carrito 1 par de zapatos de tacón para mujer de Glitzy Galz en talle 6. ¿Hay algo más que quieras agregar al carrito? |
Experiencia de compra de extremo a extremo
- El usuario explora el catálogo de productos.
- El agente presenta recomendaciones según la solicitud del usuario.
- Después de algunas búsquedas, el usuario encuentra un artículo para comprar.
- El agente confirma el tamaño y la cantidad del artículo que se comprará, y la fecha de entrega prevista.
- El usuario solicita una fecha de entrega diferente, que no está disponible, y acepta la fecha de entrega original.
- El agente confirma la información de entrega, pago y contacto registrada.
- El usuario actualiza la información de entrega y confirma.
- El agente realiza el pedido y le proporciona al usuario el número de pedido.
| Entrada del usuario | Respuesta del agente |
|---|---|
| Se está enfriando. ¿Tienes buenos suéteres? | |
| [Presenta productos]. ¿Te interesa alguno de estos productos o buscas otras opciones? | |
| Me gusta el suéter de mujer para mi esposa, pero estoy buscando un suéter para niño | |
| [Presenta productos]. ¿Te interesa alguno de estos productos o buscas otras opciones? | |
| agregar el primer suéter para mujer al carrito | |
| ¿Qué talle quieres para el suéter Nineteen liso de cuello redondo para mujer? Tenemos tallas desde la extrapequeña hasta la extragrande. | |
| medio | |
| ¡Perfecto! Se agregó a tu carrito 1 unidad del suéter casual de cuello redondo liso para mujer de Nineteen en talla mediana. ¿Hay algo más que quieras agregar al carrito? | |
| no | |
| La fecha más temprana en la que podemos entregarte el suéter casual de cuello redondo liso Nineteen para mujer es el 29 de abril de 2024. ¿Te parece bien? | |
| ¿Puedes entregarlo el 28 de abril? | |
| Lamentablemente, no podemos entregar el suéter casual de cuello redondo liso Nineteen para mujer el 28 de abril de 2024. La fecha más temprana en la que podemos entregarlo es el 29 de abril de 2024. | |
| Ok, mantén la fecha de entrega tal como está | |
| Muy bien, tu suéter casual de cuello redondo liso Nineteen para mujer se entregará el 29 de abril de 2024. Ahora, revisemos los detalles de tu perfil para asegurarnos de que todo esté actualizado:\ | |
| Dirección de entrega: 638 Maple Street, Apt 11, Cupertino, CA 95014\ | |
| Información de pago: Visa que termina en 4111 Número de contacto: 416-555-5555 Correo electrónico: email@example.com Revisa estos detalles. Si todo está bien, confirma la acción. Si necesitas hacer algún cambio, avísame. |
|
| Mi dirección cambió a 371 Talbot Street Carmichael, CA 95608 | |
| Tu dirección de entrega se actualizó correctamente a 371 Talbot Street, Carmichael, CA 95608. ¿Hay algo más que quieras modificar? | |
| no | |
| Se realizó correctamente tu pedido del suéter casual de cuello redondo liso para mujer de Nineteen con el ID de pedido ee6b4cc7. La entrega está programada para el 29 de abril de 2024. | |
| gracias | |
| Se realizó tu pedido correctamente. ¿Podemos ayudarte con algún otro asunto? | |
| No, gracias | |
| Me alegra haber podido ayudarte. Si alguna vez necesitas algo de Cymbal Apparel, estoy a solo un clic de distancia.\ |
Cómo verificar el estado de un pedido
- El usuario solicita verificar el estado de un pedido.
- El agente recopila el número de pedido y recupera la información del pedido.
- El agente proporciona detalles sobre los artículos del pedido y la fecha de entrega prevista.
| Entrada del usuario | Respuesta del agente |
|---|---|
| Hola | |
| No dudes en seleccionar una de las opciones anteriores o simplemente escribe lo que buscas y te ayudaré. | |
| Quiero consultar el estado de mi pedido | |
| Claro, puedo ayudarte con eso. Para comenzar, ¿podrías proporcionarme tu ID de pedido? | |
| ee6b4cc7 | |
| Se confirmó tu pedido. Se está procesando en este momento. Esto es lo que pediste: Suéter casual de cuello redondo liso para mujer Nineteen Talle: Mediano Cantidad: 1 Fecha de entrega estimada: 29 de abril de 2024 ¿Hay algo más en lo que pueda ayudarte? |
|
| No, gracias | |
| Me alegra haber podido ayudarte. Si alguna vez necesitas algo de Cymbal Apparel, estoy a un clic de distancia. |
Devolución de un pedido
- El usuario quiere devolver un pedido.
- El agente recopila el número de pedido, recupera los detalles del pedido y confirma el artículo que se devolverá.
- El agente inicia el proceso de devolución y proporciona una etiqueta de devolución para que el usuario la imprima y la pegue en el paquete.
| Entrada del usuario | Respuesta del agente |
|---|---|
| Hola | |
| No dudes en seleccionar una de las opciones anteriores o simplemente escribe lo que buscas y te ayudaré. | |
| Quiero devolver mi pedido | |
| Estoy aquí para ayudarte con la devolución. Para comenzar, ¿podrías indicarme tu número de pedido? | |
| 0fc77d64 | |
| Gracias por proporcionar tu número de pedido. Encontré tu pedido realizado el 12 de abril de 2024. El pedido contiene una camiseta azul oscuro con cuello redondo para niño con estampado de YK en talla pequeña. ¿Es ese el artículo que quieres devolver? | |
| sí | |
| Muy bien, ya inicié el proceso de devolución. Encontrarás la etiqueta de devolución adjunta a continuación. Imprímela y pégala en el paquete antes de enviarlo. ¿Podemos ayudarte con algún otro asunto? | |
| No, gracias | |
| Me alegra haber podido ayudarte. Si alguna vez necesitas algo de Cymbal Apparel, estoy a un clic de distancia. |
Configuración básica
Para configurar este agente compilado previamente, haz lo siguiente:
- Importa el agente compilado previamente.
- Configura las herramientas proporcionadas con tus servicios externos. Para obtener más información, consulta Configuración de la herramienta.
Configuración de la herramienta
Este agente incluye herramientas que se usan para integrarse con servicios externos. Para configurar estas herramientas, sigue estos pasos:
- Crea una
base de datos de Firestore
llamada
apparel-db. - Crea un conector de integración de Firestore.
- Descarga Application Integration para el asistente de compras.
- Reemplaza todas las referencias a
projects/customermod-genai-sa/locations/us-central1/connections/firestorepor el identificador del conector creado en el paso 2. - Sube y publica la integración.
- Otorga el rol
Cloud Functions Invokera tu agente de servicio de Dialogflow. - Sigue los pasos para configurar tu catálogo de Retail.
- Actualiza los controles de atributos para que se puedan recuperar los siguientes campos: ageGroups, availability, categories, colorFamilies, colors, conditions, cost, currencyCode, description, discount, images, materials, patterns, price, sizes, title, URI.
- Importa el catálogo de muestra a la rama 1 de tu catálogo y conviértela en la rama predeterminada.
- Descarga la
función de Cloud Run y actualiza
config.toml. - Sigue los pasos para implementar la función de Cloud Run.
- Otorga el rol de IAM de
Retail Viewera la Cloud Run Function que implementaste. - Para las siguientes herramientas:
get-order-status,order-lookup,place-orderyreturn-order, actualiza la propiedadpathspara que haga referencia a la integración que creaste en el paso 5 en las especificaciones de OpenAPI y elige Autenticación de cuenta de servicio con una cuenta de servicio a la que le otorgues el rolApplication Integration Invoker. - Actualiza la propiedad de la URL del servidor a la función de Cloud Run que implementaste para las herramientas restantes.
Herramienta de búsqueda de productos
La herramienta search-products recupera los productos que mejor coinciden según
la búsqueda y el valor de desplazamiento del catálogo de productos. La herramienta devuelve una
respuesta de carga útil personalizada que incluye los detalles del producto. La IU usa esta carga útil personalizada para mostrar los productos en forma de contenido enriquecido.
Herramienta Obtener detalles del producto
La herramienta get-product-details recupera los detalles del producto del catálogo de productos
con la API de AI Commerce Search. Luego, el sistema transforma y devuelve los
detalles del producto recuperados en un formato simplificado, que el agente usa para responder
preguntas sobre los productos que le mostró al usuario.
Herramienta Obtener opiniones
La herramienta get-reviews recupera opiniones sobre productos. Espera una lista de
productos mostrados y recupera las opiniones de cada producto. Las opiniones generadas
se transforman en un formato de plantilla personalizada (review_template) adecuado para
mostrarse en una interfaz de usuario enriquecida.
Herramienta Productos similares
La herramienta similar-products facilita el descubrimiento de productos similares a un
producto especificado con la API de Retail Recommendation. Acepta un ID del producto
y usa la API de Recommender de Retail para predecir productos similares del
catálogo de productos.
Herramientas de fecha de entrega
La herramienta store-delivery-date es responsable de almacenar la fecha de entrega preferida del usuario para los artículos del carrito de compras, que se debe comparar con la fecha de entrega estimada más temprana.
La herramienta get-delivery-date estima la fecha de entrega de los artículos del
carrito de compras.
Herramienta Get User Info
La herramienta get-user-info recupera la información personal del usuario, incluida
la dirección de envío, la información de pago, el número de teléfono y el correo electrónico. La herramienta update-user-info actualiza la información del usuario.
Herramienta Place Order
La herramienta place-order realiza un pedido de los artículos del carrito de compras. Almacena los
datos del pedido en Firestore, incluidos el ID del pedido, el estado, la marca de tiempo de creación
y la lista de productos, y, luego, devuelve el número de pedido al agente.
Herramienta de búsqueda de pedidos
La herramienta order-lookup recupera los datos del pedido de una base de datos de Firestore
con el ID del pedido proporcionado y devuelve la información del pedido al agente.
Herramienta para devolver pedidos
La herramienta return-order actualiza el estado de un pedido a "return_pending" en
la base de datos de Firestore, lo que indica que se inició una devolución y está
pendiente.
Herramienta para obtener el estado del pedido
La herramienta get-order-status recupera el estado de un pedido y, si se envía, lo rastrea con la API de DHL. Proporciona mensajes adecuados según
el estado del pedido.
Completado
Tu agente y sus integraciones ya deberían estar configurados y listos para probarse.