Connecter une source de données tierce

Cette page explique comment connecter des sources de données tierces à Vertex AI Search.

Lorsque vous connectez une source de données tierce, Vertex AI Search crée un connecteur de données et lui associe des datastores (appelés datastores d'entité) pour les entités que vous spécifiez. Les types d'entités sont spécifiques à la source de données à laquelle vous vous connectez. Par exemple, les entités Jira Cloud incluent les problèmes, les pièces jointes, les commentaires et les journaux de travail.

Les sources de données tierces ne sont disponibles que pour les applications de recherche génériques. Les applications Chat, de recommandations et d'agents ne peuvent pas utiliser de sources de données tierces.

Les connecteurs tiers ne sont pas compatibles avec les CMEK.

Pour importer des données à partir d'une source de données Google, consultez Créer un entrepôt de données de recherche.

Avant de commencer

  1. Contactez l'équipe chargée de votre compte Google et demandez à être ajouté à la liste d'autorisation des connecteurs de sources de données tierces.

  2. Accédez à la section de la source que vous prévoyez d'utiliser:

Associer Adobe Experience Manager

Suivez la procédure ci-dessous pour synchroniser les données d'Adobe Experience Manager avec la recherche Vertex AI.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connexion:

  1. En plus de la liste d'autorisation du connecteur tiers, ce connecteur nécessite que votre projet soit ajouté à une liste d'autorisation supplémentaire. Pour être ajouté à cette liste d'autorisation, contactez l'équipe chargée de votre compte Vertex AI Search.

  2. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

  3. Un administrateur Adobe Experience Manager doit générer ou obtenir les éléments suivants pour l'intégration à Vertex AI Search:

    • Identifiants de service de votre instance Adobe Experience Manager
    • URL d'instance de votre site Adobe Experience Manager

Créer un connecteur Adobe Experience Manager

Console

Pour synchroniser les données d'Adobe Experience Manager avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Adobe Experience Manager pour associer votre source tierce.

  5. Saisissez vos informations d'authentification Adobe Experience Manager, puis cliquez sur Continuer.

  6. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  7. Sélectionnez une région pour votre data store.

  8. Attribuez un nom à votre connecteur de données.

  9. Sélectionnez une fréquence de synchronisation.

  10. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  11. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre connecteur pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.

Étapes suivantes

Connecter AODocs

Suivez la procédure ci-dessous pour synchroniser les données d'AODocs avec la recherche Vertex AI.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connexion:

  1. En plus de la liste d'autorisation du connecteur tiers, ce connecteur nécessite que votre projet soit ajouté à une liste d'autorisation supplémentaire. Pour être ajouté à cette liste d'autorisation, contactez l'équipe chargée de votre compte Vertex AI Search.

  2. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

  3. Un administrateur AODocs doit générer ou obtenir les éléments suivants pour l'intégration à Vertex AI Search:

    • ID d'instance (URL de domaine de votre instance AODocs)
    • ID client
    • Code secret du client

Créer un connecteur AODocs

Console

Pour synchroniser les données d'AODocs avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez AODocs pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification AODocs, puis cliquez sur Authentifier. Une nouvelle fenêtre s'affiche.

  6. Authentifiez-vous et vérifiez que l'authentification a réussi avant de revenir à la page Spécifier la source AODocs pour votre datastore.

  7. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  8. Sélectionnez une région pour votre data store.

  9. Attribuez un nom à votre connecteur de données.

  10. Sélectionnez une fréquence de synchronisation.

  11. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  12. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre connecteur pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.

Étapes suivantes

Connect Box

Suivez la procédure ci-dessous pour synchroniser les données de Box avec la recherche Vertex AI.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connexion:

  1. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

  2. Préparez les informations d'authentification Box suivantes. Pour en savoir plus sur la configuration de ces paramètres, consultez Authentification JWT dans la documentation destinée aux développeurs Box.

    • ID Box Entreprise
    • ID client
    • Code secret du client
    • ID de clé publique
    • Clé privée
    • Phrase secrète

  3. Lorsque vous créez le point de terminaison JWT, configurez les portées suivantes:

La synchronisation des modifications incrémentielles des commentaires peut prendre plus de temps que l'intervalle de fréquence configuré. Si un dossier contenant une entité est copié ou déplacé, la synchronisation des modifications incrémentielles peut prendre plus de temps que l'intervalle de fréquence configuré.

Créer une application Box

  1. Connectez-vous à la console de développement Box à l'aide de votre compte administrateur.
  2. Cliquez sur Créer une application.
  3. Sélectionnez le type Application personnalisée.
  4. Saisissez le nom de l'application.
  5. Définissez l'objectif de l'application: intégration, IA ou Google Cloud Agent Builder.
  6. Sélectionnez Authentification du serveur avec JWT.

Configurer l'application Box

  1. Configurez les paramètres de votre application Box en créant une clé publique/privée:

    1. Accédez à la console pour les développeurs Box.

    2. Dans l'onglet Configuration, cliquez sur Générer une paire de clés publique/privée.

      • La clé publique est automatiquement importée dans la console avec un ID. Cet ID est utilisé lors de la création d'une connexion.
      • Vous pouvez télécharger localement un fichier de configuration contenant la clé privée et la phrase secrète. Veillez à conserver ce fichier de configuration pour une utilisation ultérieure.
      • Si vous le souhaitez, vous pouvez générer votre propre clé en consultant le guide de configuration de la paire de clés Box.

  2. Configurez les autorisations requises: dans la section Champs d'application, sélectionnez Read all files and folders stored in box (Lire tous les fichiers et dossiers stockés dans Box).

    1. Dans l'onglet Autorisation, cliquez sur Examiner et envoyer, puis attendez l'approbation de votre administrateur.
    2. Les administrateurs peuvent approuver l'application dans la console d'administration.

    Une fois l'autorisation accordée, Box configure entièrement l'application.

Créer un connecteur Box

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de Box avec Vertex AI Search, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Box pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification.

  6. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  7. Sélectionnez une région pour votre data store.

  8. Attribuez un nom à votre datastore.

  9. Sélectionnez une fréquence de synchronisation pour votre data store.

  10. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  11. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre data store pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre des minutes ou des heures.

Étapes suivantes

Connect Coda

Suivez la procédure ci-dessous pour synchroniser les données de Coda avec Vertex AI Search.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connexion:

  1. En plus de la liste d'autorisation du connecteur tiers, ce connecteur nécessite que votre projet soit ajouté à une liste d'autorisation supplémentaire. Pour être ajouté à cette liste d'autorisation, contactez l'équipe chargée de votre compte Vertex AI Search.

  2. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

  3. Un administrateur Coda doit générer ou obtenir le jeton d'API Coda pour l'intégrer à Vertex AI Search.

Créer un connecteur Coda

Console

Pour synchroniser les données de Coda avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Coda pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification Coda, puis cliquez sur Continuer.

  6. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  7. Sélectionnez une région pour votre data store.

  8. Attribuez un nom à votre connecteur de données.

  9. Sélectionnez une fréquence de synchronisation.

  10. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  11. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre connecteur pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.

Étapes suivantes

Connecter Confluence Cloud

Suivez la procédure ci-dessous pour synchroniser les données de Confluence Cloud avec la recherche Vertex AI.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, vous pouvez choisir la fréquence de synchronisation du data store avec cette source.

Avant de commencer

Avant de configurer votre connexion:

  1. Vérifiez que vous disposez d'un accès administrateur à l'instance et au projet Confluence.

  2. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

Configurer l'authentification et les autorisations dans Confluence

Assurez-vous de disposer des informations d'authentification nécessaires et d'un accès administrateur à votre instance Confluence. Suivez les instructions ci-dessous pour créer un ID client et code secret du client dans la console de développement Atlassian, configurer les portées OAuth 2.0 requises, configurer les autorisations pour les utilisateurs, récupérer l'URL et l'ID de votre instance, configurer des rôles et vous authentifier pour synchroniser les données entre Confluence Cloud et Vertex AI Search. Pour activer OAuth 2.0 et obtenir l'ID client et le secret, consultez Applications OAuth 2.0 (3LO) dans la documentation pour les développeurs Atlassian.

  1. Créez une intégration OAuth 2.0 dans la console de développement Atlassian:

    1. Connectez-vous à la console de développement Atlassian.
    2. Cliquez sur l'icône de profil, puis sélectionnez Atlassian Developer Console (Console de développement Atlassian).
    3. Cliquez sur Créer, puis sélectionnez Intégration OAuth 2.0.
    4. Attribuez un nom à l'application, puis procédez comme suit :
      1. Cochez la case des conditions d'utilisation.
      2. Cliquez sur Créer.
      3. Cliquez sur Autorisation.
      4. Dans le tableau Type d'autorisation, sélectionnez Ajouter pour OAuth 2.0 (3LO).
    5. Dans le champ Callback URL (URL de rappel), saisissez https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html.
    6. Cliquez sur Enregistrer les modifications.

    Si l'avertissement Votre application ne contient aucune API s'affiche, Ajoutez des API à votre application, puis passez à l'étape 2 et suivez toutes les étapes restantes. Sinon, passez aux étapes 4 et 5.

  2. Activez OAuth 2.0:

    1. Cliquez sur Autorisations.
    2. Accédez à l'API Confluence.
    3. Cliquez sur Ajouter.
    4. Cliquez sur Configurer.
    5. Accédez à l'onglet Champs d'application précis, puis cliquez sur Modifier les champs d'application.
    6. Sélectionnez les champs d'application suivants.
    7. Vérifiez que sept champs d'application sont sélectionnés, puis enregistrez vos modifications.

  3. Obtenez l'ID client et le code secret du client:

    1. Cliquez sur Distribution.
    2. Sélectionnez Modifier.
    3. Sélectionnez Partage pour pouvoir modifier d'autres champs.
    4. Renseignez les champs restants.
    5. Sélectionnez Oui lorsque vous voyez Does your app store personal data?.
    6. Sélectionnez Paramètres pour copier votre ID client et votre code secret client.

  4. Obtenez l'URL de l'instance:

    1. Accédez à atlassian.net, puis connectez-vous avec votre compte administrateur.
    2. Sélectionnez l'application que vous souhaitez synchroniser. Par exemple, synchronisez la première application.
    3. Recherchez l'URL de l'instance. Il s'affiche sous forme de sous-domaine dans la barre d'adresse.

  5. Obtenez l'ID d'instance:

    1. Ouvrez un nouvel onglet, copiez l'URL de l'instance, puis ajoutez /_edge/tenant_info à l'URL de l'instance. Exemple :https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info
    2. Accédez au lien pour trouver la valeur cloudId. cloudId est l'ID de votre instance.

Configurer les autorisations et les rôles

  1. Connectez-vous à atlassian.com avec votre compte administrateur.
  2. Cliquez sur l'icône du menu ou accédez à admin.atlassian.com.
  3. Sur la page Administration, cliquez sur Gérer les utilisateurs, puis accédez à la page Groupes.
  4. Accédez au site de votre domaine Atlassian et ouvrez l'instance Confluence Cloud.
  5. Accédez à IAM.

  6. Attribuez le rôle Moteur de découverte à l'administrateur Confluence. L'administrateur Confluence peut ainsi configurer le connecteur comme décrit dans Créer un connecteur Confluence Cloud.

  7. Attribuez le rôle d'administrateur à un utilisateur:

    1. Créez un compte utilisateur dédié. Utilisez ce compte pour configurer le data store.
    2. Attribuez le rôle Administrateur au nouvel utilisateur.

  8. Configurez les autorisations dans Atlassian:

    1. Accédez au site de votre domaine Atlassian et ouvrez l'instance Confluence Cloud. Vous pouvez également accéder directement à admin.atlassian.com.

    2. Cliquez sur l'icône de menu, puis sélectionnez l'option requise.

    3. Facultatif: Si vous y êtes invité, sélectionnez l'organisation appropriée sur la page de destination.

  9. Créez et configurez des groupes:

    1. Sur la page Administrateur, cliquez sur le bouton Gérer les utilisateurs si nécessaire, puis sélectionnez Gérer les utilisateurs dans la liste déroulante.
    2. Sur la page Gestion des utilisateurs, sélectionnez Groupes.
    3. Cliquez sur Créer un groupe et attribuez-lui un nom. Utilisez ce groupe pour attribuer les autorisations requises par le connecteur.

  10. Ajoutez des autorisations au groupe: attribuez le rôle Administrateur de l'accès des utilisateurs.

  11. Attribuez des membres au groupe:

    1. Sur la page Group (Groupe), cliquez sur Add product (Ajouter un produit), puis sélectionnez le rôle de produit approprié dans la liste déroulante.Dans ce cas, sélectionnez User access admin (Administrateur de l'accès utilisateur).
    2. Cliquez sur Ajouter pour confirmer l'attribution du rôle.
    3. Cliquez sur Ajouter des membres du groupe pour inclure des comptes utilisateur ou des membres de groupe. Assurez-vous que le connecteur s'authentifie pour le compte de ces utilisateurs afin d'extraire des documents.

Pour que les autorisations utilisateur s'appliquent correctement, chaque utilisateur Confluence Cloud doit rendre son adresse e-mail visible pour tous les utilisateurs. Pour ce faire, modifiez les paramètres de visibilité des e-mails dans Confluence Cloud et définissez la visibilité sur Anyone. Pour en savoir plus, consultez la section Définir la visibilité de votre adresse e-mail dans la documentation Atlassian.

Créer un connecteur Confluence Cloud

Console

Pour synchroniser les données de Confluence Cloud avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Confluence pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification, puis cliquez sur Authentifier.

  6. Une nouvelle fenêtre s'ouvre. Saisissez le nom d'utilisateur et le mot de passe de l'instance. Vérifiez que l'authentification a réussi avant de revenir à la page Spécifier la source Confluence pour votre data store.

  7. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  8. Sélectionnez une région pour votre connecteur de données.

  9. Attribuez un nom à votre connecteur de données.

  10. Sélectionnez une fréquence de synchronisation.

  11. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Datastores).

  12. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre data store pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre des minutes ou des heures.

Étapes suivantes

Connecter Confluence Data Center sur site

Suivez cette procédure pour créer un data store et une application de recherche Confluence Data Center dans Agent Builder, en synchronisant les données Confluence sur site avec Vertex AI Search.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, vous pouvez choisir la fréquence de synchronisation du data store avec cette source.

Avant de commencer

Avant de configurer votre connexion, assurez-vous de disposer des éléments suivants:

  1. Pièce jointe de service (obligatoire pour le type de destination privé uniquement): configurez une pièce jointe de service pour le transfert sécurisé des données.
  2. Nom d'utilisateur et mot de passe: obtenez auprès de votre administrateur Confluence des identifiants valides pour l'authentification.
  3. Facultatif pour le type de destination privée: URL du domaine: spécifiez l'URL de l'instance Confluence Data Center.
  4. Facultatif: Nom de domaine de base: indiquez le nom de domaine de base de l'instance Confluence.
  5. Facultatif: Port de destination: identifiez le port utilisé pour la communication avec le centre de données Confluence.

  6. Suivez les consignes de configuration suivantes pour établir des connexions avec Private Service Connect(PSC). Ajustez ou ajoutez des ressources si nécessaire. Assurez-vous que le rattachement de service PSC est correctement configuré pour se connecter à l'instance privée et qu'il répond aux exigences d'un service publié.

    1. Configurez les paramètres réseau en procédant comme suit :

      1. Placez le rattachement de service PSC et l'équilibreur de charge dans des sous-réseaux différents du même réseau cloud privé virtuel.

      2. Pour des raisons de sécurité, le système backend doit rester fermé au réseau public. Toutefois, assurez-vous qu'il peut accepter le trafic provenant des sources suivantes:

    2. Ajustez les règles de pare-feu:

      1. Règles d'Ingress:

        • Autorisez le trafic du sous-réseau d'association du service PSC vers le sous-réseau de l'équilibreur de charge interne (ILB).
        • Assurez-vous que l'ILB peut envoyer du trafic au backend.
        • Autorisez les vérifications d'état à atteindre le backend.

      2. Règles de sortie: activez le trafic sortant par défaut, sauf si des règles de refus spécifiques s'appliquent.

  7. Remarques supplémentaires: Veillez à placer tous les composants, y compris le rattachement de service PSC et l'équilibreur de charge, dans la même région.

Générer un rattachement de service

Pour générer une pièce jointe de service, procédez comme suit:

  1. Choisir le type de point de terminaison: sélectionnez un point de terminaison public ou privé.

  2. Pour les points de terminaison publics: si le type de destination de Confluence Data Center est public, vous n'avez pas besoin de créer la configuration pour le rattachement de service. Vous pouvez plutôt utiliser votre URL publique dans le champ URL du domaine de la console Google Cloud lorsque vous créez votre connecteur.

  3. Pour le point de terminaison privé:

    1. Utilisez Private Service Connect (PSC) pour autoriser les connexions à partir d'instances privées vers Google Cloud.

    2. Créez un réseau cloud privé virtuel et les sous-réseaux requis.

    3. Créez une instance de machine virtuelle (VM) et installez le service de backend.

    4. Facultatif: configurez une sonde de vérification d'état pour surveiller l'état du backend.

    5. Ajoutez un équilibreur de charge pour acheminer le trafic vers la VM ou le backend.

    6. Définissez des règles de pare-feu pour autoriser le trafic entre le point de terminaison PSC et le backend.

    7. Publiez le point de terminaison en créant un rattachement de service PSC.

Créer un utilisateur Confluence Data Center et configurer les autorisations

Pour permettre à Vertex AI Search d'obtenir des données à partir de Confluence, vous devez créer un utilisateur disposant des autorisations minimales nécessaires. Suivez ces étapes pour créer l'utilisateur et configurer les autorisations requises.

  1. Connectez-vous en tant qu'administrateur:

    1. Accédez au site de votre domaine Atlassian et ouvrez l'instance Confluence Data Center.
    2. Saisissez le nom et le mot de passe de l'administrateur.
    3. Cliquez sur Connexion.

  2. Créez un utilisateur:

    Lorsque vous créez un data store, vous devez créer un utilisateur pour obtenir des données à partir de l'instance tierce.

    1. Cliquez sur l'icône des paramètres.
    2. Sélectionnez Gestion des utilisateurs.
    3. Saisissez les identifiants administrateur si vous y êtes invité.
    4. Sur la page Administration, cliquez sur Créer un utilisateur.
    5. Saisissez l'adresse e-mail, le nom complet, le nom d'utilisateur et le mot de passe.
    6. Cliquez sur Créer un utilisateur.

  3. Attribuer un utilisateur à un groupe:

    1. Sur la page Administration de Confluence, accédez à l'onglet "Utilisateurs et sécurité", puis cliquez sur Groupes.
    2. Cliquez sur Ajouter un groupe. Attribuez un nom au groupe, puis créez-le.
    3. Dans le champ Rechercher un groupe, saisissez le nom du groupe à rechercher.
    4. Cliquez sur l'icône des paramètres.
    5. Sélectionnez le compte de fiche, puis accédez à Gestion des utilisateurs.
    6. Sur la page Utilisateurs, sous List users (Liste des utilisateurs), recherchez l'utilisateur que vous venez de créer dans le champ Find user (Rechercher un utilisateur).
    7. Cliquez sur l'utilisateur pour ouvrir la page Afficher les utilisateurs.
    8. Cliquez sur Modifier les groupes pour ouvrir la page Modifier un groupe d'utilisateurs.
    9. Cochez la case correspondant au groupe d'utilisateurs créé.
    10. Cliquez sur Enregistrer pour attribuer l'utilisateur au groupe que vous venez de créer.

    L'utilisateur ajouté est attribué dans la section Membres du groupe.

  4. Configurez les autorisations des utilisateurs:

    1. Sur la page Administration de Confluence, accédez à l'onglet Problèmes.
    2. Recherchez Autorisations.
    3. Sélectionnez Afficher les autorisations globales.
    4. Sélectionnez Modifier les autorisations.
    5. Sur la page Modifier les autorisations globales, recherchez le groupe attribué à l'utilisateur, puis activez l'option peut utiliser.

Configurer l'espace de documentation

  1. Cliquez sur l'icône Confluence pour accéder à la page Dashboard (Tableau de bord).
  2. Cliquez sur Créer un espace.
  3. Sélectionnez Espace de documentation, puis cliquez sur Suivant.
  4. Saisissez toutes les informations nécessaires, puis cliquez sur Créer pour créer l'espace de documentation.
  5. Sous Mes espaces, cliquez sur l'espace que vous venez de créer.
  6. Accédez à Pages, puis ouvrez le menu (trois points).
  7. Sélectionnez Restrictions.
  8. Dans le menu déroulant Restrictions, sélectionnez l'option Affichage et modification des éléments soumis à restriction.
  9. Recherchez le groupe et attribuez-lui l'autorisation peut afficher.
  10. Cliquez sur Appliquer. L'utilisateur est créé avec un accès minimal et des autorisations sont définies pour les espaces. Vous pouvez également attribuer des autorisations aux blogs.

Créer un connecteur sur site Confluence Data Center

Console

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionnez une source de données, faites défiler la page ou recherchez Centre de données Confluence pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification, puis cliquez sur Continuer.

  6. Dans la liste déroulante Type de destination, sélectionnez Public ou Privé.

    1. Pour le type de destination Public, vous n'avez pas besoin de créer la configuration pour le rattachement de service. Vous pouvez utiliser votre URL publique dans le champ "URL du domaine" de la console Google Cloud.

    2. Pour le type de destination Privé, saisissez toutes les informations requises:

      1. Par exemple, avec l'URL du domaine :
        • Rattachement de service: saisissez votre rattachement de service.
        • (Facultatif) Nom de domaine de base : saisissez votre domaine de base.
        • URL du domaine: saisissez l'URL de votre domaine.
        • Facultatif: Port de destination: saisissez le port de destination.
      2. Par exemple, sans URL de domaine :
        • Rattachement de service: saisissez votre rattachement de service.
        • Facultatif: Port de destination: saisissez le port de destination.

  7. Cliquez sur Continuer.

  8. Facultatif: Options avancées: sélectionnez et activez les paramètres de proxy et les paramètres SSL, si nécessaire.

  9. Sous Entités à synchroniser, sélectionnez toutes les entités requises à synchroniser, puis cliquez sur Continuer.

  10. Sélectionnez une région pour votre connecteur de données, puis saisissez un nom pour celui-ci.

  11. Sélectionnez une fréquence de synchronisation.

Pour le type de destination Privé, une fois que vous avez envoyé les informations du connecteur, VAIS envoie une demande de connexion à votre PSC. Accédez à votre connecteur pour voir un message vous invitant à ajouter un projectId à la liste d'autorisation dans le PSC. Le connecteur reste à l'état Error (Erreur) jusqu'à ce que vous autorisiez la connexion dans PSC. Lorsque vous acceptez la demande de connexion, le connecteur passe à l'état Actif lors de la prochaine exécution de la synchronisation. Si vous configurez votre PSC pour qu'il accepte toutes les connexions, le connecteur passe automatiquement à l'état Active (Actif) après sa création.

Pour le type de destination Public, le connecteur passe automatiquement à l'état Actif après l'envoi.

Pour vérifier l'état du data store et de l'activité d'ingestion, procédez comme suit:

  1. Accédez au connecteur dans la liste des data store et surveillez son état jusqu'à ce qu'il passe à Active (Actif).
  2. Une fois que l'état du connecteur est défini sur Actif, cliquez sur l'entité requise et vérifiez que toutes les entités sélectionnées sont ingérées. L'état du data store passe de Création à En cours d'exécution au début de la synchronisation, puis à Actif une fois l'ingestion terminée, ce qui indique que le data store est configuré.Selon la taille de vos données, l'ingestion peut prendre plusieurs heures.

Étapes suivantes

Connecter Dropbox

Suivez la procédure ci-dessous pour synchroniser les données de Dropbox avec la recherche Vertex AI.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connexion:

  1. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus, consultez Utiliser le contrôle des accès aux sources de données.

  2. Préparez les informations d'authentification Dropbox suivantes. Pour en savoir plus sur la configuration de ces paramètres, consultez le guide OAuth dans la documentation Dropbox.

    • ID client
    • Code secret du client

Créer un connecteur Dropbox

Console

Pour synchroniser les données Dropbox avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Data Stores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Dropbox pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification Dropbox, puis cliquez sur Authentifier. Une nouvelle fenêtre s'ouvre.

  6. Authentifiez votre compte et vérifiez que l'authentification a réussi avant de revenir à la page Spécifier la source Dropbox pour votre data store.

  7. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  8. Sélectionnez un emplacement pour votre data store.

  9. Attribuez un nom à votre datastore.

  10. Sélectionnez une fréquence de synchronisation pour votre data store.

  11. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  12. Pour vérifier l'état de l'ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre data store pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée. Accédez à l'onglet Documents pour vous assurer que vos entités ont été ingérées correctement.

    Selon la taille de vos données, l'ingestion peut prendre des minutes ou des heures.

Étapes suivantes

Connecter Dynamics 365

Suivez la procédure ci-dessous pour synchroniser les données de Dynamics 365 avec la recherche Vertex AI.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de créer un connecteur Dynamics 365:

  1. Un administrateur Dynamics 365 doit générer ou obtenir les éléments suivants pour l'intégration à Vertex AI Search:

    • ID client
    • Code secret du client
    • Locataire Azure
    • URL de l'organisation

  2. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

Créer un connecteur Dynamics 365

Console

Pour synchroniser les données de Dynamics 365 avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Dynamics 365 pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification Dynamics 365, puis cliquez sur Continuer.

  6. Saisissez l'URL de votre locataire Azure et de votre organisation, puis cliquez sur Continuer.

  7. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  8. Sélectionnez une région pour votre data store.

  9. Attribuez un nom à votre connecteur de données.

  10. Sélectionnez une fréquence de synchronisation.

  11. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  12. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre connecteur pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.

Étapes suivantes

Connecter GitHub

Suivez la procédure ci-dessous pour synchroniser les données de GitHub avec Vertex AI Search.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connexion:

  1. En plus de la liste d'autorisation du connecteur tiers, ce connecteur nécessite que votre projet soit ajouté à une liste d'autorisation supplémentaire. Pour être ajouté à cette liste d'autorisation, contactez l'équipe chargée de votre compte Vertex AI Search.

  2. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

  3. Un administrateur GitHub doit obtenir le jeton d'accès personnel de l'instance GitHub pour l'intégrer à la recherche Vertex AI.

Créer un connecteur GitHub

Console

Pour synchroniser les données de GitHub avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez GitHub pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification GitHub, puis cliquez sur Continuer.

  6. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  7. Sélectionnez une région pour votre data store.

  8. Attribuez un nom à votre connecteur de données.

  9. Sélectionnez une fréquence de synchronisation.

  10. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  11. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre connecteur pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.

Étapes suivantes

Connecter GitLab

Pour synchroniser les données de GitLab avec Vertex AI Search, procédez comme suit :

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connexion:

  1. En plus de la liste d'autorisation du connecteur tiers, ce connecteur nécessite que votre projet soit ajouté à une liste d'autorisation supplémentaire. Pour être ajouté à cette liste d'autorisation, contactez l'équipe chargée de votre compte Vertex AI Search.

  2. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

  3. Un administrateur GitLab doit obtenir le jeton d'accès personnel de l'instance GitLab pour l'intégrer à la recherche Vertex AI.

Créer un connecteur GitLab

Console

Pour synchroniser les données de GitLab avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionnez une source de données, faites défiler la page ou recherchez GitLab pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification GitLab, puis cliquez sur Continuer.

  6. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  7. Sélectionnez une région pour votre data store.

  8. Attribuez un nom à votre connecteur de données.

  9. Sélectionnez une fréquence de synchronisation.

  10. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  11. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre connecteur pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.

Étapes suivantes

Connecter Jira Cloud

Pour synchroniser les données de Jira Cloud avec la recherche Vertex AI, procédez comme suit :

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, vous pouvez choisir la fréquence de synchronisation du data store avec cette source.

Avant de commencer

Avant de configurer votre connexion:

  1. Vérifiez que vous disposez d'un accès administrateur à l'instance Jira et au projet.

  2. Configurez le contrôle des accès. Assurez-vous que le contrôle des accès est correctement configuré pour votre source de données. Cette étape permet de s'assurer que seuls les utilisateurs autorisés peuvent accéder aux données et les gérer. Pour en savoir plus, consultez la documentation Utiliser le contrôle des accès aux sources de données.

  3. Pour que les autorisations utilisateur s'appliquent correctement, les utilisateurs Jira Cloud doivent donner leur autorisation de partage.

  4. Assurez-vous de disposer d'un compte Atlassian, d'une instance Jira et d'un projet.

Configurer l'authentification et les autorisations dans Jira

Assurez-vous de disposer des informations d'authentification nécessaires et d'un accès administrateur à votre instance Jira. Suivez les instructions ci-dessous pour créer un ID client et code secret du client via la console de développement Atlassian, configurer les portées OAuth 2.0 requises, configurer les autorisations pour les utilisateurs, récupérer l'URL et l'ID de votre instance, configurer des rôles et vous authentifier pour synchroniser les données entre Jira Cloud et Vertex AI Search. Pour activer OAuth 2.0 et obtenir l'ID client et le secret, consultez Applications OAuth 2.0 (3LO) dans la documentation pour les développeurs Atlassian.

  1. Créez une intégration OAuth 2.0 dans la console de développement Atlassian:

    1. Connectez-vous à la console de développement Atlassian.
    2. Cliquez sur l'icône de profil, puis sélectionnez Console de développement.
    3. Cliquez sur Créer, puis sélectionnez Intégration OAuth 2.0.
    4. Saisissez un nom pour l'application, puis procédez comme suit:

  2. Dans le champ Callback URL (URL de rappel), saisissez https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html.

  3. Cliquez sur Enregistrer les modifications.

    Si l'avertissement Votre application ne contient aucune API s'affiche, Ajoutez des API à votre application, puis passez à l'étape 2 et suivez toutes les étapes restantes. Sinon, passez aux étapes 4 et 5.

  4. Activez OAuth 2.0:

    1. Sélectionnez Autorisations:
    • Accédez à l'API Jira.
    • Cliquez sur Ajouter.
    • Cliquez sur Configurer.
    • Accédez à l'onglet Champs d'application classiques, puis cliquez sur Modifier les champs d'application. Sélectionnez les champs d'application suivants :
    • Accédez à l'onglet Champs d'application précis, puis cliquez sur Modifier les champs d'application. Sélectionnez les portées suivantes :
    1. Vérifiez que huit champs d'application sont sélectionnés, puis enregistrez vos modifications.

  5. Obtenez l'ID client et le code secret du client:

    1. Cliquez sur Distribution.

    2. Sélectionnez Modifier, puis procédez comme suit:

      1. Sélectionnez Partage pour pouvoir modifier d'autres champs.
      2. Renseignez les champs restants.
      3. Sélectionnez Oui lorsque vous voyez Does your app store personal data?.

    3. Sélectionnez Paramètres pour copier votre ID client et votre code secret client.

  6. Obtenez l'URL de l'instance:

    1. Accédez à atlassian.net, puis connectez-vous avec votre compte administrateur.
    2. Sélectionnez l'application que vous souhaitez synchroniser. Par exemple, synchronisez la première application.
    3. Recherchez l'URL de l'instance, qui correspond au sous-domaine dans la barre d'adresse.

  7. Obtenez l'ID d'instance:

    1. Ouvrez un nouvel onglet, copiez l'URL de l'instance, puis ajoutez /_edge/tenant_info à l'URL de l'instance. Exemple :https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info
    2. Accédez au lien pour trouver la valeur cloudId. cloudId est l'ID de votre instance.

Configurer les autorisations et les rôles

  1. Connectez-vous à atlassian.com avec votre compte administrateur.
  2. Cliquez sur l'icône de menu en haut à gauche ou accédez à admin.atlassian.com.
  3. Sur la page Administration, cliquez sur Gérer les utilisateurs, puis accédez à la page Groupes.
  4. Cliquez sur Créer un groupe. Attribuez un nom au groupe, puis créez-le.
  5. Cliquez sur Ajouter un produit.
  6. Dans la boîte de dialogue Ajouter des produits au groupe, sélectionnez Administrateur de l'accès des utilisateurs comme rôle produit.
  7. Cliquez sur Ajouter.
  8. Sur la page Groupes, cliquez sur Ajouter des membres au groupe pour ajouter les utilisateurs ou les comptes que le connecteur authentifie.

Pour que les autorisations utilisateur s'appliquent correctement, chaque utilisateur Jira Cloud doit rendre son adresse e-mail visible pour tous les utilisateurs. Pour ce faire, modifiez les paramètres de visibilité des e-mails dans Confluence Cloud et définissez la visibilité sur Anyone. Pour en savoir plus, consultez la section Définir la visibilité de votre adresse e-mail dans la documentation Atlassian.

Créer un connecteur Jira Cloud

Console

Pour synchroniser les données de Jira Cloud avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Data Stores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Jira Cloud pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification, puis cliquez sur Authentifier.

  6. Saisissez le nom d'utilisateur et le mot de passe de l'instance.

  7. Vérifiez que l'authentification a réussi avant de revenir à la page Spécifier la source Jira de votre data store.

  8. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  9. Sélectionnez une région pour votre data store.

  10. Attribuez un nom à votre datastore.

  11. Sélectionnez une fréquence de synchronisation.

  12. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Datastores).

  13. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre data store pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre des minutes ou des heures.

