Configurar un almacén de datos de Jira Cloud

Vista Previa Pública: las funciones de búsqueda y acciones federadas están en Vista Previa Pública. Esta función está sujeta a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Las funciones previas a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

En esta página se describe cómo crear un almacén de datos y conectar Jira Cloud con Gemini Enterprise.

Antes de empezar

Antes de configurar tu conexión federada de Jira Cloud, asegúrate de que se cumplen los siguientes requisitos:

• Asigna el rol de editor de Discovery Engine (roles/discoveryengine.editor). Este rol es obligatorio para que el usuario pueda crear el almacén de datos. Para asignar este rol, sigue estos pasos:

  1. En la consola, ve a la página Gestión de identidades y accesos. Google Cloud

     Ir a IAM

  2. Busca la cuenta de usuario y haz clic en el icono de editar Editar.
  3. Asigna el rol Discovery Engine Editor al usuario. Para obtener más información, consulta Roles y permisos de gestión de identidades y accesos.

• Para aplicar el control de acceso a las fuentes de datos y proteger los datos en Google Gemini Enterprise, configura tu proveedor de identidades.

• Para configurar el conector de Jira Cloud, debes usar el nuevo modelo de gestión de usuarios centralizado de Atlassian. Si usas el modelo original, debes migrar tu gestión de usuarios antes de continuar. Para obtener más información, consulta el artículo Función de administrador del sitio.

• Crea una aplicación OAuth 2.0, obtén el ID de cliente y el secreto y configura los permisos mínimos de la aplicación con el consentimiento de un administrador de Jira Cloud. Verifica que tienes acceso de administrador de la organización de Jira a la instancia y al proyecto de Jira. Con el acceso de administrador de la organización, puedes configurar permisos mínimos y proporcionar privilegios de acceso a grupos de usuarios.

• Opcional: Para obtener las direcciones de correo de los usuarios de Jira Cloud, incluso cuando los ajustes restringen la visibilidad del correo, instala la aplicación User Identity Accessor for Jira Cloud con privilegios de administrador del sitio de Jira para instalar y configurar la aplicación para obtener las direcciones de correo de los usuarios de forma segura. Puede que no tengas que instalar esta aplicación si las direcciones de correo ya son de acceso público.

  Nota: Atlassian está actualizando los elementos de la interfaz de usuario y se va a cambiar el nombre de algunos de los que se mencionan en esta documentación (por ejemplo, Productos pasará a llamarse Aplicaciones). Para obtener más información, consulta el artículo Cambio de la terminología de la administración de Atlassian de "productos" a "aplicaciones".

Crear un almacén de datos de Jira Cloud

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

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

   Gemini Enterprise

2. Selecciona o crea un Google Cloud proyecto.

   Nota: Para acceder al flujo unificado, tu proyecto debe estar en la lista de permitidos.

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

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

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

6. En la sección Datos:

   1. En la sección Modo de conector, selecciona Ingestión de datos o Búsqueda federada como modo de conexión.

   2. Haz clic en Continuar.

   3. En la sección Configuración de autenticación, configura la autenticación según el modo de conexión que hayas elegido.

      1. Proporciona los siguientes detalles de autenticación:

         • ID de cliente
         • Secreto de cliente
         • URI de instancia
         • ID de instancia

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

      2. Si has seleccionado Búsqueda federada, haz clic en Iniciar sesión y completa el inicio de sesión de Atlassian.

      3. Haz clic en Continuar.

   4. En la sección Destinations (Destinos), introduce la URL de tu endpoint de Jira Cloud.

   5. Haz clic en Continuar.

   6. En la sección Entidades que buscar (si ha seleccionado Búsqueda federada) o Entidades que sincronizar (si ha seleccionado Ingestión de datos):

      1. Selecciona todas las entidades necesarias.
      2. Si has seleccionado Búsqueda federada, ve al siguiente paso.
      3. Si ha seleccionado Ingestión de datos, siga estos pasos:
         1. Opcional: Para sincronizar proyectos específicos, haz lo siguiente:
            1. Haz clic en Filtrar.
            2. Para excluir entidades del índice, selecciona la casilla Excluir del índice. Para incluirlas, selecciona la casilla Incluir en el índice.
            3. Introduce las llaves. Pulsa Intro después de cada tecla.
            4. Haz clic en Guardar.
         2. Para configurar la programación de sincronización, sigue estos pasos:
            1. En la lista Frecuencia de sincronización, seleccione la frecuencia de sincronización.
               • Para programar sincronizaciones completas independientes de los datos de entidad y de identidad, despliega el menú de la sección Sincronización completa y selecciona Opciones personalizadas.
            2. En la lista Frecuencia de sincronización incremental, seleccione la frecuencia de sincronización incremental. Para obtener más información, consulta Programaciones de sincronización.

