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 magasin de données 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 magasin de données 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

Connecter Asana

Suivez la procédure ci-dessous pour synchroniser les données d'Asana 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 datastore 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:

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

  • Un administrateur Asana doit générer ou obtenir le jeton d'accès personnel (PAT) suivant pour l'authentification. Pour en savoir plus, consultez la section Jeton d'accès personnel dans la documentation Asana.

Pour inviter un membre à un espace de travail Asana, procédez comme suit:

  1. Connectez-vous à l'application Asana avec votre compte administrateur.

  2. Cliquez sur l'icône de profil, puis sélectionnez Console d'administration.

  3. Cliquez sur Inviter un membre. Saisissez l'adresse e-mail de l'utilisateur et le projet que vous souhaitez ajouter.

  4. Cliquez sur Envoyer. L'utilisateur accepte l'invitation pour s'assurer qu'il est ajouté au projet.

Pour générer un PAT, procédez comme suit:

  1. Ouvrez la console de développement Asana.

  2. Cliquez sur Mes applications.

  3. Cliquez sur Créer un jeton.

  4. Dans la boîte de dialogue Créer un jeton, renseignez les informations requises.

  5. Cliquez sur Créer un jeton.

  6. Copiez le jeton pour une utilisation ultérieure.

  7. Cliquez sur OK.

Créer un connecteur cloud Asana

Console

Pour synchroniser les données d'Asana 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, sélectionnez Data Stores (Dépô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 Asana pour connecter votre source tierce.

  5. Saisissez les informations d'authentification, y compris le PAT généré.

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

  7. Choisissez une région pour le data store.

  8. Attribuez un nom au data store.

  9. Définissez une fréquence de synchronisation pour le 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 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 magasin de données 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. Vous devez disposer d'un accès administrateur à l'instance Box avec l'authentification à deux facteurs activée. Toutes les instructions de configuration ne peuvent être effectuées que depuis le compte administrateur.

  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. Consultez la section Configuration avec JWT dans la documentation Box pour obtenir une présentation de la configuration avec des captures d'écran.

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 de plate-forme.
  3. Sélectionnez Type d'application en choisissant Application personnalisée.
  4. Saisissez le nom de l'application.
  5. Définissez les propriétés suivantes :
    1. Objectif:intégration
    2. Catégories:IA
    3. Système externe: Google Cloud Agent Builder
  6. Sélectionnez Authentication method (Méthode d'authentification) comme Server authentication (with JWT) (Authentification du serveur [avec JWT]).
  7. Cliquez sur Créer l'application.

Configurer l'application Box

  1. Dans la console de développement Box, sélectionnez l'application de plate-forme, puis accédez à l'onglet Configuration.
  2. Dans la section Niveau d'accès de l'application, sélectionnez Accès à l'application et à l'entreprise.
  3. Dans la section Champs d'application, sélectionnez les champs d'application suivants:

    1. Lire tous les fichiers et dossiers stockés dans Box
    2. Écrire tous les fichiers et dossiers stockés dans Box
    3. Gérer les utilisateurs
    4. Gérer les groupes
    5. Gérer les propriétés d'entreprise
  4. Dans la section Fonctionnalités avancées, sélectionnez Effectuer des appels d'API à l'aide de l'en-tête as-user.

  5. Dans la section Ajouter et gérer les clés publiques, cliquez sur Générer une paire de clés publique/privée.

    1. 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.
    2. Vous pouvez télécharger un fichier de configuration contenant la clé privée et la phrase de passe. Veillez à conserver ce fichier pour une utilisation ultérieure.
    3. 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.
  6. Cliquez sur Enregistrer les modifications.

Autoriser l'application Box

  1. Dans la console de développement Box, sélectionnez l'application de plate-forme, puis accédez à l'onglet Autorisation.
  2. Cliquez sur Vérifier et envoyer.
  3. Dans la boîte de dialogue Examiner l'envoi de l'autorisation de l'application, cliquez sur Envoyer.
  4. Connectez-vous au gestionnaire d'applications de la plate-forme d'administration Box avec votre compte administrateur.
  5. Sélectionnez l'application de plate-forme que vous avez configurée.
  6. Cliquez sur les trois points () dans la ligne correspondante.
  7. Sélectionnez Autoriser l'application dans la liste déroulante.
  8. Dans la boîte de dialogue Autoriser l'application, cliquez sur Autoriser pour terminer le processus d'autorisation.

Préparez les informations d'authentification Box suivantes:

  • ID de l'entreprise: vous le trouverez dans l'onglet Paramètres généraux.
  • ID client et code secret client: obtenez-les dans l'onglet Configuration sous Identifiants OAuth 2.0.
  • Clé privée, ID de clé et Phrase secrète: ces paramètres ont déjà été générés et téléchargés dans un fichier local à partir de l'onglet Configuration sous Ajouter et gérer les clés publiques lors de la configuration de l'application.

Créer un connecteur Box

Console

Pour synchroniser les données de Box 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 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 magasin de données 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 datastore 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 un code secret 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 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 des utilisateurs).
    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 au nom de ces utilisateurs pour extraire les 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 datastore 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'entrée:

        • Autorisez le trafic du sous-réseau d'association du service PSC au 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 depuis des 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 entrepôt de données, 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 contenus 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. Si votre instance dispose d'une URL de 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. Si aucune URL de domaine n'est définie pour votre instance :
        • 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 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 datastore et de l'activité d'ingestion, procédez comme suit:

  1. Accédez au connecteur dans la liste des magasins de données 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 magasin de données 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 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. 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 magasin de données 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

