Configurer un data store Jira Cloud

Version Preview publique : les fonctionnalités de recherche et d'actions fédérées sont disponibles en version Preview publique. Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section Conditions générales du service des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Cette page explique comment créer un data store et associer Jira Cloud à Gemini Enterprise.

Avant de commencer

Avant de configurer votre connexion fédérée Jira Cloud, vérifiez les points suivants :

• Attribuez le rôle d'éditeur Discovery Engine (roles/discoveryengine.editor). Ce rôle est nécessaire pour que l'utilisateur puisse créer le datastore. Pour attribuer ce rôle, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page IAM.

     Accéder à IAM

  2. Recherchez le compte utilisateur, puis cliquez sur l'icône Modifier.
  3. Accordez le rôle Discovery Engine Editor à l'utilisateur. Pour en savoir plus, consultez Rôles et autorisations IAM.

• Pour appliquer le contrôle des accès aux sources de données et sécuriser les données dans Google Gemini Enterprise, configurez votre fournisseur d'identité.

• Pour configurer le connecteur Jira Cloud, vous devez utiliser le nouveau modèle de gestion centralisée des utilisateurs Atlassian. Si vous utilisez le modèle d'origine, vous devez migrer la gestion des utilisateurs avant de continuer. Pour en savoir plus, consultez Rôle d'administrateur de site.

• Créez une application OAuth 2.0, obtenez l'ID client et le code secret, puis configurez les autorisations minimales de l'application avec l'autorisation d'un administrateur Jira Cloud. Vérifiez que vous disposez d'un accès administrateur de l'organisation Jira à l'instance et au projet Jira. L'accès Administrateur de l'organisation vous permet de définir des autorisations minimales et d'accorder des droits d'accès à des groupes d'utilisateurs.

• Facultatif : Pour récupérer les adresses e-mail des utilisateurs depuis Jira Cloud, même lorsque les paramètres limitent leur visibilité, installez l'application User Identity Accessor pour Jira Cloud avec les droits d'administrateur de site Jira pour l'installer et la configurer afin de récupérer les adresses e-mail des utilisateurs de manière sécurisée. Vous n'aurez peut-être pas besoin d'installer cette application si les adresses e-mail sont déjà accessibles publiquement.

  Remarque : Atlassian met à jour les éléments de l'interface utilisateur. Certains éléments mentionnés dans cette documentation sont renommés (par exemple, Products (Produits) devient Apps (Applications)). Pour en savoir plus, consultez Changement de terminologie dans l'administration Atlassian : "products" devient "apps".

Créer un datastore Jira Cloud

Pour créer un datastore Jira Cloud, procédez comme suit :

1. Dans la Google Cloud console, accédez à la page Gemini Enterprise.

   Gemini Enterprise

2. Sélectionnez ou créez un projet Google Cloud .

   Remarque : Pour accéder au flux unifié, votre projet doit figurer sur la liste d'autorisation.

3. Dans le menu de navigation, cliquez sur Datastores.

4. Cliquez sur Créer un datastore.

5. Dans la section Source, recherchez Jira Cloud, puis cliquez sur Sélectionner.

6. Dans la section Données :

   1. Dans la section Mode du connecteur, sélectionnez Ingestion de données ou Recherche unifiée comme mode de connexion.

   2. Cliquez sur Continuer.

   3. Dans la section Paramètres d'authentification, configurez l'authentification en fonction du mode de connexion choisi.

      1. Fournissez les informations d'authentification suivantes :

         • ID client
         • Code secret du client
         • URI de l'instance
         • ID d'instance

         Pour en savoir plus sur les identifiants, consultez la section Configuration de Jira Cloud.

      2. Si vous avez sélectionné Recherche unifiée, cliquez sur Se connecter et connectez-vous à Atlassian.

      3. Cliquez sur Continuer.

   4. Dans la section Destinations (Destinations), saisissez l'URL de votre point de terminaison Jira Cloud.

   5. Cliquez sur Continuer.

   6. Dans la section Entités à rechercher (si vous avez sélectionné Recherche unifiée) ou Entités à synchroniser (si vous avez sélectionné Ingestion de données) :

      1. Sélectionnez toutes les entités requises.
      2. Si vous avez sélectionné Recherche unifiée, passez à l'étape suivante.
      3. Si vous avez sélectionné Ingestion de données, procédez comme suit :
         1. Facultatif : Vous pouvez synchroniser des projets spécifiques en procédant comme suit :
            1. Cliquez sur Filtrer.
            2. Cochez la case Exclure de l'index pour filtrer les entités de l'index ou Inclure dans l'index pour vous assurer qu'elles y sont incluses.
            3. Saisissez les clés. Appuyez sur Entrée après chaque clé.
            4. Cliquez sur Enregistrer.
         2. Pour configurer la planification de synchronisation, procédez comme suit :
            1. Dans la liste Fréquence de synchronisation, sélectionnez la fréquence de synchronisation.
               • Pour planifier des synchronisations complètes distinctes pour les données d'entité et d'identité, développez le menu sous Synchronisation complète, puis sélectionnez Options personnalisées.
            2. Dans la liste Fréquence de synchronisation incrémentielle, sélectionnez la fréquence de synchronisation incrémentielle. Pour en savoir plus, consultez Planification de synchronisation.

7. Cliquez sur Continuer.

8. Dans la section Actions :

   1. Si vous avez sélectionné Recherche unifiée :
      1. Dans Sélectionnez les actions Jira Cloud à activer, sélectionnez les actions de la catégorie pour les activer pour le connecteur.

   2. Si vous avez sélectionné Ingestion de données :

      1. Dans la section Paramètres d'authentification, configurez l'authentification en fonction du mode de connexion choisi.

      2. Fournissez les informations d'authentification suivantes :

         • ID client
         • Code secret du client
         • URI de l'instance
         • ID d'instance

         Pour en savoir plus sur les identifiants, consultez la section Configuration de Jira Cloud.

      3. Cliquez sur Se connecter et connectez-vous à Jira Cloud pour valider votre compte.

      4. Cliquez sur Continuer.

      5. Dans Sélectionnez les actions Jira Cloud à activer, sélectionnez les actions de la catégorie pour les activer pour le connecteur.

      Remarque : Si vous ignorez l'ajout d'actions à cette étape, vous devez créer un datastore pour ajouter des actions. Pour afficher la liste des actions, consultez Afficher les actions.

9. Dans la section Configuration :

   1. Dans la liste Multirégional, sélectionnez l'emplacement de votre connecteur de données.
   2. Dans le champ Nom du connecteur de données, saisissez le nom de votre connecteur.
   3. Si vous avez sélectionné l'emplacement US ou EU, configurez les paramètres de chiffrement :
      • Facultatif : Si vous n'avez pas configuré de clés à région unique, cliquez sur Accéder à la page des paramètres pour le faire. Pour en savoir plus, consultez Enregistrer une clé à région unique pour les connecteurs tiers.
      • Sélectionnez Clé de chiffrement gérée parGoogle ou Clé Cloud KMS.
      • Si vous avez sélectionné Clé Cloud KMS :
        • Dans la liste Type de gestion des clés, sélectionnez le type approprié.
        • Dans la liste Clé Cloud KMS, sélectionnez la clé.
      Pour en savoir plus, consultez Clés de chiffrement gérées par le client.

10. Cliquez sur Continuer.

11. Dans la section Facturation, sélectionnez Tarification générale ou Tarification configurable. Pour en savoir plus, consultez Vérifier l'état de facturation de vos projets et Licences.

12. Cliquez sur Créer. Gemini Enterprise crée votre datastore et l'affiche sur la page Datastores.

Sur la page Datastores, cliquez sur le nom de votre datastore pour afficher l'état. Une fois que l'état du datastore passe de Création à Actif, le connecteur Jira Cloud est prêt à être utilisé.

Pour un connecteur d'ingestion créé avec Jira Cloud, l'état du datastore passe de Création à Exécution lors du lancement de la synchronisation. Il passe ensuite à Actif une fois l'ingestion terminée, ce qui signifie que le datastore est entièrement configuré. Selon le volume de données, l'ingestion peut prendre plusieurs heures.

Après avoir créé le datastore, créez une application, connectez-la au datastore Jira Cloud et autorisez Gemini Enterprise à accéder à Jira Cloud avant d'exécuter des requêtes.

Activer la synchronisation en temps réel pour l'ingestion de données

Preview — Real-time sync

Cette fonctionnalité est soumise(s) aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités de pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

La synchronisation en temps réel ne synchronise que les entités de documents, et non les données associées aux entités d'identité. Le tableau suivant indique les événements liés aux documents compatibles avec la synchronisation en temps réel.

Entités Jira	Créer	Mettre à jour	Supprimer	Modifications d'autorisation
Problèmes
Journaux d'activités
Projets
Commentaires
Pièces jointes

