Configura un almacén de datos de HubSpot

Versión preliminar pública: Las funciones de búsqueda y acciones federadas están en versión preliminar pública. Esta función está sujeta a las “Condiciones de la Oferta de la Fase Previa a la DG” en la sección de Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta página, se describe cómo crear un almacén de datos y conectar HubSpot a Gemini Enterprise.

Antes de comenzar

Antes de configurar tu conexión de HubSpot, asegúrate de tener lo siguiente:

• Otorga el rol de Editor de Discovery Engine (roles/discoveryengine.editor). Este rol es necesario para que el usuario cree el almacén de datos. Para otorgar este rol, haz lo siguiente:

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

     Ir a IAM

  2. Ubica la cuenta de usuario y haz clic en el ícono de editar Editar.
  3. Otorga el rol Discovery Engine Editor al usuario. Para obtener más información, consulta Roles y permisos de IAM.

• Accede a tu cuenta de HubSpot.

Nota: HubSpot usa una app de OAuth administrada por Google, lo que elimina la necesidad de registrar o administrar tus propias apps de OAuth.

Crea un almacén de datos de HubSpot

Para crear un almacén de datos de HubSpot, sigue estos pasos:

1. En la consola de Google Cloud , ve a la página Gemini Enterprise.

   Gemini Enterprise

2. Selecciona o crea un proyecto de Google Cloud .

3. En el menú de navegación, haz clic en Almacenes de datos.

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

5. En la sección Fuente, busca HubSpot y haz clic en Seleccionar.

6. En la sección Datos, haz lo siguiente:

   Nota: El almacén de datos de HubSpot usa una app de OAuth administrada por Google. Esto elimina la necesidad de configurar y administrar manualmente la app de OAuth, y te permite integrar HubSpot de forma rápida y segura sin tener que controlar las credenciales del cliente.
   1. En la sección Entidades para buscar, selecciona todas las entidades requeridas. Nota: Se debe seleccionar al menos una entidad.

7. Haz clic en Continuar.

8. En la sección Configuración, haz lo siguiente:

   1. En la lista Multirregional, selecciona la ubicación de tu conector de datos.
   2. En el campo Nombre de tu conector de datos, ingresa un nombre para tu conector.
   3. Si seleccionaste us o eu como ubicación, configura los parámetros de configuración de encriptación:
      • Opcional: Si no configuraste claves de una sola región, haz clic en Ir a la página de configuración para hacerlo. Para obtener más información, consulta Cómo registrar una clave de una sola región para conectores de terceros.
      • Selecciona Clave de encriptación administrada porGoogle o Clave de Cloud KMS.
      • Si seleccionaste Clave de Cloud KMS, haz lo siguiente:
        • En la lista Tipo de administración de claves, selecciona el tipo adecuado.
        • En la lista Clave de Cloud KMS, selecciona la clave.
      Para obtener más información, consulta Claves de encriptación administradas por el cliente.

9. Haz clic en Continuar.

10. En la sección Facturación, selecciona Precios generales o Precios configurables. Para obtener más información, consulta Verifica el estado de facturación de tus proyectos y Licencias.

11. Haz clic en Crear. Gemini Enterprise crea tu almacén de datos y lo muestra en la página Almacenes de datos.

En la página Almacenes de datos, haz clic en el nombre del almacén de datos para ver el estado. Después de que el estado del almacén de datos cambie de Creando a Activo, el conector de HubSpot estará listo para usarse.

Después de crear el almacén de datos, conéctalo a una app existente o crea una app nueva y conéctala a la app nueva, y autoriza a Gemini Enterprise para que acceda a HubSpot antes de ejecutar cualquier consulta. Para obtener más información, consulta Próximos pasos.

Nota: El administrador de HubSpot debe autorizar el conector desde la IU de Gemini Enterprise antes de que autorices tu cuenta individual.

Control de datos y ejecución de consultas

En esta sección, se describe cómo Gemini Enterprise administra tu búsqueda y las implicaciones de privacidad del uso del almacén de datos federado.

Ejecución de las consultas

Después de autorizar HubSpot y enviar una búsqueda a Gemini Enterprise, ocurrirá lo siguiente:

• Gemini Enterprise envía tu búsqueda directamente a la API de HubSpot.
• Gemini Enterprise combina los resultados con los de otras fuentes de datos conectadas y muestra un resultado de búsqueda integral.

Manejo de datos

Cuando se usa la búsqueda federada de terceros, se aplican las siguientes reglas de tratamiento de datos:

• Tu cadena de consulta se envía al backend de búsqueda de terceros (API de HubSpot).
• Estos terceros pueden asociar las búsquedas con tu identidad.
• Si hay varias fuentes de datos de búsqueda federada habilitadas, es posible que la consulta se envíe a todas ellas.
• Después de que los datos llegan al sistema de terceros, se rigen por las condiciones del servicio y las políticas de privacidad de ese sistema.

Nota: Para mejorar la precisión, es posible que un LLM reescriba tu búsqueda antes de que se envíe a HubSpot. Esta consulta reescrita puede incorporar información del historial de consultas de tu sesión. Como resultado, es posible que partes de tu historial de consultas también se incluyan en la consulta que se envía a la API de HubSpot.

¿Qué sigue?

• Para proporcionar una interfaz de usuario para consultar tus datos de HubSpot, crea una app y conéctala al almacén de datos de HubSpot.

• Para ver y administrar la lista de acciones, consulta Administra acciones.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar tu app, consulta Cómo obtener resultados de la búsqueda.

• Para habilitar las alertas del almacén de datos, consulta Configura alertas para almacenes de datos de terceros.