Descripción general

El almacén de datos de Jira Cloud para Gemini Enterprise te permite buscar y realizar acciones en tus proyectos, problemas y la información de los usuarios.

Versiones compatibles de Jira Cloud

El almacén de datos de Jira Cloud admite la versión 2 de la API de REST de Jira Cloud.

Acciones compatibles

Cuando el almacén de datos de Jira Cloud está habilitado, los usuarios finales pueden usar comandos de 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.
Actualiza el 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.
Actualizar problema 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 destinatario.
Cambia el estado del problema Cambia el estado de un problema existente en Jira Cloud. Debes proporcionar el ID del problema para identificarlo.
Subir archivo adjunto Sube un archivo adjunto a un problema de Jira especificado.
Asignar problema Asigna un problema existente de Jira a un usuario específico.
Problemas con los vínculos Crea un vínculo entre dos problemas de Jira (por ejemplo, bloquea, está bloqueado por, se relaciona con).
Crear proyecto Crea un nuevo proyecto de Jira con un nombre, una clave, un tipo de proyecto y una plantilla especificados.
Actualizar proyecto Actualiza la configuración de un proyecto de Jira existente, como el nombre, la clave, la descripción o el responsable.
Crear registro de trabajo Agrega una entrada de registro de trabajo de seguimiento de tiempo a un problema de Jira.
Actualizar el registro de trabajo Actualiza una entrada de registro de trabajo existente en un problema de Jira.
Obtener tablero Obtiene un tablero en Jira.
Obtener problemas para el tablero Obtiene problemas de un tablero en Jira.
Enumera los tableros Enumera los tableros de Jira.

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:

Permisos clásicos

Modo de conexión Permiso Objetivo
Búsqueda y acciones federadas read:jira-user, read:jira-work Permite que el asistente recupere y muestre resultados de la búsqueda y detalles del usuario en tiempo real.
write:jira-work Permite que el asistente modifique elementos de trabajo (por ejemplo, actualizar campos de problemas), administre comentarios o problemas, y suba archivos adjuntos.
manage:jira-project Permite que el asistente administre la configuración de proyectos de Jira y cree objetos nuevos a nivel del proyecto, como versiones y componentes. Es obligatorio para las acciones de creación y actualización de proyectos.
Solo búsqueda federada read:jira-user, read:jira-work Permite que el asistente busque y vea problemas, proyectos y perfiles de usuario.
Ingesta de datos y acciones read:jira-work Permite que el asistente realice un rastreo y una indexación de datos amplios de los elementos de trabajo.
write:jira-work Permite que el asistente realice acciones de escritura (creación, actualizaciones, comentarios y archivos adjuntos) en los elementos de trabajo dentro del entorno transferido.
Ingesta de datos read:jira-work Permite que el asistente rastree e indexe el contenido de Jira para que esté disponible en la búsqueda.

Permisos detallados

Modo de conexión Permiso Objetivo
Búsqueda y acciones federadas write:comment:jira Permite que el almacén de datos publique comentarios o respuestas nuevos directamente desde la interfaz de Gemini Enterprise.
write:issue:jira Permite que el almacén de datos cree problemas nuevos o realice ediciones importantes en los existentes.
write:attachment:jira Permite que el almacén de datos suba archivos adjuntos a los problemas de Jira.
write:project:jira Permite que el almacén de datos cree y actualice proyectos de Jira.
write:issue-worklog:jira Permite que el almacén de datos cree y actualice registros de trabajo de problemas.
write:issue-link:jira Permite que el almacén de datos cree y actualice vínculos entre problemas.
read:issue:jira Permite que el almacén de datos lea los problemas.
read:issue-type:jira Permite que el almacén de datos lea los tipos de problemas.
read:comment:jira Permite que el almacén de datos lea los comentarios.
read:comment.property:jira Permite que el almacén de datos lea las propiedades de los comentarios de los problemas.
read:project:jira Permite que el almacén de datos lea proyectos.
read:priority:jira Permite que el almacén de datos lea las prioridades.
read:issue.transition:jira Permite que el almacén de datos lea las transiciones de problemas.
read:issue-meta:jira Permite que el almacén de datos lea los metadatos de los problemas.
read:board-scope.admin:jira-software Permite que el almacén de datos lea la configuración, las funciones del proyecto, los filtros, las propiedades y los filtros rápidos de un tablero.
read:board-scope:jira-software Permite que el almacén de datos lea tableros, problemas en un tablero, problemas de una lista de tareas pendientes, informes y versiones.
read:issue-details:jira Permite que el almacén de datos lea los detalles de los problemas.
read:jql:jira Permite que el almacén de datos lea consultas de Jira Query Language (JQL).
Solo búsqueda federada read:issue:jira Permite que el almacén de datos lea los problemas.
read:issue-type:jira Permite que el almacén de datos lea los tipos de problemas.
read:comment:jira Permite que el almacén de datos lea los comentarios.
read:comment.property:jira Permite que el almacén de datos lea las propiedades de los comentarios de los problemas.
read:project:jira Permite que el almacén de datos lea proyectos.
read:priority:jira Permite que el almacén de datos lea las prioridades.
read:issue.transition:jira Permite que el almacén de datos lea las transiciones de problemas.
read:issue-meta:jira Permite que el almacén de datos lea los metadatos de los problemas.
read:board-scope.admin:jira-software Permite que el almacén de datos lea la configuración, las funciones del proyecto, los filtros, las propiedades y los filtros rápidos de un tablero.
read:board-scope:jira-software Permite que el almacén de datos lea tableros, problemas en un tablero, problemas de una lista de tareas pendientes, informes y versiones.
read:sprint:jira-software Permite que el almacén de datos lea los detalles de los sprints.
read:issue-details:jira Permite que el almacén de datos lea los detalles de los problemas.
read:jql:jira Permite que el almacén de datos lea consultas de Jira Query Language (JQL).
Ingesta de datos y acciones read:user:jira, read:group:jira, read:avatar:jira Permite sincronizar los metadatos de usuarios y grupos, y mostrar los perfiles de usuario.
read:issue-security-level:jira, read:issue-security-scheme:jira Permite el control de acceso, lo que garantiza que los datos transferidos respeten los límites de seguridad de Jira.
read:audit-log:jira Permite hacer un seguimiento de los cambios y realizar sincronizaciones incrementales para mantener actualizados los datos transferidos.
write:comment:jira Permite agregar comentarios a los problemas con el almacén de datos.
write:issue:jira Permite que el asistente cree o modifique problemas.
Ingesta de datos read:user:jira, read:group:jira, read:avatar:jira Permite rastrear e indexar el contenido de Jira y las relaciones de los usuarios.
read:issue-security-level:jira, read:issue-security-scheme:jira Permite asignar permisos para que solo los usuarios autorizados puedan buscar los datos transferidos.
read:audit-log:jira Permite que el motor de sincronización identifique qué elementos se actualizaron o borraron.
read:sprint:jira-software Permite que el almacén de datos lea los detalles de los sprints.

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 almacén de datos 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 desde el almacén de datos de Jira Cloud.

Limitaciones

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

  • Cuando crees una app nueva o agregues un almacén de datos a una existente, te recomendamos que asocies solo un almacén de datos con acciones que pertenezcan a un solo tipo de conector.
  • 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 global, us y eu.

Estas son las limitaciones del almacén de datos de transferencia 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 archivo adjunto para encontrar el problema superior.

¿Qué sigue?