Comienza a usar recomendaciones genéricas

Puedes compilar rápidamente una app de recomendaciones genéricas de última generación con tus propios datos que pueda sugerir contenido similar al que el usuario está viendo en ese momento.

En este instructivo, se explica cómo crear tres apps de recomendaciones genéricas, cada una para un tipo diferente de datos:

  • Datos no estructurados en forma de PDF transferidos desde un bucket de Cloud Storage
  • Datos estructurados en forma de NDJSON transferidos desde un bucket de Cloud Storage
  • Datos del sitio web provenientes de las URLs que proporciones

Antes de seguir este instructivo, asegúrate de haber realizado los pasos que se indican en Antes de comenzar.

Para seguir la guía paso a paso en esta tarea directamente en la consola de Google Cloud, haz clic en Guiarme:

GUIARME

Antes de comenzar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI Agent Builder, Cloud Storage APIs.

    Enable the APIs

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI Agent Builder, Cloud Storage APIs.

    Enable the APIs

    8.

Habilita Vertex AI Agent Builder

  1. En la consola de Google Cloud, ve a la página Agent Builder.

    Agent Builder

  2. Lee y acepta las Condiciones del Servicio y, luego, haz clic en Continuar y activar la API.

Crea un almacén de datos

Este procedimiento te guiará para crear un almacén de datos y subir los datos de muestra proporcionados. Haz clic en la pestaña del tipo de almacén de datos que deseas crear.

Datos del sitio web

  1. Ve a la página Almacenes de datos.

  2. Haz clic en Crear almacén de datos.

  3. En la página Selecciona una fuente de datos, elige Contenido de sitios web.

  4. En la página Especifica los sitios web para tu almacén de datos, ingresa las URLs de los sitios web que deseas incluir en la app de recomendaciones. Incluye una URL por línea, sin separadores de comas.

  5. Haz clic en Continuar.

  6. En la página Configura tu almacén de datos, ingresa un nombre visible para el almacén de datos y, luego, haz clic en Crear.

  7. En la página Almacenes de datos, selecciona tu almacén de datos nuevo y, luego, haz clic en Crear para crear tu app.

  8. En la página Datos, ve a la pestaña Actividad para ver el estado de la transferencia de datos. Se mostrará Importación completada en la columna Estado cuando se complete el proceso de importación. Es posible que debas hacer clic en Actualizar para ver Importación completada.

  9. Haz clic en la pestaña Documentos para ver los documentos importados.

Datos estructurados

  1. Ve a la página Almacenes de datos.

  2. Haz clic en Crear almacén de datos.

  3. En la página Selecciona una fuente de datos, elige Cloud Storage.

  4. En la página Importar datos de Cloud Storage, selecciona Datos estructurados (JSONL).

  5. Haz clic en Archivo.

  6. En el campo gs://, ingresa el siguiente valor:

    cloud-samples-data/gen-app-builder/search/kaggle_movies/movie_metadata.ndjson

    Este bucket de Cloud Storage contiene un archivo datos de películas con formato NDJSON disponible a través de Kaggle.

  7. Haz clic en Continuar.

  8. Asigna las propiedades clave de la siguiente manera:

    Nombre del campo Propiedad clave
    homepage uri
    original_title title
    overview description

    Y haz clic en Continuar.

  9. Ingresa un nombre visible para tu almacén de datos y, luego, haz clic en Crear.

  10. Haz clic en el nombre de tu almacén de datos.

  11. En la página Datos, ve a la pestaña Actividad para ver el estado de la transferencia de datos. Se mostrará Importación completada en la columna Estado cuando se complete el proceso de importación. Para este conjunto de datos, esto suele tardar entre dos y tres minutos. Es posible que debas hacer clic en Actualizar para ver Se completó la importación.

  12. Haz clic en la pestaña Documentos para ver los documentos importados.

