Configurer un data store Zendesk

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

Avant de commencer

Avant de configurer votre data store Zendesk, vérifiez les points suivants :

  1. 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.

  2. Créez un client OAuth et obtenez les identifiants suivants :

    • ID client

    • Code secret du client

  3. Configurez les autorisations nécessaires dans Zendesk pour l'application OAuth.

  4. Assurez-vous que l'accès par jeton est activé dans les paramètres de l'API Zendesk.

Créer le data store Zendesk

Pour créer le data store Zendesk, procédez comme suit :

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

    Gemini Enterprise

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

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

  4. Cliquez sur Créer un datastore.

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

  6. Dans la section Données :

    1. Dans la section Paramètres d'authentification, fournissez les informations suivantes : * URI de l'instance : saisissez l'URI de l'instance Zendesk (par exemple, https://[subdomain].zendesk.com). * ID client : identifiant unique de l'application enregistrée dans Zendesk. * Code secret du client : clé secrète générée lors de l'enregistrement de l'application OAuth 2.0 dans Zendesk.

      Pour savoir comment obtenir l'ID client et le code secret du client, consultez Obtenir l'ID client et le code secret du client. Pour connaître les autorisations requises pour effectuer des recherches, consultez Autorisations requises.

    2. Cliquez sur Se connecter et connectez-vous à Zendesk.

    3. Cliquez sur Continuer.

    4. Dans la section Destinations :

      1. Serveur proxy : saisissez le nom d'hôte ou l'adresse IP d'un proxy pour acheminer le trafic HTTP, y compris l'hôte et le port.
      2. URL de l'assistance Zendesk : saisissez l'URL de l'instance, y compris https://, qui est votre URL de l'assistance Zendesk.
      3. Cliquez sur Continuer.

    5. (Facultatif) Dans la section Options avancées :

      1. Activer les adresses IP statiques : enregistre un ensemble restreint d'adresses IP statiques à ajouter à la liste d'autorisation de votre système. Les synchronisations échoueront tant que ces adresses IP ne seront pas ajoutées à la liste d'autorisation.
      2. Nombre maximal de requêtes API par minute : nombre maximal de requêtes API par minute à envoyer à votre instance Zendesk pour chaque exécution de connecteur.
      3. Cliquez sur Continuer.

    6. Dans la section Entités à rechercher, sélectionnez toutes les entités à rechercher dans la liste. Vous devez sélectionner au moins une entité.

  7. Cliquez sur Continuer.

  8. 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.

  9. Cliquez sur Continuer.

  10. 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.

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

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

Pour en savoir plus sur les autorisations requises pour effectuer des recherches, consultez Autorisations requises.

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é Zendesk et envoyé une requête de recherche à Gemini Enterprise :

  • Gemini Enterprise envoie votre requête de recherche directement à l'API Zendesk.
  • 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 Zendesk).
  • 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.

Étapes suivantes