Descripción general

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

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 admitidas

Cuando el almacén de datos 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.
Cambia el estado del problema Cambia el estado de un problema existente en Jira Cloud. Debes proporcionar el ID del problema para identificarlo.

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:

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 (p.ej., actualizar campos de problemas) y administre comentarios o problemas.
Solo búsqueda federada read:jira-user, read:jira-work Permite que el asistente busque y vea problemas, proyectos y perfiles de usuario.
Transferencia y acciones de datos read:jira-work Permite que el asistente realice un rastreo e indexación amplios de datos de elementos de trabajo.
write:jira-work Permite que el asistente realice acciones de escritura (creación, actualizaciones, comentarios) en elementos de trabajo dentro del entorno incorporado.
Transferencia 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 búsqueda.
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 agregue archivos adjuntos a los problemas de Jira.
read:issue:jira Permite que el almacén de datos lea 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 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 los tableros, los problemas en un tablero, los problemas de un backlog, los informes y las versiones.
read:issue-details:jira Permite que el almacén de datos lea los detalles del problema.
read:jql:jira Permite que el almacén de datos lea consultas del lenguaje de consultas de Jira (JQL).
Solo búsqueda federada read:issue:jira Permite que el almacén de datos lea 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 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 los tableros, los problemas en un tablero, los problemas de un backlog, los informes y las versiones.
read:issue-details:jira Permite que el almacén de datos lea los detalles del problema.
read:jql:jira Permite que el almacén de datos lea consultas del lenguaje de consultas de Jira (JQL).
Transferencia y acciones de datos read:user:jira, read:group:jira, read:avatar:jira Permite sincronizar los metadatos de usuarios o grupos y mostrar los perfiles de los usuarios.
read:issue-security-level:jira, read:issue-security-scheme:jira Permite el control de acceso, lo que garantiza que los datos ingeridos 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.
Transferencia de datos read:user:jira, read:group:jira, read:avatar:jira Permite rastrear e indexar el contenido de Jira y las relaciones entre usuarios.
read:issue-security-level:jira, read:issue-security-scheme:jira Permite asignar permisos de asignación para que solo los usuarios autorizados puedan buscar los datos ingeridos.
read:audit-log:jira Permite 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 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 y las limitaciones conocidos que pueden afectar tu 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 de global, us y eu.

A continuación, se indican las limitaciones del almacén de datos de Jira Cloud para la transferencia de datos:

  • 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?