7. Haz clic en Continuar.

8. En la sección Acciones:

   1. Si has seleccionado Búsqueda federada:
      1. En Seleccionar acciones de Jira Cloud para habilitar, elija las acciones de la categoría para habilitarlas en el conector.

   2. Si has seleccionado Ingestión de datos:

      1. En la sección Configuración de autenticación, configura la autenticación según el modo de conexión que hayas elegido.

      2. Proporciona los siguientes detalles de autenticación:

         • ID de cliente
         • Secreto de cliente
         • URI de instancia
         • ID de instancia

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

      3. Haz clic en Iniciar sesión e inicia sesión en Jira Cloud para verificar tu cuenta.

      4. Haz clic en Continuar.

      5. En Seleccionar acciones de Jira Cloud para habilitar, elija las acciones de la categoría para habilitarlas en el conector.

      Nota: Si no añades ninguna acción en este paso, tendrás que crear un nuevo almacén de datos para añadir acciones. Para ver la lista de acciones, consulta Ver acciones.

9. En la sección Configuración:

   1. En la lista Multirregión, selecciona la ubicación del conector de datos.
   2. En el campo Nombre del conector de datos, escriba un nombre para el conector.
   3. Si has seleccionado US o EU como ubicación, configura los ajustes de cifrado:
      • Opcional: Si no ha configurado claves de una sola región, haga clic en Ir a la página de configuración para hacerlo. Para obtener más información, consulte Registrar una clave de una sola región para conectores de terceros.
      • Selecciona Clave de cifrado gestionada porGoogle o Clave de Cloud KMS.
      • Si has seleccionado Clave de Cloud KMS:
        • En la lista Tipo de gestió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 cifrado gestionadas por el cliente.

10. Haz clic en Continuar.

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

12. 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 Data Stores (Almacenes de datos), haz clic en el nombre del almacén de datos para ver el estado. Cuando el estado del almacén de datos cambie de Creando a Activo, el conector de Jira Cloud estará listo para usarse.

En el caso de un conector de ingestión creado con Jira Cloud, el estado del almacén de datos pasa de Creating (Creando) a Running (En ejecución) cuando se inicia la sincronización. Después, cambia a Activo cuando se completa la ingestión, lo que indica que el almacén de datos está totalmente configurado. En función del volumen de datos, la ingestión puede tardar varias horas.

Después de crear el almacén de datos, crea una aplicación, conéctala al almacén de datos de Jira Cloud y autoriza a Gemini Enterprise para que acceda a Jira Cloud antes de ejecutar cualquier consulta.

Habilitar la sincronización en tiempo real para la ingestión de datos

Vista previa — Real-time sync

Esta función está sujeta a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Las funciones previas a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

La sincronización en tiempo real solo sincroniza las entidades de documentos y no sincroniza los datos relacionados con las entidades de identidad. En la siguiente tabla se muestran los eventos de documento que se admiten con la sincronización en tiempo real.

Entidades de Jira	Crear	Actualizar	Eliminar	Cambios en los permisos
Problemas
Registros de trabajo
Proyectos
Comentarios
Archivos adjuntos

