Agente precompilado de venta minorista

El agente compilado previamente basado en guías de venta minorista te permite buscar artículos, obtener recomendaciones de productos y realizar un pedido.

Diálogo de ejemplo

En este diálogo de ejemplo, se muestran situaciones comunes que controla este agente precompilado.

Buscar productos y comprar artículos

1. El usuario pregunta sobre los relojes disponibles en la tienda.
2. El agente recomienda productos que cumplen con estos criterios.
3. El usuario agrega el producto a su carrito.
4. El usuario agrega otro producto a su carrito.
5. El usuario pregunta sobre el contenido de su carrito.
6. El agente enumera los artículos del carrito y el usuario confirma que desea comprarlos.
7. El agente realiza el pedido y proporciona un número de confirmación.
8. El usuario pide una recomendación de teléfono.
9. El agente recomienda teléfonos disponibles en la tienda.
10. El usuario agrega uno a su carrito.
11. El usuario realiza un pedido del teléfono y proporciona un número de confirmación.

Entrada del usuario	Respuesta del agente
Hola
	Hola, soy tu asistente de Google Shopping. Puedo ayudarte a buscar artículos y realizar pedidos. ¿En qué puedo ayudarte?
¿Qué relojes tienes?
	Tenemos el Google Watch. ¿Quieres agregarlo al carrito?
sí, agrega dos, por favor
	Exacto. Agregué dos Google Watches a tu carrito. ¿Necesitas algo más?
¿Puedes agregar un Google Pixel 8 a mi carrito también?
	Exacto. Agregué un Google Pixel 8 a tu carrito. ¿Necesitas algo más?
¿Qué hay en mi carrito?
	Tienes un Google Pixel 8 y dos Google Watch en tu carrito. ¿Quieres pagar?
sí, por favor
	Muy bien, realicé un pedido que contiene un Google Pixel 8 y dos Google Watch. Tu número de confirmación es QKA67DW2.
	¿Hay algo más con lo que pueda ayudarte?
De hecho, ¿también puedes ayudarme a encontrar un teléfono nuevo?
	Tenemos el teléfono de Google Pixel 8 y el teléfono de Google Pixel 7. ¿Te gustaría comprar uno de estos?
Sí, dame un Pixel 8
	Exacto. Agregué un teléfono de Google Pixel 8 a tu carrito. ¿Necesitas algo más?
no, podemos revisar
	Tienes un teléfono de Google Pixel 8 en tu carrito. ¿Quieres pagar con este carrito?
sí
	Muy bien, ya realicé el pedido. Tu pedido contiene un teléfono de Google Pixel 8. Tu número de confirmación es Y43KTF0T.
	¿Hay algo más con lo que pueda ayudarte?
no, eso es todo, gracias
	De acuerdo, gracias por comprar con Google. Que tengas un lindo día.

Administración del carrito

El usuario pide agregar algunos artículos a su carrito y, luego, quita uno antes de realizar el pedido.

Entrada del usuario	Respuesta del agente
Hola, quiero comprar un teléfono
	Tenemos el teléfono de Google Pixel 8 y el teléfono de Google Pixel 7. ¿Cuál quieres comprar?
Dame dos de los 8
	Exacto. Agregué dos teléfonos Google Pixel 8 a tu carrito. ¿Necesitas algo más?
De hecho, ¿puedes quitar uno de ellos?
	Claro, quité un teléfono de Google Pixel 8 de tu carrito. ¿Necesitas algo más?
Tengo todo listo para realizar mi pedido
	Muy bien, realicé un pedido que contiene un teléfono Google Pixel 8. Tu número de confirmación es X0KP6K5T.
	¿Hay algo más con lo que pueda ayudarte?
no, eso es todo
	De acuerdo, gracias por comprar con Google. Que tengas un lindo día.

No se encontró el producto

El usuario pregunta sobre un producto que la tienda no tiene.

Entrada del usuario	Respuesta del agente
Hola
	Hola, soy tu asistente de Google Shopping. Puedo ayudarte a buscar artículos y realizar pedidos. ¿En qué puedo ayudarte?
