Cette page explique comment connecter des sources de données tierces à Vertex AI Search.
Quand vous connectez une source de données tierce, crée un connecteur de données et associe les data stores (appelé entity) avec elle pour les entités que vous spécifiez. Entité sont propres à 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 l'article Créer des données de recherche Google Store.
Avant de commencer
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.
Accédez à la section de la source que vous prévoyez d'utiliser :
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, le data store synchronise les données provenant de cette source à la fréquence que vous sélectionnez lors de la configuration.
Avant de configurer votre connexion :
Configurez le contrôle des accès pour votre source de données. Pour plus d'informations sur la configuration du contrôle des accès, consultez Utilisez le contrôle des accès aux sources de données.
Munissez-vous des informations d'authentification suivantes:
URL de l'instance. Au format
https://EXAMPLE.atlassian.net
(par exemple,https://google.atlassian.net
).ID d'instance. Il s'agit de
cloudid
. Pour le trouver, accédez àhttps://EXAMPLE.atlassian.net/_edge/tenant_info
et copiez la valeur decloudId
.
Activez OAuth 2.0, puis obtenez l'ID client et le code secret.
Utilisez
https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html
comme URL de rappel. Pour savoir comment activer OAuth 2.0 pour Confluence Cloud et obtenir l'ID client et le secret client, consultez la section Applications OAuth 2.0 (3LO) dans la documentation pour les développeurs Atlassian.Lorsque vous définissez des champs d'application d'autorisation OAuth 2.0, configurez les champs d'application suivants :
Pour que les autorisations utilisateur s'appliquent correctement, chaque utilisateur de Confluence Cloud doit rendre son adresse e-mail visible par tous les utilisateurs. Pour ce faire, modifier les paramètres de visibilité des e-mails dans Confluence Cloud 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.
Console
Pour synchroniser les données de Confluence Cloud avec la console Google Cloud pour Vertex AI Search, procédez comme suit:
Dans la console Google Cloud, accédez à la page Agent Builder.
Dans le menu de navigation, cliquez sur Data stores (Datastores).
Cliquez sur Nouveau data store.
Sur la page Sélectionner une source de données, accédez à Sources tierces. et sélectionnez Confluence.
Saisissez vos informations d'authentification, puis cliquez sur Authentifier.
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 Spécifier la page de la source Confluence pour votre data store.
Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.
Sélectionnez une région pour votre connecteur de données.
Attribuez un nom à votre connecteur de données.
Sélectionnez une fréquence de synchronisation.
Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Datastores).
Pour vérifier l'état de votre ingestion, accédez à la page Datastores et cliquez sur le nom de votre data store pour en afficher les détails sur la page Données correspondante. L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Une fois l'ingestion terminée, l'état devient Active : indique que la connexion à votre source de données est configurée et en attente de la prochaine synchronisation planifiée.
Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.
Étapes suivantes
Pour associer votre data store à une application, créez-en une et sélectionnez votre data store en suivant la procédure décrite dans la section Créer une application de recherche.
Consultez Aperçu des résultats pour les applications avec contrôle des accès tiers.
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 à laquelle le data store se synchronise 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 des utilisateurs s'appliquent correctement, les utilisateurs de 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 via la console de développement Atlassian, configurez les champs d'application OAuth 2.0 requis et configurez les autorisations pour les utilisateurs. Enfin, 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
REMARQUE:Pour activer OAuth 2.0 et obtenir l'ID client et le code secret, consultez la page OAuth 2.0 (3LO) applications dans la documentation pour les développeurs Atlassian.
- Connectez-vous à developer.atlassian.com.
- Cliquez sur l'icône du profil dans l'angle supérieur droit, puis sélectionnez Console développeur.
- Cliquez sur Créer, puis sélectionnez Intégration OAuth 2.0.
- Attribuez un nom à l'application.
- Cochez la case des conditions d'utilisation.
- Cliquez sur Créer.
Cinq options sont disponibles: Overview (Aperçu), Distribution (Distribution), Permissions (Autorisations), Authorization (Autorisation) et Settings (Paramètres). Commencez par Autorisation :
a. Cliquez sur Autorisation.
b. Dans le tableau Type d'autorisation, sélectionnez Ajouter pour OAuth 2.0 (3LO).
Dans le champ URL de rappel, saisissez
https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html
, puis cliquez sur Enregistrer les modifications.REMARQUE : Si l'avertissement Votre application ne contient aucune API s'affiche, Ajouter des API à votre application, ce qui sera abordé dans la section suivante.
Sélectionnez Autorisations:
a. Accédez à l'API Jira, cliquez sur Ajouter, puis sur Configurer.
REMARQUE : Lorsque vous cliquez sur Ajouter, le bouton devient Configurer.
b. Accédez à l'onglet Champs d'application classiques, puis cliquez sur Modifier les champs d'application. Sélectionnez les niveaux d'accès suivants:
Confirmez que les sept champs d'application sont sélectionnés, puis enregistrez vos modifications.
Cliquez sur Distribution, sélectionnez Modifier, puis procédez comme suit :
- Commencez par sélectionner la case d'option Partage pour pouvoir modifier les autres champs.
- Renseignez les champs restants.
- Sélectionnez Oui lorsque vous y êtes invité:
Does your app store personal data?
Sélectionnez Paramètres pour copier votre ID client et votre code secret client.
Récupérer l'URL et l'ID d'instance
Pour obtenir l'URL de l'instance:
- Accédez à atlassian.net, puis connectez-vous avec votre compte administrateur.
- Sélectionnez l'application à synchroniser. Par exemple, synchronisez la première application.
- Recherchez l'URL de l'instance, qui correspond au sous-domaine dans la barre d'adresse. Elle se présente comme suit :
Assign appropriate permissions
.
Pour obtenir l'ID d'instance:
- 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
- Accédez au lien pour trouver la valeur
cloudId
.cloudId
correspond à votre ID d'instance.
Configurer les autorisations et les rôles
- Connectez-vous à atlassian.com avec votre compte administrateur.
- Cliquez sur l'icône de menu en haut à gauche ou accédez à admin.atlassian.com.
Sur la page Admin, cliquez sur Gérer les utilisateurs, puis accédez à la page Groupes.
Cliquez sur Créer un groupe. Saisissez un nom pour le groupe et créez-le.
Dans la section Accès aux produits du groupe de la page de votre nouveau groupe, cliquez sur Ajouter des produits au groupe.
Pour Jira, sélectionnez Administrateur de l'accès des utilisateurs comme rôle produit.
Pour Jira Admin, sélectionnez Product admin (Administrateur produit) comme rôle produit, puis enregistrez vos modifications.
Sur la page Groupes, cliquez sur Ajouter des membres au groupe, puis ajoutez les utilisateurs ou les comptes avec lesquels le connecteur s'authentifiera.
Créer un connecteur Jira Cloud
Console
Pour synchroniser les données de Jira Cloud avec la console Google Cloud pour Vertex AI Search, procédez comme suit:
Dans la console Google Cloud, accédez à la page Agent Builder.
Dans le menu de navigation, cliquez sur Data stores (Magasins de données).
Cliquez sur Créer un datastore.
Sur la page Sélectionner une source de données, accédez à la section Sources tierces, puis sélectionnez Jira.
Saisissez vos informations d'authentification, puis cliquez sur Authentifier.
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 Spécifier la source Jira pour votre data store.
Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.
Sélectionnez une région pour votre data store.
Attribuez un nom à votre datastore.
Sélectionnez une fréquence de synchronisation.
Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Datastores).
Pour vérifier l'état de votre ingestion, accédez à la page Datastores et cliquez sur le nom de votre data store pour en afficher les détails sur la page Données correspondante. L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Une fois l'ingestion terminée, l'état devient Active : indique que la connexion à votre source de données est configurée et en attente de la prochaine synchronisation planifiée.
Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.
Étapes suivantes
Pour associer votre data store à une application, créez une application et sélectionnez votre data store en suivant les étapes décrites dans Créez une application de recherche.
Consultez Aperçu des résultats pour les applications avec contrôle des accès tiers.
Associer Salesforce
Procédez comme suit pour synchroniser les données de Salesforce vers Vertex AI Search.
Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données provenant de cette source à la fréquence que vous sélectionnez lors de la configuration.
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 la page Utiliser le contrôle des accès des sources de données.
Munissez-vous des informations d'authentification suivantes. Pour en savoir plus sur la configuration des ID client et des secrets 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
- Code secret client
La limite suivante s'applique :
- Pour synchroniser un utilisateur en tant qu'entité, celui-ci doit donner son consentement au partage.
Console
Pour synchroniser les données de Salesforce avec la console Google Cloud, procédez comme suit : pour Vertex AI Search, procédez comme suit:
Ajoutez Google Cloud à votre liste d'autorisation CORS Salesforce. Si vous avez déjà effectué passez à l'étape suivante.
Suivez les instructions de la documentation Salesforce pour configurer la liste d'autorisation CORS.
Saisissez
https://console.cloud.google.com/
en tant qu'URL d'origine et enregistrez votre configuration.
Dans la console Google Cloud, accédez à la page Agent Builder.
Dans le menu de navigation, cliquez sur Data stores (Datastores).
Cliquez sur Créer un datastore.
Sur la page Sélectionner une source de données, accédez à la section Sources tierces, puis sélectionnez Salesforce.
Saisissez vos informations d'authentification Salesforce.
Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.
Sélectionnez une région pour votre data store.
Attribuez un nom à votre datastore.
Sélectionnez une fréquence de synchronisation.
Cliquez sur Créer. Vertex AI Search crée votre data store et l'affiche sur la page Datastores (Datastores).
Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores), puis 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. Une fois l'ingestion terminée, l'état devient Active : indique que la connexion à votre source de données est configurée et en attente de la prochaine synchronisation planifiée.
Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.
Étapes suivantes
Pour associer votre data store à une application, créez une application et sélectionnez votre data store en suivant les étapes décrites dans Créez une application de recherche.
Consultez Aperçu des résultats pour les applications avec contrôle des accès tiers.
Connecter ServiceNow
Procédez comme suit pour synchroniser les données de ServiceNow avec Vertex AI Search.
Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données provenant de cette source à la fréquence que vous sélectionnez lors de la configuration.
Avant de configurer votre connexion :
Configurez le contrôle des accès pour votre source de données. Pour plus d'informations sur la configuration du contrôle des accès, consultez Utilisez le contrôle des accès aux sources de données.
Munissez-vous des informations d'authentification suivantes:
- URL d'instance au format
https://<domain-name>.service-now.com/
. - ID client et code secret client Pour en savoir plus sur la configuration des points de terminaison et l'obtention de l'ID client et du code secret client, consultez la section Créer un point de terminaison pour que les clients puissent accéder à l'instance dans la documentation ServiceNow.
Nom d'utilisateur et mot de passe pour l'un des types de rôle ServiceNow suivants:
- Administrateur. Consultez la section Rôles système de base dans la Documentation ServiceNow.
Rôle ServiceNow personnalisé. Il s'agit d'une alternative à l'utilisation administrateur. Pour utiliser un rôle ServiceNow personnalisé, créez un accès des règles de contrôle avec les champs suivants:
Pour en savoir plus, consultez les pages Créer un rôle et Créer une règle ACL dans la documentation ServiceNow.
- URL d'instance au format
Console
Pour synchroniser les données de ServiceNow avec la console Google Cloud, procédez comme suit : pour Vertex AI Search, procédez comme suit:
Dans la console Google Cloud, accédez à la page Agent Builder.
Dans le menu de navigation, cliquez sur Data stores (Magasins de données).
Cliquez sur Créer un datastore.
Sur la page Sélectionner une source de données, accédez à Sources tierces. et sélectionnez ServiceNow.
Saisissez vos informations d'authentification ServiceNow.
Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.
Sélectionnez une région pour votre connecteur de données.
Attribuez un nom à votre connecteur de données.
Sélectionnez une fréquence de synchronisation.
Cliquez sur Créer. Vertex AI Search crée votre data store affiche vos data stores sur la page Data stores (magasins de données).
Pour vérifier l'état de votre ingestion, accédez à la page Datastores et Cliquez sur le nom de votre connecteur de données pour afficher les informations le concernant sur la page Données correspondante. L'état du connecteur passe de Creating (Création) à Running (En cours d'exécution) lorsqu'il commence à synchroniser les données. Une fois l'ingestion terminée, l'état devient Active : indique que la connexion à votre source de données est configurée et en attente de la prochaine synchronisation planifiée.
Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.
Étapes suivantes
Pour associer votre data store à une application, créez une application et sélectionnez votre data store en suivant les étapes décrites dans Créez une application de recherche.
Voir Prévisualiser les résultats pour les applications disposant d'un accès tiers de commande.
Connecter SharePoint Online
Suivez la procédure ci-dessous pour synchroniser les données de Sharepoint Online avec la recherche Vertex AI.
Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données provenant de cette source à la fréquence que vous sélectionnez lors de la configuration.
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 la page Utiliser le contrôle des accès des sources de données.
L'authentification à deux facteurs (2FA) doit être désactivée pour Sharepoint de service. Seule l'authentification de base par mot de passe OAuth2 est acceptée.
Accorder l'autorisation de l'administrateur Pour savoir comment accorder un consentement, consultez la section Accorder un consentement administrateur à l'échelle du locataire à une application dans la documentation Microsoft.
Préparez les informations d'authentification SharePoint Online suivantes à utiliser lors de la configuration :
- URL de l'instance. Au format
http://DOMAIN_OR_SERVER/[sites/]WEBSITE
. Pour en savoir plus sur les URL, consultez la section URL et jetons dans SharePoint de la documentation SharePoint. - ID de locataire, ID client et code 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 avec la plate-forme Microsoft Identity dans la documentation Microsoft.
- Nom d'utilisateur et mot de passe. Ils doivent correspondre à un site Sharepoint ou un administrateur de collections de sites Sharepoint avec l'authentification à deux facteurs désactivée.
- URL de l'instance. Au format
Le tableau suivant décrit les rôles recommandés pour configuration et leurs limites.
Étapes suivantes
Pour associer votre data store à une application, créez une application et sélectionnez votre data store en suivant la procédure décrite dans Créer une application de recherche.
Voir Prévisualiser les résultats pour les applications disposant d'un accès tiers de commande.
Connecter Slack
Suivez la procédure ci-dessous pour synchroniser les données de Slack avec la recherche Vertex AI.
Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données provenant de cette source à la fréquence que vous sélectionnez lors de la configuration.
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 la page Utiliser le contrôle des accès des sources de données.
Préparez les informations d'authentification Slack suivantes :
- ID de l'espace de travail. Pour savoir comment obtenir les ID d'espace de travail, consultez Spécifiez la source Slack pour votre data store sous la documentation Slack.
- Jeton d'accès. Pour en savoir plus sur la création d'une application cliente et la définition d'accès, consultez les sections Démarrage rapide et Comment obtenir rapidement et utiliser un jeton d'API Slack dans la documentation de Slack.
- Lorsque vous définissez des champs d'application d'autorisation OAuth 2.0, configurez les champs d'application suivants :
La limite suivante s'applique :
- Le comportement par défaut de Slack limite l'exploration et la synchronisation du contenu des des canaux privés, des messages instantanés multipartites et des messages instantanés privés.
Console
Pour synchroniser les données de Slack avec Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit :
Dans la console Google Cloud, accédez à la page Agent Builder.
Dans le menu de navigation, cliquez sur Data stores (Datastores).
Cliquez sur Créer un datastore.
Sur la page Sélectionner une source de données, accédez à Sources tierces. et sélectionnez Slack.
Saisissez vos informations d'authentification Slack.
Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.
Sélectionnez une région pour votre data store.
Attribuez un nom à votre datastore.
Sélectionnez une fréquence de synchronisation pour votre data store.
Cliquez sur Créer. Vertex AI Search crée votre data store affiche vos data stores sur la page Data stores (magasins de données).
Pour vérifier l'état de votre ingestion, accédez à la page Datastores et cliquez sur le nom de votre data store pour en afficher les détails sur la page Données correspondante. L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Une fois l'ingestion terminée, l'état devient Active : indique que la connexion à votre source de données est configurée et en attente de la prochaine synchronisation planifiée.
Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.
Étapes suivantes
Pour associer votre data store à une application, créez-en une et sélectionnez votre data store en suivant la procédure décrite dans la section Créer une application de recherche.
Consultez Aperçu des résultats pour les applications avec contrôle des accès tiers.
Connecter Dropbox
Procédez comme suit pour synchroniser les données de Dropbox avec Vertex AI Search.
Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données provenant de cette source à la 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 plus d'informations, consultez la page Utiliser le contrôle des accès aux sources de données.
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
Console
Pour synchroniser les données de Dropbox avec la console Google Cloud, procédez comme suit : pour Vertex AI Search, procédez comme suit:
Dans la console Google Cloud, accédez à la page Agent Builder.
Dans le menu de navigation, cliquez sur Data stores (Datastores).
Cliquez sur Créer un datastore.
Sur la page Sélectionner une source de données, accédez à Sources tierces. et sélectionnez Dropbox.
Saisissez vos informations d'authentification Dropbox, puis cliquez sur Authentifier. Une nouvelle fenêtre s'affiche.
Authentifiez votre compte et confirmez qu'il réussi avant de revenir à la boîte de dialogue Spécifiez la source Dropbox pour de votre data store.
Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.
Sélectionnez un emplacement pour votre data store.
Attribuez un nom à votre datastore.
Sélectionnez une fréquence de synchronisation pour votre data store.
Cliquez sur Créer. Vertex AI Search crée votre data store affiche vos data stores sur la page Data stores.
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. Une fois l'ingestion terminée, l'état devient Active : indique que la connexion à votre source de données est configurée et en attente de 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 de quelques minutes à plusieurs heures.
Étapes suivantes
Pour associer votre data store à une application, créez-en une et sélectionnez votre data store en suivant la procédure décrite dans la section Créer une application de recherche.
Pour prévisualiser l'affichage de vos résultats de recherche une fois votre application et votre data store configurés, consultez Obtenir des résultats de recherche. Si vous avez utilisé des applications tierces, consultez l'article Prévisualiser les résultats des applications contrôle des accès.
Connect Box
Procédez comme suit pour synchroniser les données de Box avec Vertex AI Search.
Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données provenant de cette source à la 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 la page Utiliser le contrôle des accès des sources de données.
Préparez les informations d'authentification Box suivantes. Pour plus d'informations sur la configuration de ces paramètres, consultez la section Authentification JWT dans l'encadré. pour les développeurs.
- ID Box Entreprise
- ID client
- Code secret du client
- ID de clé publique
- Clé privée
- Phrase secrète
Lors de la création du point de terminaison JWT, configurez les champs d'application suivants:
Les limites suivantes s'appliquent :
- La synchronisation des modifications incrémentielles pour les commentaires peut prendre plus de temps que la configuration l'intervalle de fréquence de diffusion.
- Si un dossier contenant une entité est copié ou déplacé, la synchronisation des modifications incrémentielles peut prendre plus de temps que l'intervalle de fréquence configuré.
Console
Pour synchroniser les données de Box avec la console Google Cloud, procédez comme suit : pour Vertex AI Search, procédez comme suit:
Dans la console Google Cloud, accédez à la page Agent Builder.
Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).
Cliquez sur Créer un datastore.
Sur la page Sélectionner une source de données, accédez à la section Sources tierces, puis sélectionnez Case.
Saisissez vos informations d'authentification.
Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.
Sélectionnez une région pour votre data store.
Attribuez un nom à votre datastore.
Sélectionnez une fréquence de synchronisation pour votre data store.
Cliquez sur Créer. Vertex AI Search crée votre data store affiche vos data stores sur la page Data stores.
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). La L'état du connecteur passe de Création à En cours d'exécution au démarrage. synchronisation des 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
Pour associer votre data store à une application, créez-en une et sélectionnez votre data store en suivant la procédure décrite dans la section Créer une application de recherche.
Pour prévisualiser l'affichage de vos résultats de recherche une fois votre application et votre data store configurés, consultez Obtenir des résultats de recherche. Si vous avez utilisé le contrôle des accès tiers, consultez Prévisualiser les résultats pour les applications avec contrôle des accès tiers.
Connecter OneDrive
Suivez la procédure ci-dessous pour synchroniser les données de OneDrive avec la recherche Vertex AI.
Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le data store synchronise les données provenant de cette source à la 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 plus d'informations sur la configuration du contrôle des accès, consultez Utilisez le contrôle des accès aux sources de données.
Préparez les informations d'authentification OneDrive suivantes :
l'ID client, le code secret du client et l'ID du 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.
Spécifiez les niveaux d'accès. Veuillez indiquer un rôle d'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.
Configurez les champs d'application suivants:
Console
Pour synchroniser les données de OneDrive avec la console Google Cloud pour Vertex AI Search, procédez comme suit:
Dans la console Google Cloud, accédez à la page Agent Builder.
Dans le menu de navigation, cliquez sur Datastores (Entrepôts de données).
Cliquez sur Créer un datastore.
Sur la page Sélectionner une source de données, accédez à la section Sources tierces, puis sélectionnez OneDrive.
Saisissez vos informations d'authentification OneDrive.
Sélectionnez les entités à synchroniser, puis cliquez sur Continuer.
Sélectionnez une région pour votre data store.
Attribuez un nom à votre datastore.
Sélectionnez une fréquence de synchronisation pour votre data store.
Cliquez sur Créer. Vertex AI Search crée votre data store affiche vos data stores sur la page Data stores.
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). La L'état du connecteur passe de Création à En cours d'exécution au démarrage. synchronisation des 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
Pour associer votre data store à une application, créez-en une et sélectionnez votre data store en suivant la procédure décrite dans la section Créer une application de recherche.
Pour prévisualiser la façon dont vos résultats de recherche s'affichent une fois que votre application et votre data store ont été consultez l'article Obtenir des résultats de recherche. Si vous avez utilisé des applications tierces, consultez l'article Prévisualiser les résultats des applications contrôle des accès.