Étapes suivantes

Connecter Jira Data Center sur site

Suivez cette procédure pour créer un data store et une application de recherche Jira Data Center dans Agent Builder, en synchronisant les données Jira sur site avec Vertex AI Search.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, vous pouvez choisir la fréquence de synchronisation du data store avec cette source.

Avant de commencer

Avant de configurer votre connexion, assurez-vous de disposer des éléments suivants:

  1. Pièce jointe de service (obligatoire pour le type de destination privé uniquement): configurez une pièce jointe de service pour le transfert sécurisé des données.
  2. Nom d'utilisateur et mot de passe: obtenez auprès de votre administrateur Jira des identifiants valides pour l'authentification.
  3. Facultatif pour le type de destination privé: URL du domaine: indiquez l'URL de l'instance Jira Data Center.
  4. (Facultatif) Nom de domaine de base : indiquez le nom de domaine de base de l'instance Jira.
  5. Facultatif: Port de destination: identifiez le port utilisé pour la communication avec le centre de données Jira.

  6. Suivez les consignes de configuration suivantes pour établir des connexions avec Private Service Connect (PSC). Ajustez ou ajoutez des ressources si nécessaire. Assurez-vous que le rattachement de service PSC est correctement configuré pour se connecter à l'instance privée et qu'il répond aux exigences d'un service publié.

    1. Configurez les paramètres réseau en procédant comme suit :

      1. Placez le rattachement de service PSC et l'équilibreur de charge dans des sous-réseaux différents du même réseau cloud privé virtuel.

      2. Pour des raisons de sécurité, le système backend doit rester fermé au réseau public. Toutefois, assurez-vous qu'il peut accepter le trafic provenant des sources suivantes:

    2. Ajustez les règles de pare-feu:

      1. Règles d'Ingress:

        • Autorisez le trafic du sous-réseau d'association du service PSC vers le sous-réseau de l'équilibreur de charge interne (ILB).
        • Assurez-vous que l'ILB peut envoyer du trafic au backend.
        • Autorisez les vérifications d'état à atteindre le backend.

      2. Règles de sortie: activez le trafic sortant par défaut, sauf si des règles de refus spécifiques s'appliquent.

  7. Remarques supplémentaires: Veillez à placer tous les composants, y compris le rattachement de service PSC et l'équilibreur de charge, dans la même région.

