Descripción general

El conector de Jira Cloud para Gemini Enterprise proporciona acceso a tus datos de Jira Cloud, lo que te permite interactuar con tus proyectos, problemas y la información del usuario.

Versiones compatibles de Jira Cloud

El conector de Jira Cloud admite la versión 2 de la API de 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 nuevo en un problema de Jira especificado para agregar comentarios, actualizaciones o notas.
Actualizar comentario Edita el texto de un comentario existente.
Crea problemas Crea un problema nuevo en un proyecto de Jira Cloud. Para crear uno, debes proporcionar un resumen, el ID del proyecto y el ID del tipo de problema.
Problema con la actualización Actualiza un problema existente en Jira Cloud. Debes proporcionar el ID del problema para identificarlo y puedes modificar varios campos, como el resumen, la descripción y el asignatario.

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

Permisos obligatorios

Para permitir que Gemini Enterprise realice búsquedas y acciones con el almacén de datos de Jira Cloud, necesitas los siguientes permisos:

Modo de conexión Alcance Objetivo
Búsqueda y acciones federadas read:jira-user, read:jira-work Se requiere para recuperar y mostrar los resultados de la búsqueda y los detalles del usuario en tiempo real.
write:jira-work Permite que el asistente modifique elementos de trabajo (p.ej., actualizar campos de problemas).
write:comment:jira Permite que el asistente publique comentarios o respuestas nuevos directamente desde la interfaz de búsqueda.
write:issue:jira Es necesario para crear problemas nuevos o realizar ediciones importantes en los existentes.
Solo búsqueda federada read:jira-user, read:jira-work Se requiere para buscar y ver problemas, proyectos y perfiles de usuario.
Transferencia y acciones de datos read:jira-work, read:user:jira, read:group:jira, read:avatar:jira Se requiere para la sincronización de metadatos de usuarios o grupos y la transferencia de datos a gran escala.
read:issue-security-level:jira, read:issue-security-scheme:jira Es fundamental para el control de acceso y garantiza que los datos transferidos respeten los límites de seguridad de Jira.
read:audit-log:jira Se usa para hacer un seguimiento de los cambios y realizar sincronizaciones incrementales para mantener actualizados los datos ingeridos.
write:jira-work Es necesario para realizar acciones de escritura en elementos de trabajo dentro del entorno transferido.
write:comment:jira Se requiere para agregar comentarios a los problemas con el asistente.
write:issue:jira Permite crear o modificar problemas.
Transferencia 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 entre usuarios.
read:issue-security-level:jira, read:issue-security-scheme:jira Se requiere para asignar permisos, de modo que solo los usuarios autorizados puedan buscar los datos ingeridos.
read:audit-log:jira Es necesario para que el motor de sincronización identifique qué elementos se actualizaron o borraron.

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

Límites de frecuencia para la transferencia de datos

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

Limitaciones

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

  • No se admite la aplicación de un perímetro de Controles del servicio de VPC en los almacenes de datos existentes de Jira Cloud. Para aplicar los Controles del servicio de VPC, debes borrar y volver a crear los almacenes de datos. Para obtener más información sobre los Controles del servicio de VPC y cómo usar acciones después de habilitarlos, consulta Protege tu app con los Controles del servicio de VPC.

  • El almacén de datos de Jira Cloud solo se admite en las ubicaciones globales, de EE.UU. y de la UE.

  • Cuando crees una aplicación nueva o agregues un almacén de datos a una aplicación existente, te recomendamos que agregues 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.

A continuación, se indican las limitaciones del conector de transferencia de datos de Jira Cloud:

  • En el caso de los datos no estructurados, cada tipo de medio tiene restricciones diferentes. Para obtener más información, consulta Prepara los datos para las fuentes de datos personalizadas.

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

  • No se pueden otorgar permisos de Browse project o de nivel de seguridad a los roles de aplicación con roles específicos no vacíos.

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

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

  • Jira Cloud no indexa los archivos adjuntos en formato PDF que superan las 2,000 páginas.

  • Los archivos adjuntos que se agregan a los comentarios privados no heredan las restricciones de acceso (ACL) de los comentarios.

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

  • No se pueden transferir las tablas de sprints.

  • El modelo heredado de administración de usuarios no es compatible con la integración en Jira Cloud. Solo se admite el modelo de administración de usuarios centralizado. Para obtener más información, consulta la guía de consolidación de organizaciones de Atlassian.

  • Cuando consultas 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 separadas. No se admite la búsqueda basada en el contenido de un adjunto para encontrar el problema principal.

¿Qué sigue?