Aperçu

Le data store Jira Cloud pour Gemini Enterprise vous permet de rechercher et d'effectuer des actions sur vos projets, vos problèmes et vos informations utilisateur.

Versions Jira Cloud compatibles

Le data store Jira Cloud est compatible avec la version 2 de l'API REST Jira Cloud.

Action compatible

Lorsque le data store Jira Cloud est activé, les utilisateurs finaux peuvent utiliser des commandes en langage naturel dans Gemini Enterprise pour effectuer les actions suivantes.

Action Description
Créer un commentaire Crée un commentaire sur un problème Jira spécifié pour ajouter des commentaires, des mises à jour ou des notes.
Modifier ce commentaire Modifie le texte d'un commentaire existant.
Créer un problème Crée un problème dans un projet Jira Cloud. Pour en créer un, vous devez fournir un résumé, l'ID du projet et l'ID du type de problème.
Mettre à jour le problème Met à jour un problème existant dans Jira Cloud. Vous devez fournir l'ID du problème pour l'identifier. Vous pouvez modifier différents champs tels que le résumé, la description et l'assignataire.
Modifier l'état du problème Modifie l'état d'un problème existant dans Jira Cloud. Vous devez fournir l'ID du problème pour l'identifier.
Importer une pièce jointe Importe une pièce jointe dans un problème Jira spécifié.
Attribuer un problème Attribue un problème Jira existant à un utilisateur spécifié.
Associer des problèmes Crée un lien entre deux problèmes Jira (par exemple, "Bloque", "Est bloqué par", "Est lié à").
Créer un projet Crée un projet Jira avec un nom, une clé, un type de projet et un modèle spécifiés.
Mettre à jour le projet Met à jour les paramètres d'un projet Jira existant, tels que le nom, la clé, la description ou le responsable.
Créer un journal d'activités Ajoute une entrée de journal d'activités de suivi du temps à un problème Jira.
Mettre à jour le journal d'activités Met à jour une entrée de journal d'activités existante sur un problème Jira.

Niveaux d'accès requis

Pour permettre à Gemini Enterprise d'effectuer des recherches et des actions à l'aide du data store Jira Cloud, vous avez besoin des niveaux d'accès suivants :

Niveaux d'accès classiques

Mode de connexion Autorisation Objectif
Recherche et actions unifiées read:jira-user, read:jira-work Permet à l'assistant de récupérer et d'afficher les résultats de recherche et les informations sur les utilisateurs en temps réel.
write:jira-work Permet à l'assistant de modifier des éléments de travail (par exemple, en mettant à jour les champs de problème), de gérer les commentaires ou les problèmes, et d'importer des pièces jointes.
manage:jira-project Permet à l'assistant de gérer les paramètres du projet Jira et de créer des objets au niveau du projet, tels que des versions et des composants. Obligatoire pour les actions de création et de mise à jour de projet.
Recherche unifiée uniquement read:jira-user, read:jira-work Permet à l'assistant de rechercher et d'afficher des problèmes, des projets et des profils utilisateur.
Ingestion de données et actions read:jira-work Permet à l'assistant d'effectuer une exploration et une indexation étendues des éléments de travail.
write:jira-work Permet à l'assistant d'effectuer des actions d'écriture (création, mises à jour, commentaires et pièces jointes) sur les éléments de travail dans l'environnement ingéré.
Ingestion de données read:jira-work Permet à l'assistant d'explorer et d'indexer le contenu Jira pour la disponibilité de la recherche.

Niveaux d'accès précis