Associer un Entra ID

Suivez la procédure ci-dessous pour synchroniser les données d'Entra ID 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 magasin de données 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. Pour obtenir l'ID client et le code secret client, procédez comme suit:

    1. Créez une application Entra ID:

      1. Connectez-vous au centre d'administration Microsoft Entra, puis cliquez sur Application.
      2. Dans la liste déroulante Application, cliquez sur Enregistrements d'applications.
      3. Sur la page App registrations (Enregistrements d'applications), cliquez sur New registration (Nouvel enregistrement).
      4. Cliquez sur Ajouter une inscription, puis procédez comme suit :
        • Attribuez un nom à l'application.
        • Sous Types de comptes compatibles, sélectionnez Comptes dans l'annuaire organisationnel uniquement.
        • Sous URI de redirection, ajoutez un URI de redirection Web pointant vers https://login.microsoftonline.com/common/oauth2/nativeclient.
      5. Cliquez sur S'inscrire.
    2. Enregistrer les identifiants:

      Dans la fenêtre de votre application enregistrée, enregistrez les valeurs suivantes pour une utilisation ultérieure:

      1. Utilisez l'ID (client) de l'application pour définir le paramètre ID client.
      2. Utilisez l'ID d'annuaire (locataire) pour définir le paramètre Azure Tenant.
    3. Créez un code secret de client:

      1. Accédez à Certificats et codes secrets, puis créez un code secret de client:
      2. Cliquez sur Nouveau code secret client, puis indiquez la durée requise.
      3. Enregistrez le code secret client et copiez la valeur de clé pour une utilisation ultérieure.

Configurer les autorisations de l'API Entra ID

  1. Dans la fenêtre de votre application enregistrée, cliquez sur Autorisations des API.
  2. Sous Autorisations configurées, sélectionnez Microsoft Graph et configurez l'autorisation suivante:

    Si vous souhaitez ingérer profileCardAttributes, configurez les autorisations suivantes:

  3. Accordez l'autorisation de l'administrateur pour toutes les autorisations ajoutées. Le consentement d'un administrateur est requis pour utiliser des identifiants client dans le flux d'authentification.

Créer un connecteur Entra ID

Console

Pour synchroniser les données d'Entra ID 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 ID Entra pour connecter votre source tierce.

  5. Sous Paramètres d'authentification, saisissez l'ID client et le code secret client.

  6. Ignorez l'option Destinations, puis cliquez sur Continuer.

  7. Sous Options avancées, saisissez l'ID du locataire Azure.

  8. Cliquez sur Continuer.

  9. Sous Entités à synchroniser, sélectionnez Profils utilisateur.

  10. Cliquez sur Continuer.

  11. Dans Configurer votre connecteur de données, sélectionnez une région pour votre data store.

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

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

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

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

  16. Lorsque l'état du connecteur passe à Active (Actif), accédez à l'onglet Entity (Entité).

  17. Cliquez sur l'entité userprofiles.

  18. Vérifiez le nombre de documents ingérés et assurez-vous qu'il correspond au nombre d'utilisateurs dans Entra ID.

    Si l'application Entra ID dispose des autorisations requises pour ingérer des attributs personnalisés, elle ingère jusqu'à 15 attributs de fiche de profil par enregistrement. Par défaut, les attributs personnalisés ne sont pas inclus dans l'index de recherche.

Pour rendre les attributs personnalisés disponibles pour la recherche:

  1. Sur la page userprofiles, accédez à l'onglet Schema (Schéma).
  2. Cliquez sur Modifier.
  3. Désélectionnez les attributs, tels que address, pour qu'ils ne soient pas récupérables, consultables ni indexables, puis cliquez sur Enregistrer.

    Le bouton Modifier reste inactif pendant quelques minutes avant de se réactiver.

  4. Lorsque le bouton Modifier est à l'état Actif, cliquez sur Modifier.

  5. Cochez les cases Récupérable, Rechercheable et Indexable pour les attributs personnalisés requis.

  6. Activez la recherche.

  7. Cliquez sur Enregistrer.

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 en tant qu'utilisateur.

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

Prévisualiser les résultats de recherche de contacts

  1. Dans l'application de recherche, accédez à Aperçu et commencez à effectuer une recherche dans la console lorsque vous utilisez l'IDP Google.

    • Vous pouvez également accéder au lien fourni et vous connecter avec votre IdP pour commencer à rechercher.
    • Les résultats de recherche s'affichent sous forme de fiches de contact, qui contiennent des informations sur l'utilisateur, comme son nom, sa fonction, son adresse e-mail et sa photo de profil.
  2. Cliquez sur une fiche de contact pour afficher une page de profil détaillée, qui comprend les éléments suivants:

    • Nom
    • Photo de profil
    • Fonction
    • Service
    • Chaîne de gestion
    • Personnes sous votre responsabilité
  3. Si les attributs personnalisés (propriétés de fiche de profil) sont ingérés et rendus indexables, recherchables et récupérables:

    • Une recherche par valeur d'attribut personnalisé ne renvoie que les profils de personnes contenant ces attributs.
    • Les attributs personnalisés apparaissent dans les résultats de recherche, mais ne sont accessibles que via l'API, et non via l'interface utilisateur de Vertex Search.

Configurer le pool d'employés pour un fournisseur d'identité autre que Google sans SSO

  1. Si vos employés utilisent un IdP autre que Google, ne disposent pas d'authentification unique avec Google ou ne sont pas clients Google Workspace, configurez un pool de collaborateurs comme décrit dans Utiliser le contrôle des accès aux sources de données pour activer la recherche d'employés.

    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.

  2. Pour configurer votre pool de personnel et activer l'application Web pour un accès fluide des utilisateurs, procédez comme suit:

    1. Créez un pool de personnel 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 (Agent Builder > Paramètres) pour la région dans laquelle vous créez votre application.

É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 magasin de données 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

Suivez la procédure ci-dessous pour synchroniser les données de GitLab 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 magasin de données 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 datastore avec cette source.

Avant de commencer

Avant de configurer votre connexion:

  • 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.
  • Pour que les autorisations utilisateur s'appliquent correctement, les utilisateurs Jira Cloud doivent donner leur autorisation de partage.
  • Assurez-vous de disposer d'un compte Atlassian, d'une instance Jira et d'un projet.
  • Vérifiez que vous disposez d'un accès administrateur à l'instance Jira et au projet.

Configurer l'authentification et les autorisations dans Jira

Suivez les instructions des sections suivantes pour vous assurer de disposer des informations d'authentification et de l'accès administrateur nécessaires à votre instance Jira. Créez un ID client et un code secret dans la console de développement Atlassian, configurez les portées OAuth 2.0 requises, configurez les autorisations pour les utilisateurs, récupérez l'URL et l'ID de votre instance, configurez des rôles et authentifiez-vous pour synchroniser les données entre Jira Cloud et Vertex AI Search.

Créer un ID client et un code secret

  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:

      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/jira_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. Sélectionnez Autorisations:

      1. Accédez à l'API Jira.
      2. Cliquez sur Ajouter.
      3. Cliquez sur Configurer.
      4. Accédez à l'onglet Champs d'application classiques, puis cliquez sur Modifier les champs d'application. Sélectionnez les champs d'application suivants :
    2. Vérifiez que huit champs d'application sont sélectionnés, puis enregistrez vos modifications.

  3. Obtenez l'ID client et le code secret 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.

  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, qui correspond au 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 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 datastore 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'entrée:

        • Autorisez le trafic du sous-réseau d'association du service PSC au 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 autoriser les connexions depuis des 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 vos nom et mot de passe d'administrateur.
    3. Cliquez sur Connexion.
  2. Créez un utilisateur:

    Lorsque vous créez un entrepôt de données, 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 en cliquant 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.

Vous pouvez ajouter ce schéma aux projets auxquels les utilisateurs de ce groupe doivent avoir accès pour afficher ce projet, ainsi que les problèmes, les commentaires, les journaux de travail et les pièces jointes associés.

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électionnez 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. Si votre instance dispose d'une URL de 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. Si aucune URL de domaine n'est définie pour votre instance :
        • 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 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 datastore et de l'activité d'ingestion, procédez comme suit:

  1. Accédez au connecteur dans la liste des magasins de données 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 magasin de données 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 magasin de données 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

Connect Monday

Suivez la procédure ci-dessous pour synchroniser les données du lundi 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 magasin de données 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 de l'URL du domaine, de l'accès administrateur et du jeton d'API.

Pour générer l'URL du compte et le jeton d'API, procédez comme suit:

  1. Connectez-vous à l'application Monday avec votre compte administrateur.
  2. Cliquez sur l'icône Profil.
  3. Sélectionnez Administration.
  4. Accédez à l'onglet Général, puis saisissez le nom du compte et l'URL du compte.
  5. Revenez à l'icône Profil, puis sélectionnez Développeurs.
  6. Sur la page du Developer Center de Monday, cliquez sur Mes jetons d'accès.
  7. Cliquez sur Afficher pour afficher le jeton.
  8. Copiez le jeton pour l'utiliser lors de l'authentification.

Créer un connecteur Monday

Console

Pour synchroniser les données du lundi à 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. Sur la page Datastores (Data stores), cliquez sur Créer un data store.

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

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

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

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

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

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

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

  10. 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 magasin de données 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 Okta

Suivez la procédure ci-dessous pour synchroniser les données d'Okta 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 magasin de données 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 de disposer de l'URL du domaine et d'un accès administrateur à l'instance Okta. Pour obtenir l'URL de l'instance Okta, l'ID client et le jeton d'API, procédez comme suit :

  1. Pour obtenir l'URL de l'instance Okta, procédez comme suit:

    1. Connectez-vous à la page de connexion Okta avec vos identifiants administrateur.
    2. Cliquez sur l'icône de votre profil ou accédez directement à la console d'administration. L'URL de votre instance Okta s'affiche sous forme de sous-domaine dans la barre d'adresse.
  2. Pour générer l'ID client et le jeton d'API, procédez comme suit:

    1. Connectez-vous à l'URL de votre instance Okta avec votre compte administrateur.
    2. Accédez au tableau de bord de l'administrateur.
    3. Cliquez sur l'icône Applications, puis sélectionnez Applications.
    4. Cliquez sur Créer une intégration d'application.
    5. Sélectionnez OIDC – OpenID Connect.
    6. Sélectionnez Application Web comme type d'application, puis cliquez sur Next (Suivant).
    7. Saisissez un nom dans le champ Nom de l'intégration d'application.
    8. Faites défiler la page jusqu'à Devoirs, puis sélectionnez Ignorer l'attribution du groupe pour le moment.
    9. Cliquez sur Enregistrer.
    10. Dans la fenêtre Identifiants client, cliquez sur Modifier.
    11. Sélectionnez Clé publique / Clé privée.
    12. Sous Clé publique, cliquez sur Ajouter une clé.
    13. Cliquez sur Générer une clé, puis sur OK et Enregistrer.
    14. Une boîte de dialogue s'affiche. Cliquez sur Enregistrer.
    15. Sous Paramètres généraux, cliquez sur Modifier.
    16. Sélectionnez Identifiants client, puis cliquez sur Enregistrer.

Créer un connecteur Okta

Console

Pour synchroniser les données d'Okta 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 Okta pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification Okta, 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 magasin de données 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 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. Vous devez disposer du rôle Administrateur. 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

Pour synchroniser des données depuis Salesforce vers 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 magasin de données 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 secret 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 synchroniser les données de Salesforce 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 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 En cours 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 magasin de données 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 d'employés.

  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 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 secret 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 entrepôt de données ServiceNow. Si vous n'avez aucun problème à utiliser le rôle Administrateur pour extraire des données, créez un entrepôt de données.

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 de 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é 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 En cours 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 Data Center sur site

Suivez cette procédure pour créer un data store et une application de recherche SharePoint Data Center dans Agent Builder, en synchronisant les données SharePoint 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, procédez comme suit:

  1. Rattachement de service (obligatoire pour le type de destination privé uniquement) : suivez les étapes ci-dessous pour générer un rattachement de service pour le transfert de données sécurisé.

    1. Choisir le type de point de terminaison: sélectionnez un point de terminaison public ou privé.
    2. Pour un point de terminaison public: si le type de destination du centre de données SharePoint est public, vous n'êtes pas obligé de créer la configuration pour l'association de services. 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 depuis des 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 de l'é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éfinir 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.
  2. Nom d'utilisateur et mot de passe: obtenez auprès de votre administrateur SharePoint des identifiants valides pour l'authentification.

  3. Facultatif pour le type de destination privée: URL de domaine: conservez l'URL de domaine de l'instance du centre de données SharePoint si l'instance se trouve derrière un proxy ou une connexion SSL.

  4. Facultatif: Nom de domaine de base: indiquez le nom de domaine de base de l'instance SharePoint.

  5. Facultatif: Port de destination: identifiez le port utilisé pour la communication avec le centre de données SharePoint.

  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'entrée:

        • Autorisez le trafic du sous-réseau d'association du service PSC au 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.

Créer un utilisateur SharePoint Data Center

Pour créer un utilisateur du centre de données SharePoint, obtenez un nom d'utilisateur et un mot de passe auprès d'un administrateur. L'administrateur doit suivre ces étapes pour créer un utilisateur dans l'instance SharePoint Data Center.

  1. Cliquez sur Menu Démarrer.
  2. Accédez à Outils d'administration Windows > Utilisateurs et ordinateurs Active Directory.
  3. Lancez l'application Utilisateurs et ordinateurs Active Directory.
  4. Développez votre unité organisationnelle, puis accédez au conteneur Utilisateurs pour ajouter le nouvel utilisateur.
  5. Effectuez un clic droit sur Utilisateurs, puis sélectionnez Nouveau > Utilisateur.
  6. Dans la boîte de dialogue Nouvel objet: utilisateur :
    1. Saisissez les champs Prénom, Nom complet et Nom d'ouverture de session de l'utilisateur.
    2. Cliquez sur Suivant.
  7. Dans la boîte de dialogue Nouvel objet: utilisateur :
    1. Renseignez les informations requises :
      1. Mot de passe
      2. Confirmer le mot de passe
    2. Sélectionnez les options suivantes :
      1. L'utilisateur ne peut pas modifier son mot de passe
      2. Le mot de passe n'expire jamais
    3. Cliquez sur Suivant.
  8. Cliquez sur Terminer.
  9. Recherchez l'utilisateur créé dans la section Utilisateurs, double-cliquez dessus, puis sélectionnez Propriétés.
  10. Dans la boîte de dialogue Propriétés :
    1. Ajoutez une adresse e-mail pour l'utilisateur.
    2. Cliquez sur Appliquer.

Configurer la collection de sites dans SharePoint

  1. Connectez-vous à la console d'administration SharePoint.
  2. Sur la page Administration centrale, accédez à Gestion des applications.
  3. Cliquez sur Créer des collections de sites.
  4. Sur la page Créer une collection de sites, saisissez les informations requises dans les champs Titre et Description.
  5. Dans la section Adresse des sites Web, saisissez l'URL du site.
  6. Dans la section Administrateur de la collection de sites principale, cliquez sur l'option Parcourir à côté du champ Nom d'utilisateur.
  7. Dans la boîte de dialogue Sélectionner des utilisateurs, saisissez le nom d'utilisateur de l'administrateur, puis cliquez sur l'icône Rechercher.
  8. Sélectionnez l'utilisateur, puis cliquez sur OK. La page Site créé avec succès s'affiche et l'URL du site s'affiche.
  9. Copiez l'URL et ouvrez-la dans un nouvel onglet. Le site s'affiche.

Se connecter avec l'utilisateur créé

  1. Utilisez les identifiants de l'utilisateur créé pour vous connecter au site SharePoint.
  2. Vérifiez les droits d'accès et les autorisations de l'utilisateur.

Créer un connecteur SharePoint Data Center sur site

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 SharePoint 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'êtes pas obligé 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. Si votre instance dispose d'une URL de 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. Si aucune URL de domaine n'est définie pour votre instance :
        • 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 gérer les états des connecteurs, procédez comme suit:

  1. Pour le type de destination privé:

    1. Envoyez les informations du connecteur.
    2. VAIS envoie une demande de connexion à votre PSC.
    3. Accédez à votre connecteur pour voir un message vous invitant à ajouter un projectId à la liste d'autorisation dans le PSC.
    4. Autorisez la connexion dans PSC :
      1. Le connecteur reste à l'état Erreur jusqu'à ce que vous approuviez la demande.
      2. Une fois approuvé, le connecteur passe à l'état Active lors de la prochaine exécution de la synchronisation.
    5. Si votre PSC est configuré pour accepter toutes les connexions, le connecteur passe automatiquement à l'état Active (Actif) après sa création.
  2. Pour le type de destination publique:

    1. Envoyez les informations du connecteur.
    2. Le connecteur passe automatiquement à l'état Actif après l'envoi.

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

  1. Accédez au connecteur dans la liste des datastores et surveillez son état jusqu'à ce qu'il passe à Actif.
  2. Une fois que l'état du connecteur passe à Active (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 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 magasin de données 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 secret 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 secret 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 le 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 personnel 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 (Agent Builder > Paramètres) pour la région dans laquelle vous créez votre application.

Étapes suivantes

Associer 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 magasin de données 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 MPIM, 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 datastore 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 Utiliser le contrôle des accès des sources de données.

Un administrateur Trello doit suivre les étapes suivantes:

  1. Générez une clé API dans Trello:

    1. Connectez-vous à l'instance Trello à l'aide des identifiants d'utilisateur test fournis sur Trello.

    2. Sur la page Administration des modules complémentaires Trello, accédez à Accéder à l'administration des modules complémentaires.

    3. Cliquez sur Nouveau pour créer un bonus.

    4. Renseignez les informations requises:

    5. Cliquez sur Suivant pour continuer, puis générez une clé API. Copiez la clé API et le code secret.

  2. Pour générer un jeton d'API dans Trello:

    1. Cliquez sur le lien Generate token (Générer un jeton) sur la droite pour générer un jeton d'API.

      1. Cliquez sur Autoriser pour accorder l'accès à votre jeton d'API.
      2. Assurez-vous que toutes les entités requises disposent des autorisations appropriées dans le champ d'application.
    2. Copiez le jeton d'API généré. Utilisez ce jeton pour le connecteur Trello dans Vertex AI Search.

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

Associer WordPress

Suivez la procédure ci-dessous pour synchroniser les données de WordPress 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 magasin de données synchronise les données de cette source à une fréquence que vous sélectionnez lors de la configuration.

Avant de commencer

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

  • Nom d'utilisateur et mot de passe: obtenez les identifiants auprès de l'administrateur WordPress.
  • URL du site: utilisez cette URL pour créer un entrepôt de données.

Créer un utilisateur WordPress

Pour créer un utilisateur WordPress, demandez à un administrateur de vous fournir un nom d'utilisateur et un mot de passe. L'administrateur doit se connecter et suivre ces étapes pour créer un utilisateur dans l'instance WordPress.

  1. Connectez-vous en tant qu'administrateur:

    1. Accédez à votre plate-forme d'hébergement et connectez-vous avec vos identifiants d'administrateur pour accéder à votre site Web WordPress.
    2. Cliquez sur l'icône Site Web.
    3. Cliquez sur WordPress admin (Panneau d'administration WordPress) pour votre site.
  2. Créez un utilisateur:

    1. Sur la page Administration WordPress, accédez à l'onglet Utilisateurs.
    2. Cliquez sur Ajouter.
    3. Renseignez toutes les informations requises, y compris les suivantes :
      • Nom d'utilisateur
      • Adresse e-mail
      • Facultatif: Prénom et nom
      • Rôle
      • Mot de passe (si vous y êtes invité)
    4. Cliquez sur Ajouter un utilisateur pour enregistrer les modifications.

Créer un connecteur WordPress

Console

Pour synchroniser les données de WordPress 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 WordPress pour connecter votre source tierce.

  5. Saisissez vos informations d'authentification WordPress, puis cliquez sur Continue (Continuer).

  6. Dans le champ URL, saisissez l'URL de votre site WordPress, puis cliquez sur Continue (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 magasin de données 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. 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 via lequel 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.
  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 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 magasin de données 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