Para habilitar la sincronización en tiempo real de un conector de fuente de datos de Jira Cloud, sigue estos pasos:

Generar una URL de webhook

1. Ve a la página de Gemini Enterprise y, en el menú de navegación, haz clic en Almacenes de datos.
2. Selecciona un almacén de datos de Jira Cloud.

3. Haz clic en Ver o editar en la fila Sincronización en tiempo real.

4. En el cuadro de diálogo Ver y editar parámetros de sincronización en tiempo real, haz lo siguiente:

   1. Para activar la sincronización en tiempo real, haz clic en el interruptor Habilitar sincronización en tiempo real.
   2. Introduce un valor en el campo Secreto de cliente y cópialo. Necesitarás este valor de nuevo cuando crees un webhook en la consola de administración de Jira.
   3. Haz clic en Guardar.

5. Cuando el estado de Sincronización en tiempo real cambie a Running, haz clic en Ver o editar.

6. En el cuadro de diálogo Ver y editar parámetros de sincronización en tiempo real, haz lo siguiente:

   1. Copia la URL del webhook.
   2. Haz clic en Cerrar.

Crear un webhook

1. Inicia sesión en la consola de administración de Jira.
2. Haz clic en Configuración y selecciona Sistema.
3. En el panel Ajustes del sistema, selecciona Webhooks.
4. Haz clic en Crear un webhook. Para obtener información sobre los webhooks, consulta Webhooks.
5. Introduce un nombre para el webhook.
6. Selecciona el Estado como Enabled.
7. En el campo URL, pega la URL copiada de Gemini Enterprise y añade /{issue.id}.

8. En el campo Secreto, introduce el mismo valor que has introducido al generar una URL de webhook en Gemini Enterprise.

   Nota: Para verificar la coherencia de los datos y evitar errores al configurar webhooks en Jira, solo debe seleccionar las entidades que estén habilitadas para la sincronización en su almacén de datos.

9. En la sección Eventos relacionados con el problema, selecciona las siguientes opciones:

   Entidades	Creado	Actualizado	Eliminado
   Problema	Sí	Sí	Sí
   Registro de trabajo	Sí	Sí	Sí
   Comentario	Sí	Sí	Sí
   Archivo adjunto	Sí	No	Sí

10. En la sección Eventos relacionados con el proyecto, marca las casillas created, updated y deleted de la entidad Project.

11. Haz clic en Crear.

Gestión de datos y ejecución de consultas

En esta sección se describe cómo gestiona Gemini Enterprise tu consulta y las implicaciones para la privacidad del uso del almacén de datos federado.

Ejecución de consultas

Después de autorizar Jira Cloud y enviar una consulta de búsqueda a Gemini Enterprise:

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

Tratamiento de datos

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

• La cadena de consulta se envía al backend de búsqueda de terceros (API de Atlassian).
• Estos terceros pueden asociar las consultas con tu identidad.
• Si hay varias fuentes de datos de búsqueda federada habilitadas, la consulta se puede enviar a todas ellas.
• Una vez que los datos llegan al sistema de terceros, se rigen por los términos del servicio y las políticas de privacidad de ese sistema.

Nota: Para mejorar la precisión, es posible que un LLM vuelva a escribir tu consulta antes de enviarla a Jira Cloud. Esta consulta reescrita puede incorporar información del historial de consultas de tu sesión. Por lo tanto, es posible que algunas partes de tu historial de consultas también se incluyan en la consulta enviada a la API de Atlassian.

Siguientes pasos

• Para proporcionar una interfaz de usuario para consultar los datos de Jira Cloud, crea una aplicación y conéctala al almacén de datos de Jira Cloud.
• Para ver la lista de acciones, consulta Ver acciones.
• Para ver cómo aparecen los resultados de búsqueda después de configurar tu aplicación, consulta Obtener resultados de búsqueda.
• Para habilitar las alertas del almacén de datos, consulta Configurar alertas para almacenes de datos de terceros.