Mode de connexion Autorisation Objectif
Recherche et actions unifiées write:comment:jira Permet au data store de publier de nouveaux commentaires ou réponses directement depuis l'interface Gemini Enterprise.
write:issue:jira Permet au data store de créer des problèmes ou d'apporter des modifications majeures à des problèmes existants.
write:attachment:jira Permet au data store d'importer des pièces jointes dans des problèmes Jira.
write:project:jira Permet au data store de créer et de mettre à jour des projets Jira.
write:issue-worklog:jira Permet au data store de créer et de mettre à jour des journaux d'activités de problèmes.
write:issue-link:jira Permet au data store de créer et de mettre à jour des liens entre des problèmes.
read:issue:jira Permet au data store de lire des problèmes.
read:issue-type:jira Permet au data store de lire des types de problèmes.
read:comment:jira Permet au data store de lire des commentaires.
read:comment.property:jira Permet au data store de lire les propriétés des commentaires de problèmes.
read:project:jira Permet au data store de lire des projets.
read:priority:jira Permet au data store de lire des priorités.
read:issue.transition:jira Permet au data store de lire les transitions de problèmes.
read:issue-meta:jira Permet au data store de lire les métadonnées de problèmes.
read:board-scope.admin:jira-software Permet au data store de lire la configuration, les fonctionnalités du projet, les filtres, les propriétés et les filtres rapides d'un tableau.
read:board-scope:jira-software Permet au data store de lire des tableaux, des problèmes dans un tableau, des problèmes d'un backlog, des rapports et des versions.
read:issue-details:jira Permet au data store de lire les détails des problèmes.
read:jql:jira Permet au data store de lire les requêtes JQL (Jira Query Language).
Recherche unifiée uniquement read:issue:jira Permet au data store de lire des problèmes.
read:issue-type:jira Permet au data store de lire des types de problèmes.
read:comment:jira Permet au data store de lire des commentaires.
read:comment.property:jira Permet au data store de lire les propriétés des commentaires de problèmes.
read:project:jira Permet au data store de lire des projets.
read:priority:jira Permet au data store de lire des priorités.
read:issue.transition:jira Permet au data store de lire les transitions de problèmes.
read:issue-meta:jira Permet au data store de lire les métadonnées de problèmes.
read:board-scope.admin:jira-software Permet au data store de lire la configuration, les fonctionnalités du projet, les filtres, les propriétés et les filtres rapides d'un tableau.
read:board-scope:jira-software Permet au data store de lire des tableaux, des problèmes dans un tableau, des problèmes d'un backlog, des rapports et des versions.
read:sprint:jira-software Permet au data store de lire les détails des sprints.
read:issue-details:jira Permet au data store de lire les détails des problèmes.
read:jql:jira Permet au data store de lire les requêtes JQL (Jira Query Language).
Ingestion de données et actions read:user:jira, read:group:jira, read:avatar:jira Permet de synchroniser les métadonnées utilisateur/de groupe et d'afficher les profils utilisateur.
read:issue-security-level:jira, read:issue-security-scheme:jira Permet le contrôle des accès, en veillant à ce que les données ingérées respectent les limites de sécurité de Jira.
read:audit-log:jira Permet de suivre les modifications et d'effectuer des synchronisations incrémentielles pour maintenir les données ingérées à jour.
write:comment:jira Permet d'ajouter des commentaires aux problèmes à l'aide du data store.
write:issue:jira Permet à l'assistant de créer ou de modifier des problèmes.
Ingestion de données read:user:jira, read:group:jira, read:avatar:jira Permet d'explorer et d'indexer le contenu Jira et les relations utilisateur.
read:issue-security-level:jira, read:issue-security-scheme:jira Permet de mapper les autorisations afin que seuls les utilisateurs autorisés puissent rechercher les données ingérées.
read:audit-log:jira Permet au moteur de synchronisation d'identifier les éléments qui ont été mis à jour ou supprimés.
read:sprint:jira-software Permet au data store de lire les détails des sprints.

Pour savoir comment configurer ces niveaux d'accès, consultez Configurer le niveau d'accès minimal de l'application.

Limites du débit pour l'ingestion de données

Le data store Jira Cloud est compatible avec une limite de débit par défaut de 12 requêtes par seconde (RPS) pour l'ingestion de données. Ces limites de débit s'appliquent exclusivement à l'ingestion de données à partir du data store Jira Cloud.

Limites

Cette section décrit les problèmes et limites connus qui peuvent affecter votre utilisation du data store Jira Cloud.

  • Lorsque vous créez une application ou que vous ajoutez un data store à une application existante, nous vous recommandons d'associer un seul data store à des actions appartenant à un seul type de connecteur.
  • L'application d'un périmètre VPC Service Controls aux datastores Jira Cloud existants n'est pas prise en charge. Pour appliquer VPC Service Controls, vous devez supprimer et recréer les datastores. Pour en savoir plus sur VPC Service Controls et sur l'utilisation des actions après l'activation de VPC Service Controls, consultez Sécuriser votre application avec VPC Service Controls.
  • Le data store Jira Cloud n'est compatible qu'avec les régions global, us, et eu.

Voici les limites du data store d'ingestion Jira Cloud :

  • Pour les données non structurées, chaque type de contenu est soumis à des restrictions différentes. Pour en savoir plus, consultez Préparer des données pour les sources de données personnalisées.

  • Pour les données structurées, chaque document ne doit pas dépasser 500 ko.

  • Les rôles d'application avec des rôles spécifiques et non vides ne peuvent pas se voir accorder des autorisations Browse project ou de niveau de sécurité.

  • Les autorisations de document déterminées par des champs personnalisés d'utilisateur ou de groupe ne sont pas prises en charge.

  • Jira Cloud n'autorise aucune restriction au niveau des journaux d'activités.

  • Jira Cloud n'indexe pas les pièces jointes au format PDF de plus de 2 000 pages.

  • Les pièces jointes ajoutées aux commentaires privés n'héritent pas des restrictions d'accès (LCA) des commentaires.

  • Seuls les 20 commentaires précédents d'un problème dans Jira Cloud sont récupérés.

  • Les tableaux de sprint ne peuvent pas être ingérés.

  • L'ancien modèle de gestion des utilisateurs n'est pas compatible avec l'intégration à Jira Cloud. Seul le modèle de gestion centralisée des utilisateurs est accepté. Pour en savoir plus, consultez le guide de consolidation des organisations Atlassian.

  • Lorsque vous interrogez une entité Jira (par exemple, un problème), les données associées telles que les commentaires et les pièces jointes ne sont pas automatiquement incluses. En effet, elles sont stockées et indexées en tant qu'entités distinctes. La recherche basée sur le contenu d'une pièce jointe pour trouver le problème parent n'est pas prise en charge.

Étape suivante