Agente precompilado de venta minorista

El agente prediseñado basado en un manual de Retail permite a los usuarios buscar artículos, obtener recomendaciones de productos y hacer pedidos.

Diálogos de muestra

En los siguientes diálogos de ejemplo, se muestran situaciones comunes que maneja este agente prediseñado.

Buscar productos y comprar artículos

El usuario pregunta sobre los relojes disponibles en la tienda. El agente recomienda productos que cumplen con este criterio, y el usuario los agrega a su carrito de compras. El usuario confirma que desea realizar un pedido, y el agente lo confirma con un número de confirmación. Luego, el usuario solicita recomendaciones de teléfonos, y el agente sugiere teléfonos, agrega uno al carrito del usuario y realiza un pedido para el usuario.

Entrada del usuario	Respuesta del agente
hi
	Hola, soy tu asistente de compras de Google. Puedo ayudarte a buscar artículos y hacer pedidos. ¿En qué puedo ayudarte?
¿Qué relojes tienes?
	Tenemos el Google Watch. ¿Quieres agregarlo a tu carrito?
Sí, agrega dos, por favor.
	Exacto. Agregué dos relojes Google Watch 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 Watches en el carrito. ¿Quieres pagar?
Sí, por favor.
	De acuerdo. Hice un pedido que contiene un Google Pixel 8 y dos Google Watches. Tu número de confirmación es QKA67DW2.
	¿Hay algo más con lo que pueda ayudarte?
¿Puedes ayudarme a encontrar un teléfono nuevo también?
	Tenemos el teléfono Google Pixel 8 y el teléfono Google Pixel 7. ¿Te gustaría comprar uno de estos?
Sí, quiero un Pixel 8
	Exacto. Agregué un teléfono Google Pixel 8 a tu carrito. ¿Necesitas algo más?
No, podemos salir.
	Tienes un Google Pixel 8 en el carrito. ¿Quieres pagar con este carrito?
sí
	De acuerdo, realicé un pedido para ti. Tu pedido contiene un teléfono Google Pixel 8. Tu número de confirmación es Y43KTF0T.
	¿Hay algo más con lo que pueda ayudarte?
No, eso es todo por mi parte. Gracias.
	De acuerdo. Gracias por comprar con Google. Que tengas un buen día.

Administración del carrito

El usuario pide que se agreguen algunos artículos a su carrito y, luego, quita uno antes de realizar un pedido.

Entrada del usuario	Respuesta del agente
Hola, quiero comprar un teléfono
	Tenemos el teléfono Google Pixel 8 y el teléfono Google Pixel 7. ¿Cuál quieres comprar?
dame dos del 8
	Exacto. Agregué dos teléfonos Google Pixel 8 a tu carrito. ¿Necesitas algo más?
¿Podrías quitar uno de ellos?
	Claro, quité un teléfono Google Pixel 8 de tu carrito. ¿Necesitas algo más?
Tengo todo listo para hacer mi pedido
	De acuerdo. Hice 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 buen día.

No se encontró el producto

El usuario pregunta por un producto que no vende la tienda.

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

Entrada no reconocida

El usuario pregunta sobre un tema que no está relacionado con los productos o los pedidos. El agente responde repitiendo los temas que abarca y le pregunta al usuario con qué le gustaría recibir ayuda.

Entrada del usuario	Respuesta del agente
hi
	Hola, soy tu asistente de compras de Google. Puedo ayudarte a buscar artículos y hacer 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 hacer pedidos. ¿En qué puedo ayudarte?

Configuración básica

Para configurar este agente precompilado, haz lo siguiente:

1. Importa el agente precompilado.
2. Configura las herramientas proporcionadas con tus servicios externos. Consulta Configuración de herramientas.

Configuración de la herramienta

Este agente incluye herramientas que se usan para integrarse con servicios externos. Puedes usar el instalador de herramientas prediseñado para implementar código y datos de muestra para tu agente prediseñado.

Para implementar y configurar el código y los datos de muestra para el agente prediseñado de Retail, expande las instrucciones.

1. Descarga el instalador de herramientas compiladas 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 requeridos, configura cada herramienta en el agente compilado previamente con las URLs proporcionadas que registró el instalador:

   Consola de Vertex AI Agent Builder

   1. Si aún no importaste el agente precompilado, impórtalo a tu proyecto.
   2. Ve a la consola de Vertex AI Agent Builder.

      Consola de Vertex AI Agent 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 precompilado, 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 Cloud Run Functions recién implementadas puedan acceder a Firestore.

Google Store API

La herramienta Google Store API se usa para recuperar elementos de Google Store según un término de búsqueda.

Administrar el carrito de compras

La herramienta Manage Shopping Cart permite que el usuario administre su carrito de compras. Para ello, puede ver todos los artículos del carrito, agregar artículos y quitarlos.

Realizar pedido

La herramienta Place Order se usa para realizar un pedido con el carrito de compras actual del usuario y devuelve un número de confirmación para el pedido realizado.

Completado

Tu agente y sus integraciones ya deberían estar configurados y listos para probarse.