Premiers pas avec la recherche générique

Vertex AI Search combine la puissance de la récupération approfondie d'informations, d'une technologie de pointe de traitement du langage naturel et des toutes dernières fonctionnalités de traitement des grands modèles de langage pour comprendre l'intention de l'utilisateur et renvoyer les résultats qui sont les plus pertinents pour lui.

Avec Vertex AI Search, vous pouvez créer des applications de recherche et de recommandations. Vertex AI Search offre également des fonctionnalités spéciales pour certains secteurs, comme les médias, la santé et le commerce.

Ce tutoriel porte sur la création d'une application de recherche pour des données génériques, c'est-à-dire des données qui ne sont pas spécifiques à un secteur d'activité.

Ce tutoriel explique comment créer des applications de recherche pour différents types de données :

  • Données de site Web issues de l'exploration de cloud.google.com/generative-ai-app-builder/
  • données structurées sous la forme d'un ensemble de données au format NDJSON ingérées à partir d'un bucket Cloud Storage ;
  • données non structurées sous forme de PDF ingérés à partir d'un bucket Cloud Storage.

Avant de suivre ce tutoriel, assurez-vous d'avoir effectué les étapes de la section Avant de commencer.

Pour obtenir des instructions détaillées sur cette tâche directement dans la console Google Cloud, cliquez sur Visite guidée :

Visite guidée

Avant de commencer

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI Agent Builder (Discovery Engine), BigQuery, Cloud Storage APIs.

    Enable the APIs

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI Agent Builder (Discovery Engine), BigQuery, Cloud Storage APIs.

    Enable the APIs

    8.

Activer Vertex AI Agent Builder

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

    Agent Builder

  2. Lisez et acceptez les conditions d'utilisation, puis cliquez sur Continuer et activer l'API.

Créer un datastore

Commencez par créer un datastore contenant les données que votre application de recherche indexera.

Cliquez sur l'onglet correspondant au type de données que vous souhaitez placer dans votre datastore : site Web, données structurées ou non structurées.

