Configura un almacén de datos de Jira Cloud

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 Jira Cloud a Gemini Enterprise.

Antes de comenzar

Antes de configurar tu conexión federada de Jira Cloud, asegúrate de 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.

• Para aplicar el control de acceso a la fuente de datos y proteger los datos en Google Gemini Enterprise, configura tu proveedor de identidad.

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

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

• Opcional: Para recuperar las direcciones de correo electrónico de los usuarios de Jira Cloud, incluso cuando la configuración restringe la visibilidad del correo electrónico, instala la app de User Identity Accessor for Jira Cloud con privilegios de administrador del sitio de Jira para instalarla y configurarla para recuperar de forma segura las direcciones de correo electrónico de los usuarios. Es posible que no necesites instalar esta app si las direcciones de correo electrónico ya son de acceso público.

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

Crea un almacén de datos de Jira Cloud

Para crear un almacén de datos de Jira Cloud, 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 Google Cloud .

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

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 Jira Cloud y haz clic en Seleccionar.

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

   1. En la sección Modo del conector, selecciona Transferencia de datos o Búsqueda federada como el 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 elijas.

      1. Proporciona los siguientes detalles de autenticación:

         • Client ID (ID de cliente)
         • Secreto del cliente
         • URI de instancia
         • ID de instancia

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

      2. Si seleccionaste Búsqueda federada, haz clic en Acceder y completa el acceso a Atlassian.

      3. Haz clic en Continuar.

   4. En la sección Destinos, ingresa la URL de tu extremo de Jira Cloud.

   5. Haz clic en Continuar.

   6. En la sección Entidades para buscar (si seleccionaste Búsqueda federada) o Entidades para sincronizar (si seleccionaste Transferencia de datos), haz lo siguiente:

      1. Selecciona todas las entidades requeridas.
      2. Si seleccionaste Búsqueda federada, continúa con el siguiente paso.
      3. Si seleccionaste Transferencia de datos, continúa con los siguientes pasos:
         1. De manera opcional, para sincronizar proyectos específicos, haz lo siguiente:
            1. Haz clic en Filtrar.
            2. Para filtrar entidades del índice, selecciona la casilla de verificación Excluir del índice o, para asegurarte de que se incluyan en él, selecciona la casilla de verificación Incluir en el índice.
            3. Ingresa las claves. Presiona Intro después de cada clave.
            4. Haz clic en Guardar.
         2. Para configurar la programación de sincronización, haz lo siguiente:
            1. En la lista Frecuencia de sincronización, selecciona la frecuencia de sincronización.
               • Para programar sincronizaciones completas independientes de los datos de identidad y de entidad, expande el menú en la sección Sincronización completa y, luego, selecciona Opciones personalizadas.
            2. En la lista Frecuencia de sincronización incremental, selecciona la frecuencia de sincronización incremental. Para obtener más información, consulta Programas de sincronización.

7. Haz clic en Continuar.

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

   1. Si seleccionaste Búsqueda federada, haz lo siguiente:
      1. En Selecciona las acciones de Jira Cloud que deseas habilitar, selecciona las acciones de la categoría para habilitarlas en el conector.

   2. Si seleccionaste Transferencia de datos, haz lo siguiente:

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

      2. Proporciona los siguientes detalles de autenticación:

         • Client ID (ID de cliente)
         • Secreto del 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 Acceder y accede a Jira Cloud para verificar tu cuenta.

      4. Haz clic en Continuar.

      5. En Selecciona las acciones de Jira Cloud que deseas habilitar, selecciona las acciones de la categoría para habilitarlas en el conector.

      Nota: Si omites el proceso de agregar acciones en este paso, deberás crear un nuevo almacén de datos para agregarlas. Para ver la lista de acciones, consulta Ver acciones.

9. 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 del conector de datos, ingresa un nombre para tu conector.
   3. Si seleccionaste US o EU como ubicación, establece 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.

10. Haz clic en Continuar.

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

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 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 Jira Cloud estará listo para usarse.

En el caso de un conector de transferencia creado con Jira Cloud, el estado del almacén de datos pasa de Creando a Ejecutando cuando se inicia la sincronización. Luego, cambia a Activo una vez que se completa la transferencia, lo que indica que el almacén de datos está completamente configurado. Según el volumen de datos, la transferencia puede tardar varias horas.

Después de crear el almacén de datos, crea una app, 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.

Habilita la sincronización en tiempo real para la transferencia de datos

Vista previa — Real-time sync

Esta función está sujeta a las "Condiciones de las Ofertas de la Fase Previa a la DG" de la sección Términos Generales del Servicio de los Términos Específicos 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.

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 documentos que se admiten con la sincronización en tiempo real.

Entidades de Jira	Crear	Actualización	Borrar	Cambios de 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:

Genera 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 Realtime sync.

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 botón de activación Habilitar la sincronización en tiempo real.
   2. Ingresa un valor en el campo Secreto del cliente y cópialo. Necesitarás este valor nuevamente cuando crees un webhook en la consola de administración de Jira.
   3. Haz clic en Guardar.

5. Después de que 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 de webhook.
   2. Haz clic en Cerrar.

Crea un webhook

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

8. En el campo Secreto, ingresa el mismo valor que ingresaste cuando generaste una URL de webhook en Gemini Enterprise.

   Nota: Para verificar la coherencia de los datos y evitar errores cuando configures webhooks en Jira, selecciona solo las entidades que estén habilitadas para la sincronización en tu almacén de datos.

9. En la sección Issue related events, selecciona las siguientes opciones:

   Entidades	Creado	Actualizada	Borrado
   Problema	Sí	Sí	Sí
   Registro de trabajo	Sí	Sí	Sí
   Comentario	Sí	Sí	Sí
   Archivo adjunto	Sí	No	Sí

10. En la sección Project related events, selecciona las casillas de verificación created, updated y deleted para la entidad Project.

11. Haz clic en Crear.

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

• Gemini Enterprise envía tu 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 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 Atlassian).
• 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.
• Una vez 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 exactitud, es posible que un LLM reescriba tu búsqueda antes de que se envíe a Jira Cloud. 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 Atlassian.

¿Qué sigue?

• Para proporcionar una interfaz de usuario para consultar tus datos de Jira Cloud, crea una app y conéctala al almacén de datos de Jira Cloud.
• Para ver la lista de acciones, consulta Ver 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.