En esta página, se incluye un conjunto de instructivos interactivos para Vertex AI Search for Retail. Estos instructivos incluyen acciones que se pueden ejecutar en el editor de Google Cloud Shell. Con esta herramienta, puedes escribir, compilar, probar, ejecutar y depurar los recursos nativos de la nube aplicaciones directamente desde el navegador.
Descripción general
Prueba diferentes instructivos según lo que quieras aprender:
Si estás comenzando un proyecto, prueba los instructivos para importar información del catálogo. Aquí, aprenderás a importar productos al catálogo para que puedas probar, por ejemplo, diferentes funciones de búsqueda. A continuación, consulta la Cómo importar eventos históricos de los usuarios instructivos. Vertex AI Search para la venta minorista usa eventos de usuario para generar recomendaciones iniciales y resultados de la búsqueda. Luego, prueba los instructivos para registrar eventos de usuario en tiempo real. Los eventos de usuario en tiempo real proporcionan una alta calidad resultados relevantes.
Si te interesa saber cómo funciona la búsqueda en general, prueba la Buscar instructivos
Si quieres aprender a configurar la búsqueda con controles y parámetros de configuración de publicación, prueba los siguientes instructivos:
Si necesitas actualizar la información de tu catálogo, consulta el Administra la información del catálogo instructivos.
Si quieres aprender a actualizar el inventario, consulta los instructivos para actualizar el inventario para la Búsqueda.
Si deseas obtener información para registrar, ver o quitar eventos de usuario en tiempo real, consulta los instructivos para registrar eventos de usuario en tiempo real.
Si planeas usar recomendaciones, consulta los instructivos para importar y administrar catálogos y eventos de usuario.
Importa información del catálogo
En estos instructivos, se describe cómo importar la información de tu catálogo y mantenerla actualizada.
Importa datos de un catálogo desde BigQuery
En este instructivo, se muestra cómo usar una tabla de BigQuery para importar grandes cantidades de datos de catálogo sin límites.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Importa datos de catálogo desde Cloud Storage
En este instructivo, se muestra cómo importar una gran cantidad de artículos a un catálogo.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Importa datos del catálogo de forma intercalada
En este instructivo, se muestra cómo importar productos a un catálogo intercalado.
Para seguir la guía paso a paso de esta tarea directamente en el editor de Cloud Shell, Haz clic en Guiarme:
Administra la información del catálogo
En estos instructivos, se describe cómo administrar la información del producto importaron un catálogo. Puedes leer, escribir y borrar productos en tu catálogo.
Aprende a llamar a la API con el idioma que prefieras.
Instructivo para crear, obtener, actualizar o borrar productos
En este instructivo, se muestra cómo usar la API métodos, que realizan las siguientes acciones:
- Crea un producto
- Obtén un producto
- Actualiza un producto
- Borrar un producto
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo para crear un producto
En este instructivo, se muestra cómo crear un solo producto.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo para obtener un producto
En este instructivo, se muestra cómo recuperar un artículo de producto.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo para actualizar productos
En este instructivo, se muestra cómo actualizar un producto de un catálogo.
Para seguir la guía paso a paso de esta tarea directamente en el editor de Cloud Shell, Haz clic en Guiarme:
Instructivo para borrar un producto
En este instructivo, se muestra cómo borrar un producto de un catálogo.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Importa eventos históricos de usuarios
En estos instructivos, se describe cómo importar datos de eventos de usuario de forma masiva desde eventos anteriores. Los modelos requieren datos de eventos de usuario para el entrenamiento.
Instructivo para importar eventos de Cloud Storage
En este instructivo, se muestra cómo importar eventos de usuario desde Cloud Storage.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo para importar eventos de BigQuery
En este instructivo, se muestra cómo importar eventos de usuario desde BigQuery.
Para seguir la guía paso a paso de esta tarea directamente en el editor de Cloud Shell, Haz clic en Guiarme:
Instructivo para importar eventos intercalados
En este instructivo, se muestra cómo importar datos de eventos de usuario de forma intercalada.
Para seguir la guía paso a paso de esta tarea directamente en el editor de Cloud Shell, Haz clic en Guiarme:
Registra eventos de usuario en tiempo real
En estos instructivos, se describe cómo registrar, ver o quitar eventos de usuarios en tiempo real. Vertex AI Search para venta minorista usa eventos de usuario en tiempo real para generar recomendaciones y resultados de la búsqueda. Registrar todos los tipos de eventos de usuario posibles con información válida del producto aumenta la calidad de tus resultados.
Instructivo para escribir eventos de usuario
En este instructivo, se muestra cómo registrar eventos de usuario con el método userEvents.write.
Para seguir la guía paso a paso de esta tarea directamente en el editor de Cloud Shell, Haz clic en Guiarme:
Instructivo para volver a unir los eventos de usuario
En este instructivo, se muestra cómo volver a unir eventos de usuario mediante una solicitud POST al
extremo userEvents:rejoin.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo para quitar eventos de usuario
En este instructivo, se muestra cómo borrar definitivamente los eventos de usuario.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivos de Búsqueda
El método search() se usa para buscar en el catálogo según la búsqueda y otros parámetros, como filter, order_by o facet.
De forma predeterminada, la respuesta a la búsqueda incluye una cantidad razonable de resultados ordenados por relevancia.
Instructivo de búsqueda
En este instructivo, se muestra cómo enviar una búsqueda sencilla y analizar la respuesta.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo de paginación
En este instructivo, se muestra cómo controlar la paginación en la solicitud de búsqueda. Cuando un comprador busca productos en una tienda, puede mejorar su navegación a través de los resultados de la búsqueda. Por ejemplo, pueden limitar la cantidad de elementos en la respuesta de búsqueda usando la función de tamaño de página o saltar a la página preferida con la función de desplazamiento.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo de búsqueda expandida
En este instructivo, se muestra cómo habilitar la función de búsqueda expandida. Cuando un comprador usa una frase de búsqueda ambigua o de varias palabras, puede obtener una respuesta vacía. Después de activar la expansión de búsqueda, se analiza la solicitud y se muestra la lista expandida de productos según la búsqueda analizada.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo de filtrado
En este instructivo, se muestra la función de filtrado. Te permite ajustar mejor las solicitudes de búsqueda según tus necesidades o las del cliente. Puedes filtrar por uno o varios campos, por campos de texto o numéricos, o por ambos. Puedes usar un lenguaje de expresión a fin de construir un predicado para cada campo o combinar diferentes expresiones mediante operadores lógicos. Por ejemplo, un comprador que busca zapatos puede usar filtros para limitar su búsqueda a la marca y el color que prefiere.
Para seguir la guía paso a paso de esta tarea directamente en el editor de Cloud Shell, Haz clic en Guiarme:
Instructivo de ordenamiento
En este instructivo, se muestra cómo ordenar elementos en una respuesta de búsqueda. Cuando un comprador busca un producto en tu sitio, puedes mostrar los resultados ordenados por varios campos. Por ejemplo, un comprador busca un vestido con el mejor precio y descuento. El precio y el descuento son varios de los campos que se encuentran aquí. Al comprador se muestran los vestidos ordenados por precio, y para los vestidos del mismo precio ordenados por descuento.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo de boosting
En este instructivo, se muestran algunos ejemplos de productos destacados en los resultados de la búsqueda. Con la mejora, puedes aplicar una mejora a un producto para priorizarlo o reducir su prioridad en los resultados de la búsqueda.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo de control de redireccionamiento
En este instructivo, se muestra cómo usar el control de redireccionamiento. Este control permite especificar una URL a la que puedes redireccionar a los usuarios cuando utilizan una búsqueda específica. Por ejemplo, si un usuario solicita "productos de fabricación sustentables", puedes redireccionarlo a una página que contenga las marcas ambientales con las que estás trabajando.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Actualiza el inventario para la búsqueda
Si bien los métodos Product de creación, lectura, actualización y eliminación (CRUD) se usan para modificar de forma amplia los atributos de un Product, hay un conjunto de métodos Product que se pueden usar para actualizar campos específicos del inventario con diferentes niveles de detalle. Los siguientes campos Product se consideran campos de inventario:
Product.price_infoProduct.availabilityProduct.available_quantityProduct.fulfillment_info
Instructivo para agregar entregas
En este instructivo, se muestra cómo actualizar la información de entrega de productos con la
AddFulfillmentPlaces
. De esta manera, la búsqueda puede mostrar actualizaciones sobre los productos disponibles y la entrega de pedidos. Por ejemplo, un comprador busca jeans azules en una tienda, pero no hay en stock. En el momento en que los jeans vuelvan a estar en stock en esta tienda o en cualquier otra, el comprador verá las actualizaciones y podrá continuar con su pedido.
Para seguir la guía paso a paso de esta tarea directamente en el editor de Cloud Shell, Haz clic en Guiarme:
Instructivo para quitar entregas
En este instructivo, se muestra cómo actualizar la información de entrega de productos con
Usa el método RemoveFulfillmentPlaces. De esta manera, la búsqueda puede mostrar actualizaciones en las que los productos no están disponibles y los pedidos no se pueden entregar. Por ejemplo, un comprador busca jeans azules en una tienda. Si los jeans se agotan en esta tienda, el comprador ve esto y no puede continuar con el pedido.
Para seguir la guía paso a paso de esta tarea directamente en el editor de Cloud Shell, Haz clic en Guiarme:
Instructivo para configurar el inventario
En este instructivo, se muestra cómo enviar actualizaciones de inventario con la API de
SetInventory
en lugar de actualizar todo el producto.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme: