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 de 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.
Mettre à jour 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 une, vous devez fournir un résumé, l'ID du projet et l'ID du type de problème.
mise à jour d'un incident Met à jour un problème existant dans Jira Cloud. Vous devez fournir l'ID du problème pour l'identifier, et vous pouvez modifier différents champs tels que le récapitulatif, la description et la personne responsable.
Modifier l'état du problème Modifiez 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é.
Problèmes de lien Crée un lien entre deux demandes 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 de travail Ajoute une entrée de journal de suivi du temps à un problème Jira.
Mettre à jour le journal de travail Met à jour une entrée de journal de travail existante sur un problème Jira.
Obtenir le tableau Récupère un tableau dans Jira.
Obtenir les problèmes d'un tableau Récupère les problèmes d'un tableau dans Jira.
Lister les tableaux Répertorie les tableaux dans 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 champs d'application suivants :

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 de récupérer 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, de mettre à jour des champs de problème), de gérer des commentaires ou des 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 fédéré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 données 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 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 Gemini Enterprise.
write:issue:jira Permet au data store de créer des problèmes ou d'apporter des modifications majeures aux problèmes existants.
write:attachment:jira Permet au data store d'importer des pièces jointes dans les demandes 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 les journaux de travail des problèmes.
write:issue-link:jira Permet au data store de créer et de mettre à jour des liens entre les problèmes.
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 du problème.
read:jql:jira Permet au data store de lire les requêtes JQL (Jira Query Language).
Recherche fédéré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: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 du problème.
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 des utilisateurs/groupes et d'afficher les profils utilisateur.
read:issue-security-level:jira, read:issue-security-scheme:jira Permet de 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 à jour les données ingérées.
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 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 champs d'application, consultez Configurer le champ d'application minimal de l'application.

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

Le data store Jira Cloud accepte 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 connus et les limites susceptibles d'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 de n'associer qu'un seul data store aux 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 possible. 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 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. Il n'est pas possible d'effectuer une recherche basée sur le contenu d'une pièce jointe pour trouver le problème parent.

Étapes suivantes