Générer un rattachement de service

Pour générer une pièce jointe de service, procédez comme suit:

  1. Choisir le type de point de terminaison: sélectionnez un point de terminaison public ou privé.

  2. Pour les points de terminaison publics: si le type de destination de Jira Data Center est public, vous n'avez pas besoin de créer la configuration pour le rattachement de service. Vous pouvez utiliser votre URL publique dans le champ URL du domaine de la console Google Cloud.

  3. Pour le point de terminaison privé:

    1. Utilisez PSC pour activer les connexions à partir d'instances privées vers Google Cloud.

    2. Créez un réseau cloud privé virtuel et les sous-réseaux requis.

    3. Créez une instance de machine virtuelle (VM) et installez le service de backend.

    4. Facultatif: configurez une sonde de vérification d'état pour surveiller l'état du backend.

    5. Ajoutez un équilibreur de charge pour acheminer le trafic vers la VM ou le backend.

    6. Définissez des règles de pare-feu pour autoriser le trafic entre le point de terminaison PSC et le backend.

    7. Publiez le point de terminaison en créant un rattachement de service PSC.

Créer un utilisateur Jira Data Center et configurer des autorisations

Pour permettre à Vertex AI Search d'obtenir des données à partir de Jira, vous devez créer un utilisateur disposant des autorisations minimales nécessaires. Suivez ces étapes pour créer l'utilisateur et configurer les autorisations requises.

  1. Connectez-vous en tant qu'administrateur:

    1. Accédez au site de votre domaine Atlassian et ouvrez l'instance Jira Data Center.
    2. Saisissez le nom et le mot de passe de l'administrateur.
    3. Cliquez sur Connexion.

  2. Créez un utilisateur:

    Lorsque vous créez un data store, vous devez créer un utilisateur pour obtenir des données à partir de l'instance tierce.

    1. Cliquez sur l'icône des paramètres.
    2. Sélectionnez Gestion des utilisateurs.
    3. Saisissez les identifiants administrateur si vous y êtes invité.
    4. Sur la page Administration, cliquez sur Créer un utilisateur.
    5. Saisissez l'adresse e-mail, le nom complet, le nom d'utilisateur et le mot de passe.
    6. Cliquez sur Créer un utilisateur.

  3. Attribuer un utilisateur à un groupe:

    1. Sur la page Administration, sous Gestion des utilisateurs, cliquez sur Groupes.
    2. Créez un groupe en saisissant un nom, puis cliquez sur Ajouter un groupe.
    3. Sélectionnez le groupe nouvellement créé.
    4. Cliquez sur Ajouter/Supprimer des utilisateurs.
    5. Cliquez sur l'icône de membre à côté de la zone Ajouter des membres aux groupes sélectionnés.
    6. Sélectionnez l'utilisateur que vous venez de créer, puis cliquez sur Enregistrer la sélection.
    7. Cliquez sur Ajouter l'utilisateur sélectionné pour afficher les nouveaux utilisateurs dans la section "Membres du groupe".

    Vous pouvez voir que l'utilisateur ajouté est attribué dans la section Membres du groupe.

  4. Configurez les autorisations des utilisateurs:

    1. Sur la page Administration, accédez à l'onglet Problèmes.
    2. Sélectionnez Schémas d'autorisations.
    3. Cliquez sur Ajouter un schéma d'autorisations.
    4. Attribuez un nom au schéma, puis cliquez sur Ajouter.
    5. Sélectionnez le schéma, puis cliquez sur l'icône Autorisation.
    6. Cliquez sur Accorder l'autorisation.
    7. Ajoutez les autorisations suivantes, attribuez-les au groupe créé précédemment, puis cliquez sur Accorder :
      1. Parcourir les projets
      2. Parcourir l'archive des projets
    8. Ajoutez ce schéma aux projets pour lesquels les utilisateurs du groupe doivent avoir accès afin de pouvoir afficher le projet, les problèmes, les commentaires, les journaux de travail et les pièces jointes.

