Connecter une source de données tierce

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

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

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

Les connecteurs tiers ne sont pas compatibles avec les CMEK.

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

Avant de commencer

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

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

Associer Adobe Experience Manager

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

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

Avant de commencer

Avant de configurer votre connexion:

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

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

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

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

Créer un connecteur Adobe Experience Manager

Console

Pour utiliser la console Google Cloud afin de synchroniser les données d'Adobe Experience Manager 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 Adobe Experience Manager.

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

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

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

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

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

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

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

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

Étapes suivantes

Connecter AODocs

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

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

Avant de commencer

Avant de configurer votre connexion:

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

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

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

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

Créer un connecteur AODocs

Console

Pour utiliser la console Google Cloud afin de synchroniser les données d'AODocs 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 AODocs.

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

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

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

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

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

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

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

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

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

Étapes suivantes

Connect Box

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

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

Avant de commencer

Avant de configurer votre connexion:

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

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

Console

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

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

    Agent Builder

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

  3. Cliquez sur Créer un datastore.

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

  5. Saisissez vos informations d'authentification.

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

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

  8. Attribuez un nom à votre datastore.

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

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

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

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

Étapes suivantes

Connect Coda

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

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

Avant de commencer

Avant de configurer votre connexion:

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

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

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

    • Jeton d'API Coda.

Créer un connecteur Coda

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de Coda 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 Coda.

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

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

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

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

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

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

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

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

Étapes suivantes

Connecter Confluence Cloud

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

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

Avant de commencer

Avant de configurer votre connexion:

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

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

Configurer l'authentification et les autorisations dans Confluence

Suivez les instructions des sections suivantes pour vous assurer de disposer des informations d'authentification nécessaires et d'un accès administrateur à votre instance Confluence. 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. Récupérez l'URL et l'ID de votre instance, configurez des rôles et authentifiez-vous pour synchroniser les données entre Confluence Cloud et Vertex AI Search.

- Instance ID. This is the `cloudid` and is available on
  <code>https://<var>EXAMPLE</var>.atlassian.net/_edge/tenant_info</code>
  and copying the value of `cloudId`.
  • Activez OAuth 2.0, puis obtenez l'ID client et le code secret.
    • Accédez à l'API Confluence.
    • Cliquez sur Ajouter.

    • Cliquez sur Configurer.

      b. Accédez à l'onglet Champs d'application précis, puis cliquez sur Modifier les champs d'application. Sélectionnez les champs d'application suivants:

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

  1. Cliquez sur Distribution.

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

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

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

Récupérer l'URL et l'ID d'instance

Obtenez l'URL de l'instance:

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

Obtenez l'ID d'instance:

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

Configurer les autorisations et les rôles

Pour attribuer le rôle d'éditeur du moteur de découverte à un administrateur Confluence, procédez comme suit:

  1. Accédez au site de votre domaine Atlassian et ouvrez l'instance Confluence Cloud.
  2. Accédez à IAM .
  3. Attribuez le rôle de moteur de découverte à l'administrateur Confluence. L'administrateur Confluence peut ainsi configurer le connecteur comme décrit dans Créer un connecteur Confluence Cloud.

Pour attribuer le rôle d'administrateur à un utilisateur, procédez comme suit:

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

Pour configurer les autorisations dans Atlassian, procédez comme suit:

  1. Accédez au site de votre domaine Atlassian et ouvrez l'instance Confluence Cloud.
  2. Cliquez sur l'icône de menu, puis sélectionnez l'option requise.
  3. (Facultatif) Si vous y êtes invité, sélectionnez l'organisation appropriée sur la page de destination.

Pour créer et configurer des groupes, procédez comme suit:

  1. Sur la page Administrateur, cliquez sur le bouton Gérer les utilisateurs (si nécessaire).
    • Sélectionnez Gérer les utilisateurs dans la liste déroulante.
  2. Sur la page Gestion des utilisateurs, sélectionnez Groupes.
  3. Cliquez sur Créer un groupe et attribuez-lui un nom.
    • Utilisez ce groupe pour attribuer les autorisations requises par le connecteur.
  4. Ajoutez des autorisations au groupe: attribuez le rôle Administrateur de l'accès des utilisateurs.

Pour attribuer des membres au groupe, procédez comme suit:

  1. Sur la page Groupe, cliquez sur Ajouter un produit, puis sélectionnez le rôle de produit approprié :
    • Administrateur des accès utilisateur
  2. Cliquez sur Ajouter pour confirmer l'attribution du rôle.
  3. Cliquez sur Ajouter des membres du groupe pour inclure des comptes utilisateur ou des membres du groupe.
    • Assurez-vous que le connecteur s'authentifie pour le compte de ces utilisateurs afin d'extraire des documents.

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