Pour activer la synchronisation en temps réel pour un connecteur de source de données Jira Cloud, procédez comme suit :

Générer une URL de webhook

1. Accédez à la page Gemini Enterprise, puis cliquez sur Datastores dans le menu de navigation.
2. Sélectionnez un datastore Jira Cloud.

3. Cliquez sur Afficher/Modifier sur la ligne Synchronisation en temps réel.

4. Dans la boîte de dialogue View and edit realtime sync parameters (Afficher et modifier les paramètres de synchronisation en temps réel), procédez comme suit :

   1. Pour activer la synchronisation en temps réel, cliquez sur le bouton Activer la synchronisation en temps réel.
   2. Saisissez une valeur dans le champ Code secret du client et copiez-la. Vous aurez à nouveau besoin de cette valeur lors de la création d'un webhook dans la console d'administration Jira.
   3. Cliquez sur Enregistrer.

5. Une fois que l'état de la synchronisation en temps réel passe à Running, cliquez sur Afficher/Modifier.

6. Dans la boîte de dialogue View and edit realtime sync parameters (Afficher et modifier les paramètres de synchronisation en temps réel), procédez comme suit :

   1. Copiez l'URL Webhook.
   2. Cliquez sur Fermer.

Créer un webhook

1. Connectez-vous à la console d'administration Jira.
2. Cliquez sur Settings (Paramètres), puis sélectionnez System (Système).
3. Dans le volet System settings (Paramètres système), sélectionnez Webhooks.
4. Cliquez sur Create a webhook (Créer un webhook). Pour en savoir plus sur les webhooks, consultez Webhooks.
5. Attribuez un nom au webhook.
6. Définissez l'état sur Enabled.
7. Dans le champ URL, collez l'URL copiée depuis Gemini Enterprise et ajoutez /{issue.id}.

8. Dans le champ Secret (Code secret), saisissez la valeur que vous avez saisie lors de la génération d'une URL de webhook dans Gemini Enterprise.

   Remarque : Pour vérifier la cohérence des données et éviter les erreurs lors de la configuration des webhooks dans Jira, ne sélectionnez que les entités pour lesquelles la synchronisation est activée dans votre datastore.

9. Dans la section Issue related events (Événements liés au problème), sélectionnez les options suivantes :

   Entités	Création	Mise à jour	Supprimé
   Problème	Oui	Oui	Oui
   Journal des activités	Oui	Oui	Oui
   Commenter	Oui	Oui	Oui
   Pièce jointe	Oui	Non	Oui

10. Dans la section Project related events (Événements liés au projet), cochez les cases Création, Mise à jour et Suppression pour l'entité Projet.

11. Cliquez sur Créer.

Traitement des données et exécution de la requête

Cette section décrit comment Gemini Enterprise gère votre requête et les implications en termes de confidentialité de l'utilisation du datastore fédéré.

Exécution de la requête

Après avoir autorisé Jira Cloud et envoyé une requête de recherche à Gemini Enterprise :

• Gemini Enterprise envoie votre requête de recherche directement à l'API Atlassian.
• Gemini Enterprise fusionne les résultats avec ceux des autres sources de données connectées et affiche un résultat de recherche complet.

Traitement des données

Lorsque vous utilisez la recherche unifiée tierce, les règles de traitement des données suivantes s'appliquent :

• Votre chaîne de requête est envoyée au backend de recherche tiers (API Atlassian).
• Ces tiers peuvent associer les requêtes à votre identité.
• Si plusieurs sources de données de recherche unifiée sont activées, la requête peut être envoyée à chacune d'elles.
• Une fois les données transférées vers le système tiers, elles sont régies par les conditions d'utilisation et les règles de confidentialité de ce système.

Remarque : Pour améliorer la précision, un LLM peut réécrire votre requête avant de l'envoyer à Jira Cloud. Cette requête réécrite peut inclure des informations provenant de l'historique des requêtes de votre session. Par conséquent, des parties de votre historique des requêtes peuvent également être incluses dans la requête envoyée à l'API Atlassian.

Étapes suivantes

• Pour fournir une interface utilisateur permettant d'interroger vos données Jira Cloud, créez une application et connectez-la au datastore Jira Cloud.
• Pour afficher la liste des actions, consultez Afficher les actions.
• Pour prévisualiser l'apparence de vos résultats de recherche une fois votre application configurée, consultez Obtenir des résultats de recherche.
• Pour activer les alertes pour le datastore, consultez Configurer des alertes pour les datastores tiers.