Quiero comprar un auto
	Lo sentimos, no tenemos autos en stock. ¿Hay algo más que quieras buscar?
Sí, ¿qué pasa con los relojes?
	Tenemos el Google Watch. ¿Quieres agregarlo al carrito?
No, gracias
	¿Hay algo más con lo que pueda ayudarte?
nop
	De acuerdo, gracias por comprar con Google. Que tengas un lindo día.

No se reconoce la entrada

1. El usuario pregunta sobre un tema que no se relaciona con los productos ni con los pedidos.
2. El agente responde repitiendo los temas que abarca y le pregunta al usuario con qué necesita ayuda.

Entrada del usuario	Respuesta del agente
Hola
	Hola, soy tu asistente de Google Shopping. Puedo ayudarte a buscar artículos y realizar pedidos. ¿En qué puedo ayudarte?
Quiero reservar un hotel
	Lo siento, pero no puedo ayudarte con eso. Puedo ayudarte a buscar productos, como teléfonos, relojes y auriculares. También puedo ayudarte a realizar pedidos. ¿En qué puedo ayudarte?

Configuración básica

Sigue estos pasos para configurar este agente precompilado:

1. Importa el agente compilado previamente.
2. 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 para integrarse con servicios externos. Implementa el código de muestra y los datos para tu agente precompilado con el instalador de la herramienta.

Para implementar y configurar el código de muestra y los datos del agente compilado previamente de Retail, expanda las instrucciones.

1. Descarga el instalador de la herramienta compilada previamente en un directorio local.
2. Navega al directorio local en el que descargaste installer.zip.
3. Descomprime installer.zip y abre la carpeta installer.
4. Revisa el archivo README.md para obtener una descripción general detallada del instalador y sus requisitos.
5. Ejecuta pip install -r requirements.txt para instalar los requisitos.
6. Ejecuta gcloud auth application-default login para autenticarte con gcloud auth.
7. Ejecuta el instalador con python installer.py --project-id=YOUR_GCP_PROJECT_ID --prebuilt-id=retail
8. Después de implementar todos los servicios necesarios, configura cada herramienta en el agente compilado previamente con las URLs proporcionadas que registró el instalador:

   Generative AI App Builder

   1. Si aún no importaste el agente compilado previamente, impórtalo a tu proyecto.
   2. Ve a Generative AI App Builder.

      Generative AI App Builder

   3. Selecciona tu proyecto en el menú desplegable de la consola.
   4. Selecciona tu app.
   5. Haz clic en el ícono de Herramientas.
   6. Para cada herramienta del agente, edita el esquema para reemplazar la URL en el campo servers: por el extremo registrado por el instalador.
   7. Haz clic en Guardar.

   Dialogflow CX

   1. Si aún no importaste el agente compilado previamente, impórtalo a tu proyecto.
   2. Abre la consola de Dialogflow CX.
   3. Elige tu proyecto de Google Cloud.
   4. Selecciona el agente.
   5. Haz clic en el ícono de Recursos generativos.
   6. Haz clic en Herramientas.
   7. Para cada herramienta del agente, edita el esquema para reemplazar la URL en el campo servers por el extremo registrado por el instalador.
   8. Haz clic en Guardar.
9. Otorga a la cuenta de servicio de Compute Engine (your-project-number-developer.gserviceaccount.com) el rol de Usuario de Cloud Datastore, para que las funciones de Cloud Run recién implementadas puedan acceder a Firestore.

Herramienta de la API de Google Store

La herramienta de la API de Google Store recupera artículos de Google Store según un término de búsqueda.

Herramienta para administrar el carrito de compras

La herramienta Administrar carrito de compras permite que el usuario administre su carrito de compras viendo, agregando y quitando artículos.

Herramienta Place Order

La herramienta Place Order realiza un pedido para el carrito de compras actual del usuario y devuelve un número de confirmación.

Completado

Tu agente está configurado y listo para las pruebas.