Datos no estructurados

  1. Ve a la página Almacenes de datos.

  2. Haz clic en Crear almacén de datos.

  3. En la página Selecciona una fuente de datos, elige Cloud Storage.

  4. En la página Importar datos desde Cloud Storage, asegúrate de que Carpeta esté seleccionada.

  5. En el campo gs://, ingresa el siguiente valor:

    cloud-samples-data/gen-app-builder/search/alphabet-investor-pdfs

    Este bucket de Cloud Storage contiene archivos PDF con informes de ganancias del sitio para inversionistas de Alphabet.

  6. Selecciona Documentos no estructurados y, luego, haz clic en Continuar.

  7. Ingresa un nombre para tu almacén de datos y, luego, haz clic en Crear.

  8. Selecciona el almacén de datos que acabas de crear y, luego, haz clic en Crear para crear tu aplicación.

  9. En la página Datos de tu almacén de datos, ve a la pestaña Actividad para ver el estado de tu transferencia de datos. Se mostrará Importación completada en la columna Estado cuando se complete el proceso de importación. Para este conjunto de datos, esto suele tardar entre dos y tres minutos. Es posible que debas hacer clic en Actualizar para ver Se completó la importación.

  10. Haz clic en la pestaña Documentos para ver los documentos importados.

Crea una app

A continuación, crearás una app de recomendaciones y vincularás el almacén de datos que creaste anteriormente.

  1. Ve a la página Apps.

  2. Haz clic en Crear app.

  3. En la página Crear app, en Motor de recomendaciones, haz clic en Crear.

  4. En el campo Nombre de la app, ingresa un nombre para ella. El ID de la app aparece debajo del nombre de la app.

  5. Haga clic en Continuar.

  6. En la lista de almacenes de datos, selecciona los que creaste anteriormente.

  7. Haz clic en Crear.

Obtén una vista previa de la aplicación

Datos del sitio web

  1. En el menú de navegación, haz clic en Vista previa para probar la app.

  2. Haz clic en el campo URI. Aparecerá una lista de URLs de tu sitio web.

  3. Haz clic en la URL de la página web de la que quieres obtener recomendaciones. También puedes ingresar una URL de tu sitio web en el campo URL.

  4. Haz clic en Obtener recomendaciones. Aparecerá una lista de URLs de páginas web recomendadas.

  5. Haz clic en una URL para ver la página web.

Datos estructurados

  1. En el menú de navegación, haz clic en Vista previa para probar la app.

  2. Si ves el mensaje "Podrás obtener una vista previa de tu motor de recomendación aquí. Aún estamos preparando tu motor; vuelve a consultar más tarde", espera y actualiza la página periódicamente. Es posible que debas esperar algunas horas o al día siguiente para obtener una vista previa de tus datos.

  3. Haz clic en el campo ID del documento. Aparecerá una lista de los IDs de documento.

  4. Haz clic en el ID correspondiente al documento del que deseas obtener recomendaciones. También puedes escribir un ID de documento en el campo ID de documento.

  5. Haz clic en Obtener recomendaciones. Aparecerá una lista de documentos recomendados.

  6. Haz clic en un documento para obtener los detalles.

Datos no estructurados

  1. En el menú de navegación, haz clic en Vista previa para probar la app.

  2. Haz clic en el campo ID del documento. Aparecerá una lista de los IDs de documento.

  3. Haz clic en el ID correspondiente al documento del que deseas obtener recomendaciones. También puedes escribir un ID de documento en el campo ID de documento.

  4. Haz clic en Obtener recomendaciones. Aparecerá una lista de documentos recomendados.

  5. Haz clic en un documento para obtener los detalles.

Implementa la app

No hay widgets de recomendaciones para implementar la app. Para probar tu app antes de la implementación, haz lo siguiente:

  1. Ve a la página Datos y copia el ID de un documento.

  2. Ve a la página Integración. En esta página, se incluye un comando de muestra para el método servingConfigs.recommend en la API de REST.

  3. Pega el ID de documento que copiaste y pegaste antes en el campo ID de documento.

  4. Deja el campo Seudo-ID del usuario tal como está.

  5. Copia la solicitud de ejemplo y ejecútala en Cloud Shell.

    Los resultados son los IDs de documentos recomendados en función del documento que elegiste.

Si necesitas ayuda para integrar la app de recomendaciones en tu app web, consulta las muestras de código de C#, Go, Java, Node.js, PHP y Ruby en Obtén recomendaciones para una app.

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.

  1. A fin de evitar cargos innecesarios de Google Cloud, usa la consola de Google Cloud para borrar tu proyecto si no lo necesitas.
  2. Si creaste un proyecto nuevo para obtener información acerca de Vertex AI Agent Builder y ya no necesitas el proyecto, borra el proyecto.
  3. Si usaste un proyecto existente de Google Cloud, borra los recursos que creaste para evitar que se generen cargos en tu cuenta. Para obtener más información, consulta Borra una app.
  4. Sigue los pasos que se indican en Desactiva Vertex AI Agent Builder.

¿Qué sigue?