Configurer l'accès des applications

  1. Sur la page Administration, accédez à l'onglet Applications.
  2. Dans l'onglet Applications, sélectionnez Accès des applications.
  3. Recherchez le groupe créé, puis sélectionnez-le.
  4. Vérifiez que le groupe apparaît dans la liste d'accès.

L'utilisateur est créé avec un accès minimal. Ce schéma est ajouté aux projets. L'administrateur Jira peut ajouter d'autres membres à ce groupe ou des utilisateurs à ce projet.

Créer un connecteur sur site Jira Data Center

Console

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Centre de données Jira pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification, puis cliquez sur Continuer.

  6. Dans la liste déroulante Type de destination, sélectionnez Public ou Privé.

    1. Pour le type de destination Public, vous n'avez pas besoin de créer la configuration pour le rattachement de service. Vous pouvez utiliser votre URL publique dans le champ "URL du domaine" de la console Google Cloud.

    2. Pour le type de destination Privé, saisissez toutes les informations requises:

      1. Par exemple, avec l'URL du domaine :
        • Rattachement de service: saisissez votre rattachement de service.
        • (Facultatif) Nom de domaine de base : saisissez votre domaine de base.
        • URL du domaine: saisissez l'URL de votre domaine.
        • Facultatif: Port de destination: saisissez le port de destination.
      2. Par exemple, sans URL de domaine :
        • Rattachement de service: saisissez votre rattachement de service.
        • Facultatif: Port de destination: saisissez le port de destination.

  7. Cliquez sur Continuer.

  8. Facultatif: Options avancées: sélectionnez et activez les paramètres de proxy et les paramètres SSL, si nécessaire.

  9. Sous Entités à synchroniser, sélectionnez toutes les entités requises à synchroniser, puis cliquez sur Continuer.

  10. Sélectionnez une région pour votre connecteur de données, puis saisissez un nom pour celui-ci.

  11. Sélectionnez une fréquence de synchronisation.