Créer un connecteur Confluence Cloud

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de Confluence Cloud 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 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 des minutes ou des heures.

Étapes suivantes

Connecter Confluence Data Center sur site

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

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

Avant de commencer

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

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

Consignes de configuration pour Private Service Connect

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

  • Configuration réseau:

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

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

  • Règles de pare-feu :

    a. Règles d'Ingress:

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

    b. Règles de sortie:

    • Activez le trafic sortant par défaut, sauf si des règles de refus spécifiques s'appliquent.

Autres considérations:

  • Assurez-vous de placer tous les composants, y compris le rattachement de service PSC et l'équilibreur de charge, dans la même région.

Générer un rattachement de service

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

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

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

  3. Pour le point de terminaison privé:

    a. Utilisez Private Service Connect (PSC) pour autoriser les connexions depuis des instances privées vers Google Cloud.

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

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

    d. (Facultatif) Configurez une sonde de vérification de l'état pour surveiller l'état du backend.

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

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

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

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

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

Se connecter en tant qu'administrateur
  1. Accédez au site de votre domaine Atlassian et ouvrez l'instance Confluence Data Center.
  2. Saisissez le nom et le mot de passe de l'administrateur.
  3. Cliquez sur Connexion.
Créer un utilisateur

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

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

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

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

Configurer l'espace de documentation

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

Créer un connecteur sur site pour Confluence Data Center

Configurez un connecteur sur site Confluence Data Center pour synchroniser les données avec Google Cloud. Commencez par créer un data store dans l'Agent Builder, puis configurez les paramètres de connexion, y compris les préférences d'authentification et de synchronisation.

#### Créer un connecteur sur site pour Confluence Data Center

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de Confluence Cloud 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 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 des minutes ou des heures.

Étapes suivantes

Connecter Dropbox

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

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

Avant de commencer

Avant de configurer votre connexion:

  • 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 des minutes ou des heures.

Étapes suivantes

Connecter Dynamics 365

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

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

Avant de commencer

Avant de créer un connecteur Dynamics 365:

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

    • ID client
    • Code secret du client
    • Locataire Azure
    • URL de l'organisation. Par exemple, https://abc123.cloudax.dynamics.com/.

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

Créer un connecteur Dynamics 365

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de Dynamics 365 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 Dynamics 365.

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

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

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

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

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

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

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

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

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

Étapes suivantes

Connecter GitHub

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

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

Avant de commencer

Avant de configurer votre connexion:

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

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

  • Un administrateur GitHub doit obtenir les éléments suivants pour l'intégration à la recherche Vertex AI:

    • Jeton d'accès personnel de l'instance GitHub.

Créer un connecteur GitHub

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de GitHub 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 GitHub.

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

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

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

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

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

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

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

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

Étapes suivantes

Connecter GitLab

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

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

Avant de commencer

Avant de configurer votre connexion:

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

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

  • Un administrateur GitLab doit obtenir les éléments suivants pour intégrer Vertex AI Search:

    • Jeton d'accès personnel de l'instance GitLab.

Créer un connecteur GitLab

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de GitLab 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électionnez une source de données, accédez à la section Sources tierces, puis sélectionnez GitLab.

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

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

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

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

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

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

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

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

Étapes suivantes

Connecter Jira Cloud

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

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

Avant de commencer

Avant de configurer votre connexion:

  • Vérifiez que vous disposez d'un accès administrateur à l'instance Jira et au projet.
  • 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.

Configurer l'authentification et les autorisations dans Jira

Suivez les instructions des sections suivantes pour vous assurer de disposer des informations d'authentification nécessaires et d'un accès administrateur à 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. 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

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

Pour créer une intégration OAuth 2.0 dans la console Atlassian Developer Console, procédez comme suit:

  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. Saisissez un nom pour l'application.

    • Cochez la case des conditions d'utilisation.
    • Cliquez sur Créer.
    • Cliquez sur Autorisation.
    • Dans le tableau Type d'autorisation, sélectionnez Ajouter pour OAuth 2.0 (3LO).

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

  6. Cliquez sur Enregistrer les modifications.

Si l'avertissement Votre application ne contient aucune API s'affiche, Pour ajouter des API à votre application, procédez comme suit:

  1. Sélectionnez Autorisations:

    • Accédez à l'API Jira.
    • Cliquez sur Ajouter.
    • Cliquez sur Configurer.
    • Accédez à l'onglet Champs d'application classiques, puis cliquez sur Modifier les champs d'application. Sélectionnez les portées suivantes :

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

  2. Cliquez sur Distribution.

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

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

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

Récupérer l'URL et l'ID d'instance

