Connecter une source de données tierce

Remarque: Cette fonctionnalité est une offre en version bêta soumise aux conditions des offres avant disponibilité générale des Conditions spécifiques du service GCP. Les fonctionnalités et produits pré-DG sont susceptibles de présenter une compatibilité limitée, et les modifications apportées à ces fonctionnalités ou produits peuvent ne pas être compatibles avec d'autres versions pré-DG. Pour en savoir plus, consultez les descriptions des étapes de lancement. En outre, en utilisant cette fonctionnalité, vous acceptez les Conditions d'utilisation de la version bêta de Generative AI ("Conditions d'utilisation bêta"). Pour cette fonctionnalité, vous pouvez traiter les données à caractère personnel comme indiqué dans l'avenant relatif au traitement des données dans le cloud, sous réserve des restrictions et obligations applicables dans le contrat (tel que défini dans les Conditions d'aperçu).

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

Preview:les connecteurs tiers sont en version preview avec une liste d'autorisation. Vous devez figurer sur la liste d'autorisation pour pouvoir utiliser cette fonctionnalité.

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:

   • Connecter Confluence Cloud
   • Connecter Jira Cloud
   • Connecter Salesforce
   • Connecter ServiceNow
   • Connecter SharePoint Online
   • Connecter Slack
   • Connecter Dropbox
   • Box Connect
   • Connecter OneDrive

Connecter Confluence Cloud

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

Preview:les connecteurs tiers sont en version preview avec une liste d'autorisation. Vous devez figurer sur la liste d'autorisation pour pouvoir utiliser cette fonctionnalité.

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

Avant de 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 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 de cloudId.

• Activez OAuth 2.0, puis obtenez l'ID client et le code secret du client.

  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 code secret du 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:

  Afficher les champs d'application

  • read:attachment:confluence
  • read:configuration:confluence
  • read:content-details:confluence
  • read:content.metadata:confluence
  • read:group:confluence
  • read:space:confluence
  • read:user:confluence

• Pour que les autorisations utilisateur s'appliquent correctement, chaque utilisateur Confluence Cloud doit rendre son adresse e-mail visible par 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.

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 Data stores (Datastores).

3. Cliquez sur Nouveau data store.

4. Sur la page Sélectionner une source de données, accédez à la section Sources tierces, puis sélectionnez Confluence.

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), 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. 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.

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

Preview:les connecteurs tiers sont en version preview avec une liste d'autorisation. Vous devez figurer sur la liste d'autorisation pour pouvoir utiliser cette fonctionnalité.

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:

• 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 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 code secret du client

REMARQUE:Pour activer OAuth 2.0 et obtenir l'ID client et le secret, consultez la section Applications OAuth 2.0 (3LO) dans la documentation pour les développeurs Atlassian.

1. Connectez-vous à developer.atlassian.com.
2. Cliquez sur l'icône de profil en haut à droite, puis sélectionnez Console de développement.
3. Cliquez sur Créer, puis sélectionnez Intégration OAuth 2.0.
4. Attribuez un nom à l'application.
   • Cochez la case des conditions d'utilisation.
   • Cliquez sur Créer.

5. Cinq options s'affichent: Vue d'ensemble, Distribution, Autorisations, Autorisation et Paramètres. Commencez par Autorisation:

   a. Cliquez sur Autorisation.

   b. Dans le tableau Type d'autorisation, sélectionnez Ajouter pour OAuth 2.0 (3LO).

6. 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 suivant s'affiche: Votre application ne contient aucune API. Ajouter des API à votre application, ce qui sera abordé dans la section suivante.

7. Sélectionnez Autorisations:

   a. Accédez à 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 champs d'application suivants:

   Afficher les champs d'application

   • read:avatar:jira
   • read:audit-log:jira
   • read:group:jira
   • read:issue-security-level:jira
   • read:issue-security-scheme:jira
   • read:jira-user
   • read:jira-work
   • read:user:jira

   Vérifiez que sept champs d'application sont sélectionnés, puis enregistrez vos modifications.

8. Cliquez sur Distribution, sélectionnez Modifier, puis procédez comme suit:

   • Commencez par sélectionner la case d'option Partage pour pouvoir modifier d'autres champs.
   • Renseignez les champs restants.
   • Sélectionnez Oui lorsque vous y êtes invité: Does your app store personal data?

9. 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:

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. Elle se présente comme suit: Assign appropriate permissions.

