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:

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

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.

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

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

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

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 suivantes. Pour savoir comment configurer l'ID client et le code secret du client dans Salesforce, consultez Configurer une application connectée pour le flux d'identifiants client OAuth 2.0 dans la documentation Salesforce.

  • URL de l'instance: nom de domaine de votre instance Salesforce. Recherchez Mon domaine, copiez le domaine se terminant par my.salesforce.com, puis ajoutez https:// au début.
  • ID client: copiez l'ID client de l'application connectée en cliquant sur Gérer les informations client. Si le jeton d'actualisation est activé, vérifiez qu'il est actualisé et fournissez le dernier jeton lorsque vous créez un data store.
  • Code secret du client: copiez le code secret de l'application connectée en cliquant sur Gérer les informations sur le client. Si le jeton d'actualisation est activé, vérifiez qu'il est actualisé et fournissez le dernier jeton lorsque vous créez un data store.

• Pour que les autorisations utilisateur s'appliquent correctement, les utilisateurs Salesforce doivent donner leur autorisation de partage.

• Utilisez un forfait Enterprise ou Developer. Les comptes d'essai ne sont pas acceptés.

• Assurez-vous d'utiliser Sales Cloud. Service Cloud n'est pas compatible.

• Ajoutez Google Cloud à la liste d'autorisation CORS de Salesforce. Si vous avez déjà effectué cette tâche, passez à la section "Créer une application".

  • Suivez les instructions de la documentation Salesforce pour configurer la liste d'autorisation CORS.
  • Saisissez https://console.cloud.google.com/ comme URL d'origine, puis enregistrez votre configuration.

Créer une application

Salesforce est compatible avec les applications suivantes:

1. Application associée
2. Application cliente externe.

Créer une application connectée

Pour configurer une application connectée dans Salesforce pour l'intégrer à Google Cloud, procédez comme suit:

1. Connectez-vous à Salesforce.
2. Cliquez sur l'icône en forme de roue dentée, puis accédez à Configuration.
3. Dans le menu Configuration, accédez à Gestionnaire d'applications.
4. Cliquez sur Nouvelle application connectée.

5. Pour configurer l'application connectée:

   a. Sur la page de création de l'application connectée, procédez comme suit:

   • Cochez la case Enable OAuth settings (Activer les paramètres OAuth).
   • Définissez l'URL de rappel sur https://vertexaisearch.cloud.google.com/console/oauth/salesforce_oauth.html.
   • Sélectionnez les habilitations OAuth suivantes :
     • Accès complet (full)
     • Effectuer des requêtes à tout moment (refresh_token, offline_access)

   b. Activez les flux:

   • Flux des identifiants client
   • Flux avec code d'autorisation et identifiants
   • Identifiants utilisateur dans le corps de la requête POST pour le code d'autorisation et le flux d'identifiants
   • Pour le flux des identifiants client, attribuez votre nom d'utilisateur dans le champ Exécuter en tant que. Vous devez disposer d'autorisations de lecture pour toutes les entités que votre connecteur peut extraire.

Après avoir créé l'application associée, procédez comme suit:

1. Modifier les règles relatives aux applications:

   • Accédez au Gestionnaire d'applications, puis modifiez l'application nouvellement créée.
   • Définissez IP Relaxation (Relaxe IP) sur Relax IP restrictions.
   • Configurez la stratégie de jeton de rafraîchissement sur Valid until revoked ou des paramètres plus restrictifs si nécessaire.
   • Vérifiez que Utilisateurs autorisés est défini sur All users may self-authorize.

2. Configurez les restrictions d'adresses IP:

   • Si l'option Application des plages d'adresses IP au niveau de l'organisation est activée, définissez Plages d'adresses IP approuvées sous Sécurité > Accès réseau. Pour en savoir plus, consultez la documentation sur la relaxation des adresses IP des applications connectées et l'application continue des adresses IP.
   • Désactivez Appliquer des plages d'adresses IP de connexion à chaque requête si aucune restriction d'adresse IP n'est requise.

3. Configurez une application connectée OAuth:

   • Utilisez les guides suivants pour configurer une application connectée OAuth :
     • Principes de base des applications associées
     • Intégration d'API
     • Configuration des identifiants client

4. Enregistrez l'application connectée:

   • Enregistrez et quittez l'application connectée.
   • Dans la barre de recherche, recherchez Paramètres OAuth et OpenId Connect.
   • Activez Autoriser les flux avec code d'autorisation et identifiants et Flux OAuth avec nom d'utilisateur et mot de passe.

Créer une application cliente externe

Pour créer et configurer une application cliente externe dans Salesforce afin d'activer l'authentification basée sur OAuth pour les intégrations, procédez comme suit:

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

   • Connectez-vous à Salesforce.
   • Cliquez sur l'icône en forme de roue dentée, puis accédez à Configuration.
   • Accédez à Configuration > Applications > Applications clientes externes.
   • Cliquez sur Nouvelle application cliente externe.

2. Fournissez les informations requises:

   • Saisissez le nom de l'application et votre adresse e-mail. Le nom de l'API est renseigné automatiquement par défaut.
   • Laissez le champ État de distribution sur Local.

3. Activez les paramètres OAuth:

   • Développez API (Activer les paramètres OAuth), puis sélectionnez Activer OAuth.
   • Configuration :
     • URL de rappel: https://login.salesforce.com/services/oauth2/callback
     • Champs d'application OAuth: gérez les données utilisateur via des API (api).
     • Dans Activation du flux, sélectionnez Activer le flux d'identifiants client.
     • Cliquez sur Créer pour créer l'application cliente externe. Accédez au gestionnaire d'applications clientes externes pour afficher l'application que vous avez ajoutée à la liste.

4. Modifier les règles relatives aux applications:

   • Ouvrez l'application créée.
   • Accédez à Stratégies, puis cliquez sur Modifier.
   • Dans Flux OAuth et améliorations des applications clientes externes, cochez Activer le flux d'identifiants client.
   • Saisissez votre nom d'utilisateur Salesforce dans le champ Exécuter en tant que.

5. Identifiants d'accès OAuth:

   • Cliquez sur Paramètres.
   • Cliquez sur Paramètres OAuth.
   • Cliquez sur Clé client et secret pour accéder aux identifiants. Le code de validation est envoyé à votre adresse e-mail.
   • Saisissez le code de validation, puis cliquez sur Valider.
   • Copiez la clé client et utilisez-la comme ID client.
   • Copiez le secret client et utilisez-le comme code secret du client.

Créer un connecteur Salesforce

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

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.

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

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.

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

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

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

• Préparez les informations d'authentification Slack suivantes:

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

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

Générer un jeton de bot

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 du robot ne peut pas explorer les canaux publics dont il ne fait pas partie, et l'ajout de canaux publics génère un message d'ajout.

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:

   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

   Par défaut, le bot lit les canaux #general et #random. Pour activer l'exploration, procédez comme suit:

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

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

Générer un jeton utilisateur

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

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

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

   Afficher les champs d'application

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

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

É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 Dropbox

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

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

Avant de commencer

Avant de configurer votre connexion:

• 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

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

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

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

Créer une application Box

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

Configurer l'application Box

Configurez les paramètres de votre application Box.

Créer une clé publique/privée

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

2. Dans l'onglet Configuration, cliquez sur Generate a Public/Private Keypair (Générer une paire de clés publique/privée).

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

Configurer les autorisations requises

1. Dans la section Champs d'application, sélectionnez l'autorisation suivante :
   • Lire tous les fichiers et dossiers stockés dans Box

Autoriser l'application

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

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

Créer un connecteur Box

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

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