Obtenez l'URL de l'instance:

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

Obtenez l'ID d'instance:

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

Configurer les autorisations et les rôles

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

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

Créer un connecteur Jira Cloud

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de Jira Cloud 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, faites défiler la page ou recherchez Jira pour connecter votre source tierce.

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

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

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

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

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

  10. Attribuez un nom à votre datastore.

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

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

  13. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores), 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 des minutes ou des heures.

Étapes suivantes

Connecter Jira Data Center sur site

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

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

Avant de commencer

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

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

Consignes de configuration pour Private Service Connect

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

  • Configuration réseau:

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

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

  • Règles de pare-feu :

    a. Règles d'Ingress:

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

    b. Règles de sortie:

    • Activez le trafic sortant par défaut, sauf si des règles de refus spécifiques s'appliquent.

Autres considérations:

  • Assurez-vous de placer tous les composants, y compris le rattachement de service PSC et l'équilibreur de charge, dans la même région.

Générer un rattachement de service

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

  1. Choisissez le type de point de terminaison: sélectionnez Public ou Privé.

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

  3. Pour le point de terminaison privé:

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

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

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

    d. (Facultatif) Configurez une sonde de vérification de l'état pour surveiller l'état du backend.

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

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

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

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

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

Se connecter en tant qu'administrateur
  1. Accédez au site de votre domaine Atlassian et ouvrez l'instance Jira Data Center.
  2. Saisissez le nom et le mot de passe de l'administrateur.
  3. Cliquez sur Connexion.
Créer un utilisateur

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

  1. Cliquez sur l'icône des paramètres.
  2. Sélectionnez Gestion des utilisateurs.
  3. Saisissez les identifiants administrateur, si vous y êtes invité.
  4. Sur la page Administration, cliquez sur Créer un utilisateur.
  5. Saisissez l'adresse e-mail, le nom complet, le nom d'utilisateur et le mot de passe.
  6. Cliquez sur Créer un utilisateur.
Attribuer un utilisateur à un groupe
  1. Sur la page Administration, sous Gestion des utilisateurs, cliquez sur Groupes.
  2. Créez un groupe en saisissant un nom, puis en cliquant sur Ajouter un groupe.
  3. Sélectionnez le groupe nouvellement créé.
  4. Cliquez sur Ajouter/Supprimer des utilisateurs.
  5. Cliquez sur l'icône de membre à côté de la zone Ajouter des membres aux groupes sélectionnés.
  6. Sélectionnez l'utilisateur que vous venez de créer, puis cliquez sur Enregistrer la sélection.
  7. Cliquez sur Ajouter l'utilisateur sélectionné pour afficher les nouveaux utilisateurs dans la section "Membres du groupe".

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

Configurer les autorisations des utilisateurs
  1. Sur la page Administration, accédez à l'onglet Problèmes.
  2. Sélectionnez Schémas d'autorisation.
  3. Cliquez sur Ajouter un schéma d'autorisations.
  4. Attribuez un nom au schéma, puis cliquez sur Ajouter.
  5. Sélectionnez le schéma, puis cliquez sur l'icône Autorisation.
  6. Cliquez sur Accorder l'autorisation.
  7. Ajoutez les autorisations suivantes, attribuez-les au groupe créé précédemment, puis cliquez sur Accorder :
    • Parcourir les projets
    • Parcourir l'archive des projets

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

Configurer l'accès des applications

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

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

Créer un connecteur sur site pour Jira Data Center

Configurez un connecteur sur site Jira Data Center pour synchroniser les données avec Google Cloud. Commencez par créer un data store dans l'Agent Builder, puis configurez les paramètres de connexion, y compris les préférences d'authentification et de synchronisation.

Créer un connecteur sur site Jira Data Center

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de Jira Cloud 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, faites défiler la page ou recherchez Jira pour connecter votre source tierce.

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

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

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

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

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

  10. Attribuez un nom à votre datastore.

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

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

  13. Pour vérifier l'état de votre ingestion, accédez à la page Data stores (Data stores), 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 des minutes ou des heures.

Étapes suivantes

Connecter Microsoft Outlook

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

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

Avant de commencer

Avant de configurer votre connexion:

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

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

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

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

Créer un connecteur Microsoft Outlook

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de Microsoft Outlook 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 Microsoft Outlook.

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

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

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

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

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

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

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

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

Étapes suivantes

Connecter Microsoft Teams

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

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

Avant de commencer

Avant de configurer votre connexion:

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

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

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

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

Créer un connecteur Microsoft Teams

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de Microsoft Teams 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 Microsoft Teams.

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

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

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

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

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

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

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

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

Étapes suivantes

Connecter Notion

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

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

