Aperçu

Le data store Jira Cloud pour Gemini Enterprise vous permet d'accéder à vos données Jira Cloud et d'interagir avec 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éez un commentaire sur un problème Jira spécifique pour ajouter des commentaires, des informations ou des notes.
Modifier le commentaire Modifiez le texte d'un commentaire existant.
Créer un problème Créez 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.
mise à jour d'un incident Mettez à 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écapitulatif, la description et l'attributaire.
Modifier l'état d'un problème Modifier 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 Importer une pièce jointe dans un problème Jira Cloud existant

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 autorisations suivantes :

Niveaux d'accès classiques

Mode de connexion Autorisation Objectif
Recherche et actions fédérées read:jira-user, read:jira-work Permet à l'assistant d'extraire et d'afficher les résultats de recherche et les informations sur l'utilisateur en temps réel.
write:jira-work Permet à l'assistant de modifier des éléments de travail (par exemple, mettre à jour les champs d'un problème) et de gérer les commentaires ou les problèmes.
Recherche unifiée uniquement read:jira-user, read:jira-work Permet à l'assistant de rechercher et d'afficher les problèmes, les projets et les profils utilisateur.
Ingestion et actions sur les données read:jira-work Permet à l'assistant d'explorer et d'indexer les éléments de travail de manière générale.
write:jira-work Permet à l'assistant d'effectuer des actions d'écriture (création, mises à jour, commentaires) 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 le rendre disponible dans la recherche.

Niveaux d'accès précis

Mode de connexion Autorisation Objectif
Recherche et actions fédérées write:comment:jira Permet au data store de publier de nouveaux commentaires ou réponses directement depuis l'interface de recherche.
write:issue:jira Permet au data store de créer des problèmes ou d'apporter des modifications majeures à ceux qui existent déjà.
write:attachment:jira Permet au data store d'ajouter des pièces jointes aux problèmes Jira.
read:issue:jira Permet au data store de lire les problèmes.
read:issue-type:jira Permet au data store de lire les types de problèmes.
read:comment:jira Permet au data store de lire les commentaires.
read:comment.property:jira Permet au data store de lire les propriétés des commentaires sur les problèmes.
read:project:jira Permet au data store de lire les projets.
read:priority:jira Permet au data store de lire les 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 des 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 les tableaux, les problèmes d'un tableau, les problèmes d'un backlog, les rapports et les 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 les problèmes.
read:issue-type:jira Permet au data store de lire les types de problèmes.
read:comment:jira Permet au data store de lire les commentaires.
read:comment.property:jira Permet au data store de lire les propriétés des commentaires sur les problèmes.
read:project:jira Permet au data store de lire les projets.
read:priority:jira Permet au data store de lire les 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 des 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 les tableaux, les problèmes d'un tableau, les problèmes d'un backlog, les rapports et les 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).
Ingestion et actions sur les données read:user:jira, read:group:jira, read:avatar:jira Permet de synchroniser les métadonnées des utilisateurs/groupes 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 et les relations utilisateur de Jira.
read:issue-security-level:jira, read:issue-security-scheme:jira Permet d'attribuer des autorisations de mappage 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é modifiés ou supprimés.

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

Limites de 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 depuis le data store Jira Cloud.

Limites

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

  • Lorsque vous créez une application ou ajoutez un data store à une application existante, nous vous recommandons d'associer un seul data store aux actions appartenant à un seul type de connecteur.
  • Il n'est pas possible d'appliquer un périmètre VPC Service Controls aux data stores Jira Cloud existants. 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'accepte pas les fichiers .xlsx pour l'action d'importation.

  • Le data store Jira Cloud n'est compatible qu'avec les emplacements 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.

Étapes suivantes