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 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 compatibles
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. |
| Subir un archivo adjunto | Sube un archivo adjunto a un problema de Jira especificado. |
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 (por ejemplo, actualizar campos de problemas), administrar comentarios o problemas y subir archivos adjuntos. | |
| Solo búsqueda federada | read:jira-user, read:jira-work |
Permite que el asistente busque y vea problemas, proyectos y perfiles de usuario. |
| Transferencia de datos y acciones | read:jira-work |
Permite que el asistente realice un rastreo de datos amplio y la indexación de elementos de trabajo. |
write:jira-work |
Permite que el asistente realice acciones de escritura (creación, actualizaciones, comentarios y archivos adjuntos) en elementos de trabajo dentro del entorno transferido. | |
| Transferencia de datos | read:jira-work |
Permite que el asistente rastree e indexe contenido de Jira para la disponibilidad de 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 suba archivos adjuntos a 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 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 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 metadatos de 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 un backlog, informes y versiones. | |
read:issue-details:jira |
Permite que el almacén de datos lea detalles de 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 problemas. |
read:issue-type:jira |
Permite que el almacén de datos lea 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 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 metadatos de 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 un backlog, informes y versiones. | |
read:issue-details:jira |
Permite que el almacén de datos lea detalles de problemas. | |
read:jql:jira |
Permite que el almacén de datos lea consultas de Jira Query Language (JQL). | |
| Transferencia de datos y acciones | read:user:jira, read:group:jira, read:avatar:jira |
Permite sincronizar metadatos de usuarios o grupos y mostrar 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. | |
| Transferencia de datos | read:user:jira, read:group:jira, read:avatar:jira |
Permite rastrear e indexar contenido de Jira y relaciones de 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. |
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 del almacén de datos de Jira Cloud.
Limitaciones
En esta sección, se describen los problemas y las limitaciones conocidos 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 de Jira Cloud existentes. 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 las 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
global,us, yeuubicaciones.
Las siguientes 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 projecto 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?
- Para crear y configurar un almacén de datos con Jira Cloud, consulta Configura un almacén de datos de Jira Cloud.