Premiers pas avec la recherche générique

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 du site Web provenant de l'exploration 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.

Remarque : Ce tutoriel concerne Vertex AI Search. Pour commencer à utiliser les agents Vertex AI, consultez Atelier de programmation: Créer une application de chat générative

---

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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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

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 à partir de 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.

   Agent Builder : 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 à partir de 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. Dans le volet Sélectionner le type d'application, sélectionnez Recherche.

3. Assurez-vous que le contenu est Générique et que les Fonctionnalités d'entreprise 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 recherche sur 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. Dans le volet Sélectionner le type d'application, sélectionnez Recherche.

3. Assurez-vous que le contenu est Générique et que les Fonctionnalités d'entreprise 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 recherche dans 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. Dans le volet Sélectionner le type d'application, sélectionnez Recherche.

3. Assurez-vous que le contenu est Générique et que les Fonctionnalités d'entreprise 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 des recherches dans 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 Actualisez 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 des films liés aux 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, 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 à la saisie semi-automatique.

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

5. Accédez à l'onglet Avancé 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". Veillez à cliquer sur Save and publish (Enregistrer et publier) pour que les modifications soient appliquées au 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

• Présentation de Vertex AI Search
• À propos des données, des data stores et des moteurs