Aperçu

Le connecteur 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 connecteur Jira Cloud est compatible avec la version 2 de l'API REST Jira Cloud.

Action compatible

Lorsque le connecteur 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écifique pour ajouter des commentaires, des informations ou des notes.
Modifier le 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.
Problème de mise à jour Met à jour un problème existant dans Jira Cloud. Vous devez fournir l'ID du problème pour l'identifier. Vous pouvez également modifier différents champs, tels que le récapitulatif, la description et l'attributaire.

En plus de celles-ci, d'autres actions en lecture seule sont disponibles.

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 :

Mode de connexion Champ d'application Objectif
Recherche et actions fédérées read:jira-user, read:jira-work Nécessaire pour récupérer et afficher les résultats de recherche et les informations sur les utilisateurs en temps réel.
write:jira-work Permet à l'assistant de modifier les éléments de travail (par exemple, de mettre à jour les champs d'un problème).
write:comment:jira Permet à l'assistant de publier de nouveaux commentaires ou de nouvelles réponses directement depuis l'interface de recherche.
write:issue:jira Nécessaire pour créer des problèmes ou apporter des modifications majeures à ceux qui existent déjà.
Recherche fédérée uniquement read:jira-user, read:jira-work Obligatoire pour rechercher et afficher les problèmes, les projets et les profils utilisateur.
Ingestion et actions sur les données read:jira-work, read:user:jira, read:group:jira, read:avatar:jira Nécessaire pour l'ingestion de données à grande échelle et la synchronisation des métadonnées utilisateur/de groupe.
read:issue-security-level:jira, read:issue-security-scheme:jira Essentiel pour le contrôle des accès, il garantit 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 à jour les données ingérées.
write:jira-work Nécessaire pour effectuer des actions d'écriture sur les éléments de travail dans l'environnement ingéré.
write:comment:jira Obligatoire pour ajouter des commentaires aux problèmes à l'aide de l'assistant.
write:issue:jira Permet de créer ou de modifier des problèmes.
Ingestion de données read:jira-work, read:user:jira, read:group:jira, read:avatar:jira Nécessaire pour explorer et indexer le contenu Jira et les relations entre les utilisateurs.
read:issue-security-level:jira, read:issue-security-scheme:jira Nécessaire pour mapper les autorisations afin que seuls les utilisateurs autorisés puissent rechercher les données ingérées.
read:audit-log:jira Nécessaire pour que le moteur de synchronisation identifie les éléments qui ont été mis à jour 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 connecteur Jira Cloud est compatible avec une limite de fréquence 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 connecteur Jira Cloud.

Limites

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

  • 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'est accepté que dans les emplacements Monde, États-Unis et Union européenne.

  • Lorsque vous créez une application ou ajoutez un data store à une application existante, nous vous recommandons d'ajouter un data store avec des actions appartenant à un seul type de connecteur. Par exemple, n'associez pas deux data stores Jira Cloud avec des actions activées à la même application.

Voici les limites du connecteur 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