Cómo comenzar a usar la búsqueda genérica

Cómo comenzar a usar la búsqueda genérica

Vertex AI Search combina la potencia de la recuperación profunda de información, el procesamiento de lenguaje natural de vanguardia y lo último en procesamiento de lenguajes grandes con el objetivo de comprender la intención del usuario y mostrar los resultados más relevantes para este.

Con Vertex AI Search, puedes crear apps para buscar y hacer recomendaciones. Vertex AI Search también tiene capacidades especiales para algunos sectores, como los de medios de comunicación, salud y venta minorista.

Este instructivo se enfoca en la creación de una app de búsqueda para datos genéricos, es decir, datos que no son específicos de una vertical de la industria.

En este instructivo, se explica cómo crear apps de búsqueda para diferentes tipos de datos:

• Datos de sitios web a partir del rastreo de cloud.google.com/generative-ai-app-builder/
• Datos estructurados en forma de un conjunto de datos con formato NDJSON transferidos desde un bucket de Cloud Storage
• Datos no estructurados en forma de PDF transferidos desde un bucket de Cloud Storage

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

Nota: Este instructivo es para Vertex AI Search. Para comenzar a usar Agentes de Vertex AI, consulta el codelab: Crea una app de chat generativo.

---

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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

4. Enable the Vertex AI Agent Builder (Discovery Engine), BigQuery, Cloud Storage APIs.

   Enable the APIs

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

7. Enable the Vertex AI Agent Builder (Discovery Engine), BigQuery, Cloud Storage APIs.

   Enable the APIs

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

Primero, crearás un almacén de datos que contenga los datos que indexará tu app de búsqueda.

Haz clic en la pestaña del tipo de datos que deseas incluir en tu almacén de datos: sitio web, estructurados o no estructurados.

Datos del sitio web

1. Ve a la página Crear almacén de datos.

   Agent Builder: Crea un almacén de datos

2. En el panel Selecciona una fuente de datos, elige el contenido del sitio web.

3. En el panel Especifica los sitios web para tu almacén de datos, asegúrate de que la indexación avanzada de sitios web está desactivada.