Pour le type de destination Privé, une fois que vous avez envoyé les informations du connecteur, VAIS envoie une demande de connexion à votre PSC. Accédez à votre connecteur pour voir un message vous invitant à ajouter un projectId à la liste d'autorisation dans le PSC. Le connecteur reste à l'état Error (Erreur) jusqu'à ce que vous autorisiez la connexion dans PSC. Lorsque vous acceptez la demande de connexion, le connecteur passe à l'état Actif lors de la prochaine exécution de la synchronisation. Si vous configurez votre PSC pour qu'il accepte toutes les connexions, le connecteur passe automatiquement à l'état Active (Actif) après sa création.

Pour le type de destination Public, le connecteur passe automatiquement à l'état Actif après l'envoi. Pour vérifier l'état du data store et de l'activité d'ingestion, procédez comme suit:

  1. Accédez au connecteur dans la liste des data store et surveillez son état jusqu'à ce qu'il passe à Active (Actif).
  2. Une fois que l'état du connecteur est défini sur Actif, cliquez sur l'entité requise et vérifiez que toutes les entités sélectionnées sont ingérées. L'état du data store passe de Création à En cours d'exécution au début de la synchronisation, puis à Actif une fois l'ingestion terminée, ce qui indique que le data store est configuré. Selon la taille de vos données, l'ingestion peut prendre plusieurs heures.

Étapes suivantes

Connecter Microsoft Outlook

Suivez la procédure ci-dessous pour synchroniser les données de Microsoft Outlook avec la recherche Vertex AI.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connexion:

  1. En plus de la liste d'autorisation du connecteur tiers, ce connecteur nécessite que votre projet soit ajouté à une liste d'autorisation supplémentaire. Pour être ajouté à cette liste d'autorisation, contactez l'équipe chargée de votre compte Vertex AI Search.

  2. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

  3. Un administrateur Microsoft Outlook doit générer ou obtenir les éléments suivants pour l'intégration à Vertex AI Search:

    • ID client
    • Code secret du client
    • ID du locataire

Créer un connecteur Microsoft Outlook

Console

Pour synchroniser les données de Microsoft Outlook avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionnez une source de données, faites défiler la page ou recherchez Microsoft Outlook pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification Microsoft Outlook, puis cliquez sur Continuer.

  6. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  7. Sélectionnez une région pour votre data store.

  8. Attribuez un nom à votre connecteur de données.

  9. Sélectionnez une fréquence de synchronisation.

  10. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  11. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre connecteur pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.

Étapes suivantes

Connecter Microsoft Teams

Suivez la procédure ci-dessous pour synchroniser les données de Microsoft Teams avec la recherche Vertex AI.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connexion:

  1. En plus de la liste d'autorisation du connecteur tiers, ce connecteur nécessite que votre projet soit ajouté à une liste d'autorisation supplémentaire. Pour être ajouté à cette liste d'autorisation, contactez l'équipe chargée de votre compte Vertex AI Search.

  2. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

  3. Un administrateur Microsoft Teams doit générer ou obtenir les éléments suivants pour l'intégration à Vertex AI Search:

    • ID client
    • Code secret du client
    • ID du locataire

Créer un connecteur Microsoft Teams

Console

Pour synchroniser les données de Microsoft Teams avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Microsoft Teams pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification Microsoft Teams, puis cliquez sur Continuer.

  6. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  7. Sélectionnez une région pour votre data store.

  8. Attribuez un nom à votre connecteur de données.

  9. Sélectionnez une fréquence de synchronisation.

  10. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  11. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre connecteur pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.