Pour obtenir 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 correspond à 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. Dans la section Accès aux produits du groupe de la page de votre nouveau groupe, cliquez sur Ajouter des produits au groupe.

6. Pour Jira, sélectionnez Administrateur de l'accès des utilisateurs comme rôle produit.

7. Pour Administrateur Jira, sélectionnez Administrateur produit comme rôle produit, puis enregistrez vos modifications.

8. Sur la page Groups (Groupes), cliquez sur Add group members (Ajouter des membres au groupe), puis ajoutez les utilisateurs ou les comptes sous lesquels le connecteur s'authentifiera.

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 (Datastores).

3. Cliquez sur Créer un datastore.

4. Sur la page Sélectionner une source de données, accédez à la section Sources tierces, puis sélectionnez Jira.

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 Jira de votre data store.

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.

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), 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. 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.

• Consultez Aperçu des résultats pour les applications avec contrôle des accès tiers.

Connecter Salesforce

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

Preview:les connecteurs tiers sont en version preview avec une liste d'autorisation. Vous devez figurer sur la liste d'autorisation pour pouvoir utiliser cette fonctionnalité.

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

Avant de 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 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 Vertex AI Search à l'aide de la console Google Cloud, procédez comme suit:

1. Ajoutez Google Cloud à votre liste d'autorisation CORS Salesforce. Si vous l'avez déjà fait, passez à l'étape suivante.

   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.

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

   Agent Builder

3. Dans le menu de navigation, cliquez sur Data stores (Datastores).

4. Cliquez sur Créer un datastore.

5. Sur la page Sélectionner une source de données, accédez à la section Sources tierces, puis sélectionnez Salesforce.

6. Saisissez vos informations d'authentification Salesforce.

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.

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), 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 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 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 ServiceNow

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

Preview:les connecteurs tiers sont en version preview avec une liste d'autorisation. Vous devez figurer sur la liste d'autorisation pour pouvoir utiliser cette fonctionnalité.

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

Avant de 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 suivantes:

  • URL d'instance au format https://<domain-name>.service-now.com/.
  • ID client et code secret du client Pour en savoir plus sur la configuration des points de terminaison et l'obtention de l'ID client et du code secret du 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ôles ServiceNow suivants:

    • Rôle Administrateur Consultez la section Rôles système de base dans la documentation ServiceNow.

    • Un rôle ServiceNow personnalisé Il s'agit d'une alternative à l'utilisation d'un rôle administrateur. Pour utiliser un rôle ServiceNow personnalisé, créez des règles de contrôle des accès avec les champs suivants:

      Afficher les champs

      • Type : record
      • Opération: read
      • Nom (une règle de contrôle des accès distincte est requise pour chacune):
      • incident
      • sc_cat_item
      • kb_knowledge
      • kb_knowledge_base
      • kb_uc_can_read_mtom
      • kb_uc_can_contribute_mtom
      • sys_user_role
      • sys_user_has_role
      • sys_user_group
      • sys_user_grmember
      • Rôle requis: nom du rôle personnalisé

      Pour en savoir plus, consultez les pages Créer un rôle et Créer une règle ACL dans la documentation 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 Data stores (Datastores).

3. Cliquez sur Créer un datastore.

4. Sur la page Sélectionner une source de données, accédez à la section Sources tierces, puis sélectionnez ServiceNow.

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 (Datastores).

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 de données pour en afficher les détails sur la page Data (Données). L'état du connecteur passe de Création à En cours d'exécution lorsqu'il commence à synchroniser les données. Lorsque l'ingestion est terminée, l'état passe à Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.

    Selon la taille de vos données, l'ingestion peut prendre 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 SharePoint Online

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

Preview:les connecteurs tiers sont en version preview avec une liste d'autorisation. Vous devez figurer sur la liste d'autorisation pour pouvoir utiliser cette fonctionnalité.

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

Avant de 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.

• Accordez le consentement 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 du 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.

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

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

    Afficher les champs d'application

    • GroupMember.Read.All
    • Sites.FullControl.All
    • User.Read.All

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

    Afficher les champs d'application

    • AllSites.FullControl

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

  Afficher les rôles

  Rôles	Enregistrement de l'application cliente	Peut extraire le contenu de toutes les entités	Peut récupérer la LCA	Peut récupérer l'identité	Remarques
  Administrateurs de site	Non	Oui	Oui	Oui
  Administrateur de la collection de sites	Non	Oui	Oui	Oui
  Administrateur global	Oui	Non	Oui	Non	Limite: Impossible d'extraire l'identité ni les entités "commentaire" et "pièce jointe"
  Propriétaire du site	Non	Oui	Oui	Non	Limite: impossible de récupérer l'identité
  Administrateur de l'application	Oui	Non disponible	N/A	N/A	Le rôle Administrateur de l'application est lié au Centre d'administration Microsoft 365 / Centre d'administration Entra. Il n'est pas spécifique à Sharepoint.

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 Data stores (Datastores).