Données de site Web

  1. Accédez à la page Créer un datastore.

    Générateur d'agents : créer un data store

  2. Dans le volet Sélectionner une source de données, choisissez Contenu de site Web.

  3. Dans le volet Spécifier les sites Web de votre datastore, assurez-vous que l'option Indexation avancée de sites Web est désactivée.

  4. Dans le champ Sites à inclure, saisissez :

    cloud.google.com/generative-ai-app-builder/*

  5. Cliquez sur Continuer.

  6. Dans le volet Configurer votre data store, sélectionnez global (Global) comme emplacement pour votre datastore.

  7. Attribuez un nom à votre datastore. Notez l'ID généré. Vous en aurez besoin plus tard.

  8. Cliquez sur Créer.

Données structurées

  1. Accédez à la page Créer un datastore.

    Générateur d'agents : créer un data store

  2. Dans le volet Sélectionner une source de données, choisissez Cloud Storage.

  3. Dans le volet Importer des données depuis Cloud Storage, sélectionnez Données structurées (JSONL).

  4. Assurez-vous que l'option Fichier est sélectionnée.

  5. Dans le champ gs://, saisissez la valeur suivante :

    cloud-samples-data/gen-app-builder/search/kaggle_movies/movie_metadata.ndjson

    Ce bucket Cloud Storage contient un fichier de films au format NDJSON mis à disposition par Kaggle.

  6. Cliquez sur Continuer.

  7. Attribuez les propriétés clés comme suit :

    Nom du champ Propriété de la clé
    homepage uri
    overview description

    Cliquez ensuite sur Continuer.

  8. Dans le volet Configurer votre data store, sélectionnez global (Global) comme emplacement pour votre datastore.

  9. Attribuez un nom à votre datastore. Notez l'ID généré. Vous en aurez besoin plus tard.

  10. Cliquez sur Créer.

Données non structurées

  1. Accédez à la page Créer un datastore.

    Générateur d'agents : créer un data store

  2. Dans le volet Sélectionner une source de données, choisissez Cloud Storage.

  3. Dans le volet Importer des données depuis Cloud Storage, sélectionnez Documents non structurés (PDF, HTML, TXT, etc.).

  4. Assurez-vous que l'option Dossier est sélectionnée.

  5. Dans le champ gs://, saisissez la valeur suivante :

    cloud-samples-data/gen-app-builder/search/alphabet-investor-pdfs

    Ce bucket Cloud Storage contient des rapports au format PDF sur les revenus tirés du site pour les investisseurs d'Alphabet.

  6. Dans le volet Configurer votre data store, sélectionnez global (Global) comme emplacement pour votre datastore.

  7. Attribuez un nom à votre datastore. Notez l'ID généré. Vous en aurez besoin plus tard.

  8. Cliquez sur Créer.

Créer une application de recherche

Vous allez ensuite créer une application de recherche et associer le datastore que vous avez créé précédemment.

Données de site Web

  1. Accédez à la page Créer une application.

    Agent Builder : créer une application

  2. Sous Rechercher votre site Web, cliquez sur Créer.

  3. Assurez-vous que les fonctionnalités de l'édition Enterprise sont activées.

  4. Dans le champ Nom de votre application, saisissez le nom de votre application. L'identifiant de l'application figure sous le nom de l'application.

  5. Dans le champ Nom externe de votre entreprise ou organisation, saisissez le nom de l'entreprise ou de l'organisation. Pour ce tutoriel, vous pouvez utiliser Google Cloud, car l'application va rechercher un site Web Google Cloud.

  6. Sélectionnez global (Global) comme emplacement pour votre application, puis cliquez sur Continuer.

  7. Dans la liste des datastores, sélectionnez celui que vous avez créé précédemment, puis cliquez sur Créer.

  8. Accédez à la page Données de votre application pour afficher la liste des sites Web indexés et les modifier si nécessaire.

Données structurées

  1. Accédez à la page Créer une application.

    Agent Builder : créer une application

  2. Sous Rechercher votre site Web, cliquez sur Créer.

  3. Assurez-vous que les fonctionnalités de l'édition Enterprise sont activées.

  4. Dans le champ Nom de votre application, saisissez le nom de votre application. L'identifiant de l'application figure sous le nom de l'application.

  5. Dans le champ Nom externe de votre entreprise ou organisation, saisissez le nom de l'entreprise ou de l'organisation. Pour ce tutoriel, vous pouvez utiliser Cymbal Cinemas, car l'application va rechercher un datastore de films.

  6. Sélectionnez global (Global) comme emplacement pour votre application, puis cliquez sur Continuer.

  7. Dans la liste des datastores, sélectionnez celui que vous avez créé précédemment, puis cliquez sur Créer.

  8. Sur la page Données de votre datastore, cliquez sur l'onglet Activité pour consulter l'état de l'ingestion de vos données. Une fois le processus d'importation terminé, la mention Importation terminée s'affiche dans la colonne État. Pour cet ensemble de données, cette opération prend généralement deux à trois minutes. Vous devrez peut-être cliquer sur Refresh (Actualiser) pour afficher Import completed (Importation terminée).

  9. Cliquez sur l'onglet Documents pour afficher le nombre de documents importés.

Données non structurées

  1. Accédez à la page Créer une application.

    Agent Builder : créer une application

  2. Sous Rechercher votre site Web, cliquez sur Créer.

  3. Assurez-vous que les fonctionnalités Enterprise sont activées.

  4. Dans le champ Nom de votre application, saisissez le nom de votre application. L'identifiant de l'application figure sous le nom de l'application.

  5. Dans le champ Nom externe de votre entreprise ou organisation, saisissez le nom de l'entreprise ou de l'organisation. Pour ce tutoriel, vous pouvez utiliser Alphabet, car l'application effectuera une recherche sur les documents Alphabet.

  6. Sélectionnez global (Global) comme emplacement pour votre application, puis cliquez sur Continuer.

  7. Dans la liste des datastores, sélectionnez celui que vous avez créé précédemment, puis cliquez sur Créer.

  8. Sur la page Données de votre datastore, cliquez sur l'onglet Activité pour consulter l'état de l'ingestion de vos données. Une fois le processus d'importation terminé, la colonne État affiche Importation terminée. Pour cet ensemble de données, le processus d'importation prend généralement deux à trois minutes. Vous devrez peut-être cliquer sur Actualiser pour afficher l'état Importation terminée.

  9. Cliquez sur l'onglet Documents pour afficher le nombre de documents importés.

Prévisualiser votre application

Données de site Web

  1. Sur la page Applications, cliquez sur le nom de votre nouvelle application.

  2. Dans le menu de navigation, cliquez sur Aperçu pour tester l'application.

  3. Facultatif : Cliquez sur les icônes d'affichage pour basculer entre l'affichage sur mobile et l'affichage sur ordinateur.

  4. Dans la barre de recherche, recherchez Vertex AI Search pour afficher les résultats concernant ce produit.

Données structurées

  1. Sur la page Applications, cliquez sur le nom de votre nouvelle application.

  2. Dans le menu de navigation, cliquez sur Aperçu pour tester l'application.

  3. Facultatif : Cliquez sur les icônes d'affichage pour basculer entre l'affichage sur mobile et l'affichage sur ordinateur.

  4. Dans la barre de recherche, saisissez trains, puis appuyez sur Entrée pour obtenir les résultats concernant les films sur les trains.

Données non structurées

  1. Sur la page Applications, cliquez sur le nom de votre nouvelle application.

  2. Dans le menu de navigation, cliquez sur Aperçu pour tester l'application.

  3. Facultatif : Cliquez sur les icônes d'affichage pour basculer entre l'affichage sur mobile et l'affichage sur ordinateur.

  4. Dans la barre de recherche, saisissez Google, puis appuyez sur Entrée pour afficher les résultats.

Configurer le widget Recherche

  1. Dans le menu de navigation, cliquez sur Configurations.

  2. Dans l'onglet UI (interface utilisateur), configurez les paramètres de l'application de recherche.

    Différentes configurations d'interface utilisateur sont disponibles en fonction des types de données. Pour en savoir plus, consultez Configurer les résultats du widget Recherche.

  3. Si vous modifiez les configurations dans l'onglet UI (Interface utilisateur), cliquez sur Enregistrer et publier.

  4. Accédez à l'onglet Saisie semi-automatique pour configurer des paramètres spécifiques pour la saisie semi-automatique.

    Pour en savoir plus, consultez Configurer la saisie semi-automatique.

  5. Accédez à l'onglet Paramètres avancés pour configurer les fonctionnalités avancées.

    Pour en savoir plus, consultez À propos des fonctionnalités avancées.

Déployer une application de recherche

  1. Sur la page Applications, cliquez sur le nom de l'application que vous souhaitez déployer.

  2. Dans le menu de navigation, cliquez sur Intégration.

  3. Assurez-vous que l'onglet Widget est sélectionné.

  4. Sélectionnez le type d'autorisation de widget Basé sur JWT ou OAuth.

  5. Dans le champ Domaine, saisissez le nom de domaine de la page Web sur laquelle vous allez placer le widget. Par exemple, si vous souhaitez copier le widget sur la page Web example.com/ai.html, saisissez example.com comme domaine.

  6. Cliquez sur Ajouter, puis sur Enregistrer.

  7. Copiez l'extrait de code fourni dans la section Copier le code suivant dans votre application Web.

  8. Dans votre codebase, générez un jeton d'autorisation.

  9. Pour transmettre le jeton d'autorisation à votre widget, utilisez l'extrait de code "Définir le jeton d'autorisation" fourni dans la section Copier le code suivant dans votre application Web et remplacez le texte <JWT or OAuth token provided by your backend> avec votre jeton d'autorisation.

  10. Testez l'application déployée. Vous pouvez ajuster davantage la configuration en suivant la procédure de la section "Configurer le widget Recherche". N'oubliez pas de cliquer sur Enregistrer et publier pour que les modifications prennent effet sur le widget déployé.

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Google Cloud, procédez comme suit :

  1. Pour éviter des frais Google Cloud inutiles, supprimez votre projet à l'aide de la console Google Cloud si vous n'en avez plus besoin.
  2. Si vous avez créé un projet pour apprendre à utiliser les instances Vertex AI Agent Builder et que vous n'en avez plus besoin, supprimez-le.
  3. Si vous avez utilisé un projet Google Cloud existant, supprimez les ressources que vous avez créées pour éviter que des frais ne soient facturés sur votre compte. Pour en savoir plus, consultez la section Supprimer une application.
  4. Suivez la procédure décrite dans Désactiver Vertex AI Agent Builder.

Étape suivante