Étapes suivantes

Connecter Notion

Suivez la procédure ci-dessous pour synchroniser les données de Notion avec la recherche Vertex AI.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connecteur:

  1. En plus de la liste d'autorisation du connecteur tiers, ce connecteur nécessite que votre projet soit ajouté à une liste d'autorisation supplémentaire. Pour être ajouté à cette liste d'autorisation, contactez l'équipe chargée de votre compte Vertex AI Search.

  2. Un administrateur Notion doit générer ou obtenir les éléments suivants pour l'intégration à Vertex AI Search:

    • Jeton d'API de l'instance Notion
    • ID de l'espace de travail

  3. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

Créer un connecteur Notion

Console

Pour synchroniser les données de Notion avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Notion pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification Notion, puis cliquez sur Continuer.

  6. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  7. Sélectionnez une région pour votre data store.

  8. Attribuez un nom à votre connecteur de données.

  9. Sélectionnez une fréquence de synchronisation.

  10. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  11. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre connecteur pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.

Étapes suivantes

Connecter OneDrive

Suivez la procédure ci-dessous pour synchroniser les données de OneDrive avec la recherche Vertex AI.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connexion:

  1. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

  2. Préparez les informations d'authentification OneDrive suivantes:

    1. ID client, code secret du client et ID de locataire. Pour en savoir plus sur la configuration de ces paramètres, consultez la section Guide de démarrage rapide: enregistrer une application avec la plate-forme Microsoft Identity dans la documentation Microsoft.

    2. Spécifiez des niveaux d'accès. Un rôle administrateur est requis. Pour en savoir plus, consultez la section Démarrage rapide: configurer une application cliente pour accéder à une API Web dans la documentation Microsoft.

    3. Configurez les champs d'application de l'accès suivants:

Créer un connecteur OneDrive

Console

Pour synchroniser les données de OneDrive avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez OneDrive pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification OneDrive.

  6. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  7. Sélectionnez une région pour votre data store.

  8. Attribuez un nom à votre datastore.

  9. Sélectionnez une fréquence de synchronisation pour votre data store.

  10. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  11. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre data store pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre des minutes ou des heures.

Étapes suivantes

Connecter Salesforce

Suivez la procédure ci-dessous pour synchroniser les données de Salesforce avec Vertex AI Search.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connexion:

  1. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

  2. Préparez les informations d'authentification suivantes. Pour savoir comment configurer l'ID client et le code secret du client dans Salesforce, consultez Configurer une application connectée pour le flux d'identifiants client OAuth 2.0 dans la documentation Salesforce.

    • URL d'instance
    • Numéro client
    • Clé secrète du site consommateur

Les limites suivantes s'appliquent :

  1. Utilisez un forfait Enterprise ou Developer. Les comptes d'essai ne sont pas acceptés.
  2. Assurez-vous d'utiliser Sales Cloud. Service Cloud n'est pas compatible.
  3. Ajoutez Google Cloud à la liste d'autorisation CORS de Salesforce. Passez à l'étape suivante si vous avez déjà effectué cette tâche.
    1. Suivez les instructions de la documentation Salesforce pour configurer la liste d'autorisation CORS.
    2. Saisissez https://console.cloud.google.com/ comme URL d'origine, puis enregistrez votre configuration.

Créer un connecteur Salesforce

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de Salesforce avec Vertex AI Search, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Salesforce pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification Salesforce.

  6. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  7. Sélectionnez une région pour votre data store.

  8. Attribuez un nom à votre datastore.

  9. Sélectionnez une fréquence de synchronisation.

  10. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  11. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre data store pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre des minutes ou des heures.

Étapes suivantes

Connecter ServiceNow

Suivez la procédure ci-dessous pour synchroniser les données de ServiceNow avec la recherche Vertex AI.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connexion, assurez-vous de disposer des éléments suivants:

  1. Instance ServiceNow: créez une instance ServiceNow en suivant les instructions de la documentation ServiceNow Developer.

  2. ProjetGoogle Cloud : configurez un projet Google Cloud avec un compte administrateur capable de gérer les configurations au niveau de l'organisation, afin que l'organisation puisse configurer un pool de travailleurs.

  3. Pool d'employés: assurez-vous que votre organisation est configurée pour gérer un pool d'employés.

Configurer ServiceNow

ServiceNow propose deux sites principaux:

  1. Site ServiceNow principal: site de votre instance ServiceNow.

    • Gère les utilisateurs, les groupes et les tâches d'administration système.
    • URL: URL de votre instance ServiceNow.
    • Connectez-vous à l'aide de vos identifiants administrateur.

  2. Site pour les développeurs:

    • Configure la base de connaissances, configure les workflows et développe des applications personnalisées.
    • URL: https://developer.service-now.com.
    • Connectez-vous avec votre ID ServiceNow.

Pour créer un point de terminaison OAuth, procédez comme suit:

  1. Connectez-vous à l'instance ServiceNow principale avec des droits d'administrateur.
  2. Accédez à Tout > OAuth système > Registre des applications.
  3. Cliquez sur Nouveau, puis sélectionnez Créer un point de terminaison d'API OAuth pour les clients externes. Récupérer l'ID client et le code secret du client

  4. Renseignez les informations requises:

    1. Nom: nom unique.
    2. URL de redirection: https://vertexaisearch.cloud.google.com/console/oauth/servicenow_oauth.html.

  5. Cliquez sur Envoyer pour créer les identifiants.

  6. Après l'envoi, cliquez sur le nom pour afficher le code secret du client.

  7. Le secret est masqué. Cliquez sur l'icône en forme de cadenas à côté du secret pour le démasquer et l'afficher.

  8. Conservez une copie de l'ID client et du secret à utiliser si nécessaire.

  9. Accédez à developer.service-now.com, puis cliquez sur Gérer le mot de passe de l'instance.

  10. Conservez une copie du nom d'utilisateur et du mot de passe pour les utiliser si nécessaire.

  11. À ce stade, vous disposez des cinq informations nécessaires pour configurer un data store ServiceNow. Si vous n'avez aucun problème à utiliser le rôle Administrateur pour extraire des données, créez un data store.

Configurer les rôles et les autorisations

Vous devez disposer du rôle Administrateur de la sécurité pour créer et gérer des utilisateurs. Si vous ne disposez pas de ce rôle, accédez au rôle security_admin en cliquant sur Élever le rôle sous votre profil. Sélectionnez le rôle security_admin, puis cliquez sur Mettre à jour. Le rôle security_admin est requis pour créer des rôles et gérer des utilisateurs.

  1. Créez un rôle personnalisé avec des règles ACL:

    1. Accédez à Tout > Administration des utilisateurs > Rôles.
    2. Cliquez sur Nouveau pour créer un rôle.
    3. Sélectionnez un nom, puis cliquez sur Envoyer.
    4. Accédez à Sécurité du système > Contrôle d'accès (LCA) pour créer une règle LCA.
    5. Cliquez sur Nouveau pour créer une règle ACL.
    6. Sélectionnez un rôle, par exemple sys_user_role.
    7. Cliquez sur Envoyer et attribuez le rôle.

    8. Répétez ce processus jusqu'à ce que tous les accès à la table soient accordés. Le connecteur a besoin d'accéder aux tables suivantes pour que chaque entité puisse s'exécuter correctement:

      1. Incident: incident.
      2. Élément de catalogue: sc_cat_item, sc_cat_item_user_criteria_mtom, sc_cat_item_user_criteria_no_mtom, sc_cat_item_user_mtom, sc_cat_item_user_no_mtom.
      3. Connaissances: kb_knowledge, kb_knowledge_base, kb_uc_can_read_mtom, kb_uc_can_contribute_mtom.
      4. Pièce jointe: tous les éléments listés.
      5. Identité: sys_user_role, sys_user_has_role, sys_user_group, sys_user_grmember, sys_user.
      6. Mise à jour à mesure que de nouveaux critères sont extraits: core_company, cmn_location, cmn_department.
      7. Critères utilisateur: user_criteria.

    9. Vérifiez que toutes les LCA sont mises à jour en accédant à sys_security_acl_role_list.do dans la barre de recherche.

    10. Sélectionnez le rôle à valider.

    11. Vérifiez que toutes les ACL requises sont attribuées au rôle sélectionné.

  2. Attribuez le rôle à un compte de service:

    1. Accédez à Tout > Gestion des utilisateurs > Utilisateurs, puis sélectionnez l'utilisateur.
    2. Recherchez l'utilisateur auquel attribuer le rôle, puis sélectionnez-le.

  3. Si aucun utilisateur n'est disponible, accédez à Sécurité du système > Utilisateurs et groupes > Utilisateurs.

  4. Cliquez sur New (Nouveau) pour créer un compte de service dans la table User (Utilisateur).

  5. Veillez à cocher la case Accès au service Web uniquement.

  6. Accédez au tableau Rôles en bas de la page.

  7. Cliquez sur Modifier à droite.

  8. Accordez le rôle créé précédemment et attribuez-le à l'utilisateur. Selon le type de rôle créé, sélectionnez celui qui convient et attribuez-le.

  9. Obtenez le nom d'utilisateur et le mot de passe de l'utilisateur. Sur la même page, cliquez sur Définir un mot de passe.

  10. Générez automatiquement un mot de passe et enregistrez-le pour une utilisation ultérieure:

    1. ID utilisateur: manager.
    2. Mot de passe: saisissez le mot de passe généré automatiquement.

