Configura un almacén de datos de GitHub

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

Antes de comenzar

Antes de configurar tu conexión de GitHub, 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 GitHub y obtén credenciales de autenticación.

  • Crea una app de GitHub para usar este conector. Para obtener más información, consulta Cómo crear apps de GitHub.

Crea un almacén de datos de GitHub

Para crear un almacén de datos de GitHub, 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 GitHub y haz clic en Seleccionar.

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

    1. En la sección Configuración de autenticación, ingresa los siguientes detalles:

      • ID de cliente: Es el ID de cliente de OAuth de tu aplicación.
      • Secreto del cliente: Es el secreto del cliente de OAuth para tu aplicación.

      Para obtener más información sobre las credenciales, consulta Configuración de GitHub.

    2. Haz clic en Acceder y completa el acceso y la autorización de GitHub.

    3. En la sección Opciones avanzadas, ingresa el nombre de la organización en el campo Acceso del propietario.

    4. Haz clic en Continuar.

    5. En la sección Entidades para buscar, selecciona todas las entidades requeridas.

  7. Haz clic en Continuar.

  8. En la sección Acciones, en Selecciona las acciones de GitHub que deseas habilitar, elige las acciones de la categoría para habilitarlas en el almacén de datos.

    Para administrar la lista de acciones, consulta Administra acciones.

  9. Haz clic en Continuar.

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

  11. Haz clic en Continuar.

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

  13. 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 GitHub estará listo para usarse.

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 GitHub y enviar una búsqueda a Gemini Enterprise, ocurrirá lo siguiente:

  • Gemini Enterprise envía tu búsqueda directamente a la API de GitHub.
  • 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 GitHub).
  • 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.

¿Qué sigue?