Introducción

El conector de Jira Cloud para Gemini Enterprise te permite acceder a tus datos de Jira Cloud para interactuar con tus proyectos, incidencias e información de usuario.

Versiones compatibles de Jira Cloud

El conector de Jira Cloud es compatible con la versión 2 de la API REST de Jira Cloud.

Acciones admitidas

Cuando el conector de Jira Cloud está habilitado, los usuarios finales pueden usar comandos en lenguaje natural en Gemini Enterprise para realizar las siguientes acciones.

Acción Descripción
Crear comentario Crea un comentario en una incidencia de Jira especificada para añadir comentarios, novedades o notas.
Actualizar comentario Edita el texto de un comentario.
Crear incidencia Crea una incidencia en un proyecto de Jira Cloud. Para crear uno, debes proporcionar un resumen, el ID del proyecto y el ID del tipo de incidencia.
Problema con la actualización Actualiza una incidencia de Jira Cloud. Debe proporcionar el ID del problema para identificarlo y puede modificar varios campos, como el resumen, la descripción y el usuario asignado.

Además de estas, hay otras acciones de solo lectura disponibles.

Permisos obligatorios

Para habilitar Gemini Enterprise para que realice búsquedas y acciones usando el almacén de datos de Jira Cloud, necesitas los siguientes ámbitos:

Modo de conexión Ámbito Finalidad
Búsquedas y acciones federadas read:jira-user, read:jira-work Se requiere para obtener y mostrar resultados de búsqueda y detalles de usuario en tiempo real.
write:jira-work Permite al asistente modificar elementos de trabajo (por ejemplo, actualizar campos de problemas).
write:comment:jira Permite que el asistente publique comentarios o respuestas directamente desde la interfaz de búsqueda.
write:issue:jira Necesario para crear problemas o hacer cambios importantes en los que ya hay.
Solo búsqueda federada read:jira-user, read:jira-work Se requiere para buscar y ver incidencias, proyectos y perfiles de usuario.
Ingestión y acciones de datos read:jira-work, read:user:jira, read:group:jira, read:avatar:jira Es necesario para la ingestión de datos a gran escala y la sincronización de metadatos de usuarios o grupos.
read:issue-security-level:jira, read:issue-security-scheme:jira Es fundamental para el control de acceso, ya que asegura que los datos insertados respeten los límites de seguridad de Jira.
read:audit-log:jira Se usa para monitorizar los cambios y realizar sincronizaciones incrementales para mantener actualizados los datos insertados.
write:jira-work Necesaria para realizar acciones de escritura en elementos de trabajo dentro del entorno ingerido.
write:comment:jira Se requiere para añadir comentarios a los problemas mediante el asistente.
write:issue:jira Permite crear o modificar incidencias.
Ingestión de datos read:jira-work, read:user:jira, read:group:jira, read:avatar:jira Se requiere para rastrear e indexar el contenido de Jira y las relaciones de los usuarios.
read:issue-security-level:jira, read:issue-security-scheme:jira Obligatoria para asignar permisos de forma que solo los usuarios autorizados puedan buscar los datos insertados.
read:audit-log:jira Es necesario para que el motor de sincronización identifique qué elementos se han actualizado o eliminado.

Para obtener información sobre cómo configurar estos permisos, consulta Configurar el permiso mínimo de la aplicación.

Límites de frecuencia de la ingesta de datos

El conector de Jira Cloud admite un límite de frecuencia predeterminado de 12 consultas por segundo (CPS) para la ingesta de datos. Estos límites de frecuencia se aplican exclusivamente a la ingesta de datos del conector de Jira Cloud.

Limitaciones

En esta sección se describen los problemas y las limitaciones conocidos que pueden afectar al uso del conector de Jira Cloud.

  • No se puede aplicar un perímetro de Controles de Servicio de VPC a los almacenes de datos de Jira Cloud. Para aplicar Controles de Servicio de VPC, debes eliminar y volver a crear los almacenes de datos. Para obtener más información sobre Controles de Servicio de VPC y cómo usar las acciones después de habilitar Controles de Servicio de VPC, consulta el artículo Protege tu aplicación con Controles de Servicio de VPC.

  • El almacén de datos de Jira Cloud solo está disponible en las ubicaciones Global, EE. UU. y UE.

  • Cuando crees una aplicación o añadas un almacén de datos a una aplicación que ya tengas, te recomendamos que añadas un almacén de datos con acciones que pertenezcan a un solo tipo de conector. Por ejemplo, no asocies dos almacenes de datos de Jira Cloud con acciones habilitadas a la misma aplicación.

Estas son las limitaciones del conector de ingestión de Jira Cloud:

  • En el caso de los datos no estructurados, cada tipo de contenido multimedia tiene restricciones diferentes. Para obtener más información, consulta el artículo Preparar datos para fuentes de datos personalizadas.

  • En el caso de los datos estructurados, el tamaño de cada documento no debe superar los 500 KB.

  • No se pueden conceder permisos de Browse project ni de nivel de seguridad a los roles de aplicación que tengan roles específicos y no vacíos.

  • No se admiten los permisos de documentos determinados por campos personalizados de usuario o de grupo.

  • Jira Cloud no permite ninguna restricción en los niveles de registro de trabajo.

  • Jira Cloud no indexa los archivos PDF adjuntos que superen las 2000 páginas.

  • Los archivos adjuntos añadidos a comentarios privados no heredan las restricciones de acceso (ACLs) de los comentarios.

  • Solo se obtienen los 20 comentarios anteriores de un problema en Jira Cloud.

  • No se pueden ingerir tablas de sprints.

  • El modelo de gestión de usuarios antiguo no se admite para la integración con Jira Cloud. Solo se admite el modelo de gestión de usuarios centralizada. Para obtener más información, consulta la guía de consolidación de organizaciones de Atlassian.

  • Cuando se consulta una entidad de Jira (por ejemplo, un problema), no se incluyen automáticamente los datos relacionados, como los comentarios y los archivos adjuntos. Esto se debe a que se almacenan y se indexan como entidades independientes. No se puede buscar el problema principal en función del contenido de un archivo adjunto.

Siguientes pasos