Configurer le pool de personnel

Suivez les instructions pour configurer un pool de personnel avec l'une des configurations suivantes:

  1. Configuration OIDC Azure
  2. Configuration SAML Azure
  3. Configuration d'Okta et d'OIDC
  4. Configuration d'Okta et de SAML

Créer un connecteur ServiceNow

Console

Pour synchroniser les données de ServiceNow avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez ServiceNow pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification ServiceNow.

  6. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  7. Sélectionnez une région pour votre connecteur de données.

  8. Attribuez un nom à votre connecteur de données.

  9. Sélectionnez une fréquence de synchronisation.

  10. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  11. Pour vérifier l'état de l'ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre connecteur de données pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre plusieurs minutes ou plusieurs heures.

Étapes suivantes

Connecter SharePoint Online

Suivez la procédure ci-dessous pour synchroniser les données de SharePoint Online avec la recherche Vertex AI.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connexion:

  1. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

  2. Accordez le consentement administrateur. Pour savoir comment accorder un consentement, consultez la section Accorder un consentement administrateur au niveau du locataire pour une application dans la documentation Microsoft Entra.

  3. Préparez les informations d'authentification SharePoint Online suivantes à utiliser lors de la configuration:

    1. URL de l'instance. Au format http://DOMAIN_OR_SERVER/[sites/]WEBSITE.

    2. L'authentification fédérée nécessite l'ID de locataire et l'ID client, tandis que l'authentification OAuth nécessite l'ID de locataire, l'ID client et le secret client. Pour enregistrer l'application, sélectionnez Comptes dans cet annuaire organisationnel uniquement pour l'audience de connexion, puis recherchez ces informations d'authentification. Pour en savoir plus, consultez Démarrage rapide: enregistrer une application auprès de la plate-forme d'identité Microsoft dans la documentation Microsoft Entra.

    3. Lorsque vous enregistrez l'application, utilisez https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html comme URL de rappel Web.

    4. Lorsque vous configurez les autorisations d'application, ajoutez les autorisations d'application suivantes pour l'API Graph:

    5. Lorsque vous configurez les autorisations de l'application, ajoutez les autorisations déléguées suivantes pour l'API REST Sharepoint:

  4. Le tableau suivant décrit les rôles recommandés pour la configuration et leurs limites.

Utilisez cette méthode pour contrôler précisément les autorisations de l'API REST SharePoint, ce qui vous permet de restreindre l'accès aux ressources sur le compte utilisateur. Veillez à créer un utilisateur SharePoint, ce qui peut entraîner des coûts de licence. Utilisez la méthode du jeton d'actualisation OAuth 2.0 pour configurer l'enregistrement d'une application Entra et activer un accès sécurisé à SharePoint.

Configurer l'enregistrement de l'application Entra

Configurez l'enregistrement d'une application Entra pour permettre un accès sécurisé à SharePoint. Choisissez entre les identifiants fédérés pour un accès basé sur des jetons ou les jetons d'actualisation OAuth 2.0 pour un contrôle précis. Pour configurer l'enregistrement de l'application, accorder des autorisations et établir une authentification, procédez comme suit :

  1. Identifiants fédérés: configurez des identifiants fédérés pour autoriser Google à accéder de manière sécurisée à SharePoint à l'aide de jetons signés de manière cryptographique, ce qui évite d'avoir à utiliser un principal utilisateur réel. Pour configurer les autorisations et accorder l'accès, procédez comme suit:

    1. Obtenez l'ID client du compte de service:

      1. Dans la console Google Cloud, accédez à la page Agent Builder.
      2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).
      3. Cliquez sur Créer un datastore.
      4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez SharePoint Online pour connecter votre source tierce.
      5. Notez l'identifiant de l'objet.

    2. Enregistrez l'application dans Microsoft Entra:

      1. Accédez au Centre d'administration Entra.

      2. Créez un enregistrement d'application:

        • Types de comptes compatibles: Comptes de l'annuaire organisationnel uniquement.
        • Conservez les autres paramètres par défaut, puis cliquez sur Enregistrer.

      3. Notez l'ID client et l'ID de locataire.

    3. Ajoutez des identifiants fédérés:

      1. Accédez à Certificats et secrets > Identifiants fédérés > Ajouter des identifiants.

      2. Utilisez les paramètres suivants :

        • Émetteur: https://accounts.google.com
        • Identifiant de l'objet: utilisez l'identifiant de l'objet indiqué.
        • Nom: indiquez un nom unique.

      3. Cliquez sur Ajouter pour accorder l'accès.

    4. Définissez les autorisations d'API:

      1. Ajoutez et accordez l'autorisation de l'administrateur pour les autorisations suivantes:

        • GroupMember.Read.All (Application): permet de lire toutes les adhésions aux groupes.
        • Sites.Read.All (Application): lit tous les sites.
        • User.Read.All (Application): permet de lire les profils complets de tous les utilisateurs.
        • Sites.FullControl.All (Application): contrôle total sur tous les sites.

      2. Utilisez Sites.Selected pour attribuer des autorisations de site spécifiques au lieu de Sites.FullControl.All. Sites.Selected ne peut pas être configuré directement via l'UI. Après avoir sélectionné Sites.Selected, vous devez appeler l'API Microsoft Graph pour accorder explicitement le rôle fullcontrol à l'application pour les sites que vous souhaitez explorer.

      3. Accordez Sites.Read.All pour explorer tous les sous-sites sous une URL de site racine.

  2. Jeton d'actualisation OAuth 2.0: configurez l'authentification OAuth 2.0 à l'aide d'un code secret du client et d'un jeton d'actualisation de l'utilisateur SharePoint pour contrôler de manière précise l'accès à l'API SharePoint. Pour configurer l'enregistrement d'application, ajouter un code secret du client et attribuer des autorisations d'API, procédez comme suit:

    1. Créez l'enregistrement de l'application:

      1. Accédez au Centre d'administration Entra.

      2. Créez un enregistrement d'application:

        • Types de comptes compatibles: Comptes de l'annuaire organisationnel uniquement.
        • URI de redirection: https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html.

      3. Notez l'ID client et l'ID de locataire.

    2. Ajoutez un code secret du client:

      1. Accédez à Certificats et secrets > Nouveau code secret client.

      2. Notez la chaîne secrète.

    3. Définissez les autorisations d'API:

      1. Ajoutez et accordez l'autorisation de l'administrateur pour les autorisations suivantes:

        • GroupMember.Read.All: lire toutes les adhésions à des groupes.
        • Sites.FullControl.All: contrôle total de toutes les collections de sites.
        • User.Read.All: lire les profils complets de tous les utilisateurs.
        • AllSites.FullControl: contrôle total sur tous les sites.

      2. Utilisez un compte utilisateur dédié avec un accès limité à des sites spécifiques.

      3. Assurez-vous que le compte dispose des droits Propriétaire sur les sites sélectionnés.

Créer un connecteur SharePoint Online

Console

Pour synchroniser les données de SharePoint Online avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez SharePoint Online pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification SharePoint Online, puis cliquez sur Authentifier.

  6. Saisissez l'URL du site SharePoint:

    • Pour un seul site: https://<domain_name>.sharepoint.com/sites/<site_name>.
    • Pour tous les sites de premier niveau: https://<domain_name>.sharepoint.com.

  7. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  8. Sélectionnez une région pour votre data store.

  9. Attribuez un nom à votre datastore.

  10. Sélectionnez une fréquence de synchronisation pour votre data store.

  11. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  12. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre data store pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre des minutes ou des heures.

Tester le moteur de recherche

Après avoir configuré votre moteur de recherche, testez ses fonctionnalités. Cela garantit que les résultats sont précis en fonction de l'accès des utilisateurs.

  1. Activez l'application Web:

    1. Accédez aux configurations d'intégration d'applications, puis activez l'option Activer l'application Web.

  2. Tester l'application Web:

    1. Cliquez sur Ouvrir à côté du lien de l'application Web, puis connectez-vous avec un utilisateur de votre pool de travailleurs.

    2. Vérifiez que les résultats de recherche sont limités aux éléments accessibles par l'utilisateur connecté.

Configurer le pool de personnel

Le pool d'employés vous permet de gérer et d'authentifier les utilisateurs de fournisseurs d'identité externes, tels qu'Azure ou Okta, dans la console Google Cloud. Pour configurer votre pool de personnel et activer l'application Web afin d'offrir un accès fluide aux utilisateurs, procédez comme suit:

  1. Créez un pool de travailleurs au niveau de l'organisation dans Google Cloud en suivant le manuel de configuration approprié:

    1. Configuration OIDC Azure
    2. Configuration SAML Azure
    3. Configuration d'Okta et d'OIDC
    4. Configuration d'Okta et de SAML

  2. Configurez le pool d'employés dans Agent Builder > Settings (Outils de création d'agents > Paramètres) pour la région dans laquelle vous créez votre application.