3. Cliquez sur Créer un datastore.

4. Sur la page Sélectionner une source de données, accédez à la section Sources tierces, puis sélectionnez SharePoint Online.

5. Saisissez vos informations d'authentification SharePoint Online, 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 Sharepoint Online de votre data store.

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 (Datastores).

12. 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. 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 Créer une application de recherche.

• Consultez Aperçu des résultats pour les applications avec contrôle des accès tiers.

Connecter Slack

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

Preview:les connecteurs tiers sont en version preview avec une liste d'autorisation. Vous devez figurer sur la liste d'autorisation pour pouvoir utiliser cette fonctionnalité.

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

Avant de 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 des ID d'espace de travail, consultez la section Spécifier la source Slack de votre data store dans la documentation Slack.
  • Jeton d'accès. Pour en savoir plus sur la création d'une application cliente et la définition des champs d'application, consultez les pages Démarrage rapide et Obtenir et utiliser rapidement un jeton d'API Slack dans la documentation Slack.
  • Lorsque vous définissez des champs d'application d'autorisation OAuth 2.0, configurez les champs d'application suivants :

    Afficher les champs d'application

    • users:read.email
    • channels:history
    • channels:read
    • groups:history
    • groups:read
    • im:history
    • im:read
    • mpim:history
    • mpim:read
    • team:read
    • users:read
    • files:read

La limite suivante s'applique:

• Le comportement par défaut de Slack limite l'exploration et la synchronisation du contenu des canaux privés, des messages instantanés multiparties et des messages instantanés en tête-à-tête.

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 Data stores (Datastores).

3. Cliquez sur Créer un datastore.

4. Sur la page Sélectionner une source de données, accédez à la section Sources tierces, puis sélectionnez Slack.

5. Saisissez vos informations d'authentification Slack.

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 (Datastores).

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

• Consultez Aperçu des résultats pour les applications avec contrôle des accès tiers.

Connecter Dropbox

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

Preview:les connecteurs tiers sont en version preview avec une liste d'autorisation. Vous devez figurer sur la liste d'autorisation pour pouvoir utiliser cette fonctionnalité.

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

Avant de commencer

Avant de configurer votre connexion:

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

• 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 utiliser la console Google Cloud afin de synchroniser les données de Dropbox avec Vertex AI Search, procédez comme suit:

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

   Agent Builder

2. Dans le menu de navigation, cliquez sur Data stores (Datastores).

3. Cliquez sur Créer un datastore.

4. Sur la page Sélectionner une source de données, accédez à la section Sources tierces, puis sélectionnez Dropbox.

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

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

Connect Box

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

Preview:les connecteurs tiers sont en version preview avec une liste d'autorisation. Vous devez figurer sur la liste d'autorisation pour pouvoir utiliser cette fonctionnalité.

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

Avant de commencer

Avant de configurer votre connexion:

• 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 en savoir plus sur la configuration de ces paramètres, consultez Authentification JWT dans la documentation pour les développeurs Box.

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

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

  Afficher les champs d'application

  • root_readonly
  • root_readwrite
  • manage_managed_users
  • manage_app_users
  • manage_groups
  • manage_enterprise_properties
  • as_user
  • generate_access_token

Les limites suivantes s'appliquent :

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

Console

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

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

   Agent Builder

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

3. Cliquez sur Créer un datastore.

4. Sur la page Sélectionner une source de données, accédez à la section Sources tierces, puis sélectionnez Case.

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

Preview:les connecteurs tiers sont en version preview avec une liste d'autorisation. Vous devez figurer sur la liste d'autorisation pour pouvoir utiliser cette fonctionnalité.

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

Avant de commencer

Avant de configurer votre connexion:

• 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 OneDrive suivantes:

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

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

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

    Afficher les champs d'application

    • Files.Read.All Application
    • Group.Read.All Application
    • Sites.FullControl.All Application
    • User.Read Delegated
    • User.Read.All Application

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, accédez à la section Sources tierces, puis sélectionnez OneDrive.

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