4. En el campo Sitios que deben incluirse, ingresa lo siguiente:

   cloud.google.com/generative-ai-app-builder/*
   

5. Haz clic en Continuar.

6. En el panel Configura tu almacén de datos, selecciona global (Global) como la ubicación de tu almacén de datos.

7. Ingresa un nombre para tu almacén de datos. Toma nota del ID que se genera. Lo necesitarás más adelante.

8. Haz clic en Crear.

Datos estructurados

1. Ve a la página Crear almacén de datos.

   Agent Builder: Crea un almacén de datos

2. En el panel Selecciona una fuente de datos, elige Cloud Storage.

3. En el panel Importar datos desde Cloud Storage, selecciona Datos estructurados (JSONL).

4. Asegúrate de que la opción Archivo esté seleccionada.

5. 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.

6. Haz clic en Continuar.

7. Asigna las propiedades clave de la siguiente manera:

   Nombre del campo	Propiedad clave
   homepage	uri
   overview	description

   Y haz clic en Continuar.

8. En el panel Configura tu almacén de datos, selecciona global (Global) como la ubicación de tu almacén de datos.

9. Ingresa un nombre para tu almacén de datos. Toma nota del ID que se genera. Lo necesitarás más adelante.

10. Haz clic en Crear.

Datos no estructurados

1. Ve a la página Crear almacén de datos.

   Agent Builder: Crea un almacén de datos

2. En el panel Selecciona una fuente de datos, elige Cloud Storage.

3. En el panel Importar datos desde Cloud Storage, selecciona Documentos no estructurados (PDF, HTML, TXT y más).

4. Asegúrate de que la opción 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. En el panel Configura tu almacén de datos, selecciona global (Global) como la ubicación de tu almacén de datos.

7. Ingresa un nombre para tu almacén de datos. Toma nota del ID que se genera. Lo necesitarás más adelante.

8. Haz clic en Crear.

Crea una app de búsqueda

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

Datos del sitio web

1. Ve a la página Crear app.

   Agent Builder: Crea una app

2. En Busca tu sitio web, haz clic en Crear.

3. Asegúrate de que la opción Funciones de la edición Enterprise esté activada.

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

5. En el campo Nombre externo de tu organización o empresa, ingresa el nombre de la organización o empresa. Para este instructivo, puedes usar Google Cloud, ya que la app buscará un sitio web de Google Cloud.

6. Selecciona global (Global) como la ubicación de tu app y, luego, haz clic en Continuar.

7. En la lista de almacenes de datos, selecciona el que creaste anteriormente y, luego, haz clic en Crear.

8. Ve a la página Datos de tu app para ver la lista de sitios web indexados y cambiarlos si es necesario.

Datos estructurados

1. Ve a la página Crear app.

   Agent Builder: Crea una app

2. En Busca tu sitio web, haz clic en Crear.

3. Asegúrate de que la opción Funciones de la edición Enterprise esté activada.

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

5. En el campo Nombre externo de tu organización o empresa, ingresa el nombre de la organización o empresa. Para este instructivo, puedes usar Cymbal Cinemas, ya que la app buscará un almacén de datos de películas.

6. Selecciona global (Global) como la ubicación de tu app y, luego, haz clic en Continuar.

7. En la lista de almacenes de datos, selecciona el que creaste anteriormente y, luego, haz clic en Crear.

8. En la página Datos de tu app, haz clic en 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.

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

Datos no estructurados

1. Ve a la página Crear app.

   Agent Builder: Crea una app

2. En Busca tu sitio web, haz clic en Crear.

3. Asegúrate de que la opción Funciones empresariales esté activada.

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

5. En el campo Nombre externo de tu organización o empresa, ingresa el nombre de la organización o empresa. Para este instructivo, puedes usar Alphabet, ya que la app buscará en los documentos de Alphabet.

6. Selecciona global (Global) como la ubicación de tu app y, luego, haz clic en Continuar.

7. En la lista de almacenes de datos, selecciona el que creaste anteriormente y, luego, haz clic en Crear.

8. En la página Datos de tu app, haz clic en la pestaña Actividad para ver el estado de tu transferencia de datos. Cuando finaliza el proceso de importación, la columna Estado, se muestra Se completó la importación. Para este conjunto de datos, el proceso de importación suele tardar entre dos y tres minutos. Es posible que debas hacer clic en Actualiza la página para ver el estado Se completó la importación.

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

Obtén una vista previa de la aplicación

Datos del sitio web

1. En la página Apps, haz clic en el nombre de tu nueva app.

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

3. Haz clic en los íconos de vista para alternar entre la vista para dispositivos móviles y la vista de escritorio (opcional).

4. En la barra de búsqueda, busca Vertex AI Search para ver los resultados sobre el producto.

Datos estructurados

1. En la página Apps, haz clic en el nombre de tu nueva app.

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

3. Haz clic en los íconos de vista para alternar entre la vista para dispositivos móviles y la vista de escritorio (opcional).

4. En la barra de búsqueda, ingresa trains y, luego, presiona Intro para obtener resultados para películas relacionadas con trenes.

Datos no estructurados

1. En la página Apps, haz clic en el nombre de tu nueva app.

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

3. Haz clic en los íconos de vista para alternar entre la vista para dispositivos móviles y la vista de escritorio (opcional).

4. En la barra de búsqueda, ingresa Google y, luego, presiona Intro para ver los resultados.

Configura el widget de búsqueda

1. En el menú de navegación, haz clic en Configuraciones.

2. En la pestaña IU, configura la app de búsqueda.

   Existen diferentes parámetros de configuración de la IU disponibles para diferentes tipos de datos. Para obtener más información, consulta Cómo configurar los resultados para el widget de búsqueda.

3. Si cambias la configuración en la pestaña IU, haz clic en Guardar y publicar.

4. Ve a la pestaña Autocompletar para configurar parámetros específicos de esta función.

   Para obtener más información, consulta Configura la función de autocompletar.

5. Ve a la pestaña Avanzado para configurar las funciones avanzadas.

   Para obtener más información, consulta Acerca de las funciones avanzadas.

Implementa una app de búsqueda

1. En la página Apps, haz clic en el nombre de la app que quieres implementar.

2. En el menú de navegación, haz clic en Integración.

3. Asegúrate de que la pestaña Widget esté seleccionada.

4. Selecciona Basado en JWT o OAuth como el tipo de autorización del widget.

5. En el campo Dominio, ingresa el nombre de dominio de la página web en la que coloca el widget. Por ejemplo, si quieres copiar el widget en la página web example.com/ai.html, ingresa example.com como dominio.

6. Haz clic en Agregar y, luego, en Guardar.

7. Copia el fragmento de código proporcionado en la sección Copia el siguiente código en tu aplicación web.

8. En tu base de código, genera un token de autorización.

9. Para pasar el token de autorización a tu widget, usa el fragmento de código de "Configurar token de autorización" que se proporciona en la sección Copia el siguiente código para tu aplicación web y reemplaza el texto <JWT or OAuth token provided by your backend> por tu token de autorización.

10. Prueba la app implementada. Para ajustar aún más la configuración, sigue los pasos que se indican en "Configura el widget de búsqueda". Asegúrate de hacer clic en Guardar y publicar para que los cambios se apliquen en el widget implementado.

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?

• Introducción a Vertex AI Search
• Acerca de los datos, los almacenes de datos y los motores