Étapes suivantes

Connecter Slack

Suivez la procédure ci-dessous pour synchroniser les données de Slack avec la recherche Vertex AI.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connexion:

  1. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez Utiliser le contrôle des accès des sources de données.

  2. Contactez le propriétaire de l'espace de travail pour obtenir les autorisations nécessaires à l'installation de nouvelles applications dans votre espace de travail.

  3. Préparez les informations d'authentification Slack suivantes:

    1. ID de l'espace de travail: obtenez l'ID de l'espace de travail en suivant les instructions de la section Spécifier la source Slack de votre data store de la documentation Slack.

    2. Jeton d'accès: créez une application cliente et définissez les champs d'application requis. Pour en savoir plus, consultez les pages Démarrage rapide et Obtenir et utiliser rapidement un jeton d'API Slack dans la documentation Slack.

    3. Lorsque vous définissez des champs d'application d'autorisation OAuth 2.0, configurez les champs d'application suivants:

  4. Par défaut, Slack limite l'exploration et la synchronisation du contenu des canaux privés, des messages de groupe et des messages privés.

Configurer l'application Slack

Obtenez un jeton d'accès pour autoriser Vertex AI Search à ingérer des documents depuis votre espace de travail Slack.

  1. Générez un jeton de bot pour accéder de manière sécurisée aux canaux privés, aux messages instantanés (MI) et aux messages instantanés multiparties (MPIM). Le jeton de robot ne peut pas explorer les canaux publics dont il ne fait pas partie, et rejoindre des canaux publics génère un message de participation.

    1. Connectez-vous à Applications de l'API Slack.
    2. Cliquez sur Créer une application.
    3. Sélectionnez À partir de zéro.
    4. Attribuez un nom à votre application et sélectionnez l'espace de travail à intégrer.
    5. Cliquez sur Créer l'application.
    6. Cliquez sur OAuth et autorisations.
    7. Sous Champs d'application des jetons de bot, ajoutez les champs d'application obligatoires suivants :

    Par défaut, le bot lit les canaux #general et #random.

    1. Pour activer l'exploration, procédez comme suit:

      1. Pour les canaux publics, accordez l'étendue channels:join pour autoriser le robot à rejoindre automatiquement le canal.
      2. Pour les canaux privés, invitez le bot manuellement.

    2. Cliquez sur Installer dans l'espace de travail associé à votre nom d'utilisateur.

    3. Suivez les instructions à l'écran pour installer l'application et récupérer le jeton du robot.

  2. Générez un jeton utilisateur pour accéder à tous les canaux publics sans les rejoindre au préalable. Le jeton utilisateur ne peut pas explorer les canaux privés, les messages privés ou les messages privés multi-utilisateurs, sauf si l'utilisateur y a accès.

    1. Connectez-vous à Applications de l'API Slack.
    2. Cliquez sur Créer une application.
    3. Sélectionnez À partir de zéro.
    4. Attribuez un nom à votre application et sélectionnez l'espace de travail à intégrer.
    5. Cliquez sur Créer l'application.
    6. Cliquez sur OAuth et autorisations.

    7. Sous Champ d'application des jetons utilisateur, ajoutez les champs d'application obligatoires suivants:

    8. Cliquez sur Installer dans l'espace de travail associé à votre nom d'utilisateur.

    9. Suivez les instructions à l'écran pour installer l'application et récupérer le jeton utilisateur.

Créer un connecteur Slack Cloud

Console

Pour synchroniser les données de Slack avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Slack pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification Slack.

    • ID d'instance (ID de l'espace de travail): obtenez-le dans votre espace de travail Slack en vous connectant via un navigateur. L'ID de l'espace de travail correspond au segment situé après /client dans l'URL.
    • Jeton d'authentification: utilisez le jeton obtenu dans la section précédente.

  6. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  7. Sélectionnez une région pour votre data store.

  8. Attribuez un nom à votre datastore.

  9. Sélectionnez une fréquence de synchronisation pour votre data store.

  10. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  11. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre data store pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre des minutes ou des heures.

Étapes suivantes

Associer Trello

Suivez la procédure ci-dessous pour synchroniser les données de Trello avec la recherche Vertex AI.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connecteur, assurez-vous d'avoir effectué les étapes suivantes:

  1. Vérifiez que vous disposez d'un accès administrateur Trello. Un administrateur Trello doit générer une clé API et un jeton dans la section suivante.
  2. Vérifiez que votre projet est ajouté à la liste d'autorisation pour utiliser Trello.
  3. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

Générer une clé et un jeton API dans Trello

Un administrateur Trello doit suivre les étapes suivantes:

  1. Créez un module complémentaire Trello pour générer une clé API.
  2. Accédez à la page d'administration de Trello.
  3. Accédez à l'onglet "Clé API", puis sélectionnez l'option permettant de générer une clé API.
  4. Cliquez sur Jeton.
  5. Cliquez sur Autoriser.
  6. Copiez le jeton.

Pour en savoir plus sur l'API Trello, consultez la section Présentation de l'API.

Créer un connecteur Trello

Console

Pour synchroniser les données de Trello avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Trello pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification Trello, puis cliquez sur Continuer.

  6. Facultatif: Pour acheminer le trafic HTTP, cliquez sur Ajouter une destination, puis saisissez le nom d'hôte ou l'adresse IP du serveur proxy. Cliquez ensuite sur Continuer.

  7. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  8. Sélectionnez une région pour votre data store.

  9. Attribuez un nom à votre connecteur de données.

  10. Sélectionnez une fréquence de synchronisation.

  11. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  12. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre connecteur pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.

Étapes suivantes

Connect Workday

Suivez la procédure ci-dessous pour synchroniser les données de Workday avec Vertex AI Search.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de créer un connecteur Workday:

  1. En plus de la liste d'autorisation du connecteur tiers, ce connecteur nécessite que votre projet soit ajouté à une liste d'autorisation supplémentaire. Pour être ajouté à cette liste d'autorisation, contactez l'équipe chargée de votre compte Vertex AI Search.

  2. Un administrateur Workday doit générer ou obtenir les éléments suivants pour l'intégration à Vertex AI Search:

    1. ID client. Vous pouvez l'obtenir sur la page "Afficher les clients de l'API" dans Workday.
    2. Code secret du client. Vous pouvez l'obtenir sur la page "Afficher les clients de l'API" dans Workday.
    3. Jeton d'actualisation. Vous pouvez l'obtenir sur la page "Afficher les clients de l'API" dans Workday.
    4. Facultatif: Serveur proxy. Nom d'hôte ou adresse IP d'un proxy pour acheminer le trafic HTTP.
    5. Facultatif: URL de base. URL de base de la connexion Workday.
    6. Facultatif: URL de l'API. URL complète du point de terminaison de l'API à utiliser pour effectuer des requêtes SOAP. Par exemple : https://<var>host</var>.workday.com/ccx/service/<var>tenant</var>/<var>service</var>
    7. Compte locataire Workday Locataire du compte. Par exemple, abc_cms1. Vous pouvez obtenir le nom du locataire dans les détails de configuration de votre instance Workday.

  3. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

Créer un connecteur Workday

Console

Pour synchroniser les données de Workday avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Workday pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification Workday, puis cliquez sur Continuer.

  6. Facultatif: Saisissez les informations de destination Workday, puis cliquez sur Continuer.

  7. Saisissez votre locataire Workday, puis cliquez sur Continuer.

  8. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  9. Sélectionnez une région pour votre data store.

  10. Attribuez un nom à votre connecteur de données.

  11. Sélectionnez une fréquence de synchronisation.

  12. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  13. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre connecteur pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.

Étapes suivantes

Connecter Zendesk

Suivez la procédure ci-dessous pour synchroniser les données de Zendesk avec la recherche Vertex AI.

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

Avant de configurer votre connexion:

  1. En plus de la liste d'autorisation du connecteur tiers, ce connecteur nécessite que votre projet soit ajouté à une liste d'autorisation supplémentaire. Pour être ajouté à cette liste d'autorisation, contactez l'équipe chargée de votre compte Vertex AI Search.

  2. Configurez le contrôle des accès pour votre source de données. Pour en savoir plus sur la configuration du contrôle des accès, consultez la page Utiliser le contrôle des accès des sources de données.

  3. Un administrateur Zendesk doit générer ou obtenir les éléments suivants pour l'intégration à Vertex AI Search:

    1. Jeton d'accès. Jeton d'API de votre instance Zendesk.
    2. URI de l'instance.

Créer un connecteur Zendesk

Console

Pour synchroniser les données de Zendesk avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

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

    Agent Builder

  2. Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).

  3. Cliquez sur Créer un datastore.

  4. Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Zendesk pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification Zendesk, puis cliquez sur Continuer.

  6. Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.

  7. Sélectionnez une région pour votre data store.

  8. Attribuez un nom à votre connecteur de données.

  9. Sélectionnez une fréquence de synchronisation.

  10. Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Data stores).

  11. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores) et cliquez sur le nom de votre connecteur pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.

Étapes suivantes