Avant de commencer

Avant de configurer votre connecteur:

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

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

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

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

Créer un connecteur Notion

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de Notion 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 Notion.

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

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

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

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

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

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

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

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

Étapes suivantes

Connecter OneDrive

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

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

Avant de commencer

Avant de configurer votre connexion:

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de OneDrive 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 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 des minutes ou des heures.

Étapes suivantes

Connecter Salesforce

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

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

Avant de commencer

Avant de configurer votre connexion:

  • 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 associé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.
    • Assurez-vous que Utilisateurs autorisés est défini sur All users may self-authorize.

  2. Configurez les restrictions d'adresses IP:

  3. Configurez une application connectée OAuth:

  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

Console

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

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

    Agent Builder

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

  3. Cliquez sur Créer un datastore.

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

  5. Saisissez vos informations d'authentification Salesforce.

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

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

  8. Attribuez un nom à votre datastore.

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

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

  11. Pour vérifier l'état de l'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 des minutes ou des heures.

Étapes suivantes

Connecter ServiceNow

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

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

Avant de commencer

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

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

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

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

Configurer ServiceNow

ServiceNow propose deux sites principaux:

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

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

  2. Site pour les développeurs:

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

Créer un point de terminaison OAuth

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

  4. Renseignez les informations requises:

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

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

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

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

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

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

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

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

Configurer les rôles et les autorisations

Vous devez disposer d'un rôle Administrateur de la sécurité pour créer et gérer des utilisateurs. Si vous ne disposez pas de ce rôle, procédez comme suit:

  1. Passez au rôle security_admin en cliquant sur Élever le rôle sous votre profil.

  2. Sélectionnez le rôle security_admin, puis cliquez sur Mettre à jour. Le rôle security_admin est requis pour créer des rôles et gérer des utilisateurs.

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

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

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

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

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

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

Attribuer le rôle à un compte de service

  1. Accédez à Tout > Gestion des utilisateurs > Utilisateurs, puis sélectionnez l'utilisateur.
  2. Recherchez l'utilisateur auquel attribuer le rôle, puis sélectionnez-le.
  3. Si aucun utilisateur n'est disponible, accédez à Sécurité du système > Utilisateurs et groupes > Utilisateurs.
  4. Cliquez sur New (Nouveau) pour créer un compte de service dans la table User (Utilisateur).
  5. Veillez à cocher la case Accès au service Web uniquement.
  6. Accédez au tableau Rôles en bas de la page.
  7. Cliquez sur Modifier à droite.
  8. Accordez le rôle créé précédemment et attribuez-le à l'utilisateur. Selon le type de rôle créé, sélectionnez celui qui convient et attribuez-le.
  9. Obtenez le nom d'utilisateur et le mot de passe de l'utilisateur. Sur la même page, cliquez sur Définir un mot de passe.

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

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

Configurer le pool d'employés

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

Créer un connecteur ServiceNow

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de ServiceNow 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 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 (Data stores).

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

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

Étapes suivantes

Connecter SharePoint Online

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

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

Avant de 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 le consentement, consultez la section Accorder le consentement d'un administrateur au niveau du locataire pour 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:

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

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

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de Sharepoint Online 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 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 des minutes ou des heures.

Étapes suivantes

Associer Slack

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

Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le 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 :

  • 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 à partir de 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 rejoindre des canaux publics génère un message de participation.

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

  7. Sous Champs d'application des jetons de bot, ajoutez les champs d'application obligatoires suivants:

    Par défaut, le bot lit les canaux #general et #random. 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:

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

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

Créer un connecteur Slack Cloud

Console

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

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

    Agent Builder

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

  3. Cliquez sur Créer un datastore.

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

  5. Saisissez vos informations d'authentification Slack.

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

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

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

  8. Attribuez un nom à votre datastore.

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

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

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

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

Étapes suivantes

Associer Trello

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

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

Avant de commencer

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

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

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

Un administrateur Trello doit suivre les étapes suivantes:

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

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

Créer un connecteur Trello

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de Trello 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 Trello.

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

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

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

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

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

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

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

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

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

Étapes suivantes

Connect Workday

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

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

Avant de commencer

Avant de créer un connecteur Workday:

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

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

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

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

Créer un connecteur Workday

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de Workday 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 Jour ouvré.

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

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

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

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

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

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

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

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

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

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

Étapes suivantes

Connecter Zendesk

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

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

Avant de commencer

Avant de configurer votre connexion:

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

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

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

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

Créer un connecteur Zendesk

Console

Pour utiliser la console Google Cloud afin de synchroniser les données de Zendesk 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 Zendesk.

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

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

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

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

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

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

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

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

Étapes suivantes