Si vous débutez avec Vertex AI Agent Builder, nous vous recommandons de suivre le tutoriel Premiers pas avec la recherche générique pour créer un exemple d'application de données de site Web.
Choisir entre la recherche de base sur le site Web et l'indexation avancée de site Web
Vertex AI Agent Builder propose deux types de datastores de sites Web: la recherche de base sur les sites Web et l'indexation avancée des sites Web.
Vous pouvez choisir d'activer l'indexation avancée de sites Web pour indexer les pages Web de votre datastore de données de recherche. L'indexation avancée de site Web nécessite une validation du domaine et offre plusieurs fonctionnalités supplémentaires par rapport à la recherche de base sur un site Web. Pour en savoir plus, consultez la page Indexation avancée de sites Web.
Selon le type de data store de site Web dont vous avez besoin pour vos besoins métier, sélectionnez l'une des checklists suivantes:
Configurez un projet Google Cloud , activez Vertex AI Agent Builder et configurez le contrôle des accès pour votre projet. Vous pouvez utiliser un projet Google Cloud existant si vous en avez déjà un.
Actions
- Consultez la page Avant de commencer et vérifiez que vous avez suivi la procédure.
Découvrez le comportement d'une application de recherche sur un site Web (un type d'application de recherche générique) et les conditions préalables à l'inclusion de sites Web dans un entrepôt de données de site Web.
Actions
Consultez les informations sur la relation entre les applications génériques et les data stores dans la section À propos des applications et des data stores, ainsi que sur les données du site Web. Lorsque l'indexation avancée de sites Web est activée pour un data store, vous pouvez l'utiliser pour la recherche combinée, où plusieurs data stores sont connectés à une application.
Préparez les données de votre site Web conformément aux exigences de la section Données du site Web.
Créez un data store en fournissant les formats d'URL de site Web à inclure et les formats d'URL à exclure. Le processus de création d'un datastore implique des étapes pour activer l'indexation avancée de sites Web, qui nécessite une validation du domaine.
Actions
Suivez les instructions de la page Créer un data store à l'aide d'URL de site Web.
Si la création du data store et la validation du domaine aboutissent, Vertex AI Agent Builder génère un indice initial, qui est automatiquement actualisé dans la mesure du possible.
L'indexation initiale peut prendre plusieurs heures.
Facultatif: Créez un data store qui vous permet d'effectuer l'indexation et l'actualisation uniquement à partir des sitemaps. Pour ce faire, suivez les instructions de la section Activer l'actualisation par sitemap uniquement dans un data store.
Pour comprendre l'indexation et l'actualisation basées sur un sitemap, consultez Indexer et actualiser des pages Web à l'aide d'un sitemap.
Créez votre application de recherche sur votre site Web et associez-la à votre nouveau data store.
Actions
- Créez une application de recherche. Veillez à activer l'édition Enterprise.
Vertex AI Search propose de nombreuses options de configuration. Certaines options dépendent de votre intention de déployer un widget de recherche.
Actions
Selon votre cas d'utilisation et si vous prévoyez de déployer le widget de recherche prêt à l'emploi ou d'intégrer des appels d'API de recherche à votre propre code, Vertex AI Search propose plusieurs options de configuration.
Vous pouvez intégrer un widget de recherche à votre site Web. Il fournit automatiquement une barre de recherche et une interface de recherche extensible. Si vous prévoyez de déployer le widget de recherche, configurez les éléments suivants:
Résultats du widget de recherche. Consultez Configurer les résultats du widget Recherche.
Facettes du widget de recherche (version Preview). Consultez Configurer les facettes pour le widget Recherche.
Saisie semi-automatique Consultez la section Modifier les paramètres de saisie semi-automatique.
Paramétrage de la recherche (Preview) Consultez Améliorer les résultats de recherche grâce au paramétrage de la recherche.
Si vous prévoyez d'intégrer des appels d'API de recherche à votre serveur ou à votre application au lieu d'utiliser le widget, vous pouvez configurer vos paramètres de recherche à l'aide des options suivantes:
Saisie semi-automatique Selon vos données, configurez des suggestions de saisie semi-automatique en fonction du contenu des documents, des champs, de l'historique de recherche ou des événements utilisateur. Consultez la section Configurer la saisie semi-automatique.
Commandes de diffusion Contrôlez quand les résultats de recherche sont mis en avant, masqués, filtrés ou redirigés, ou si certaines requêtes sont synonymes d'autres. Consultez Configurer les commandes de diffusion pour la recherche.
Paramétrage de la recherche (Preview) Ajustez le modèle de recherche avec vos propres données d'entraînement. Consultez Améliorer les résultats de recherche grâce au paramétrage de la recherche.
Si vous prévoyez de déployer votre application en intégrant des appels d'API de recherche dans votre propre code, Vertex AI Search fournit des options supplémentaires pour configurer la manière dont vos résultats de recherche sont renvoyés.
Actions
Configurez vos résultats de recherche à l'aide des options suivantes:
Vous pouvez prévisualiser vos résultats de recherche pour vérifier si les configurations de votre application fonctionnent comme prévu.
Actions
Pour prévisualiser vos résultats de recherche, utilisez la console ou l'API.
Console Utilisez la page Aperçu de la console Vertex AI Agent Builder pour prévisualiser l'impact des configurations du widget de recherche sur vos résultats. Consultez les instructions de la console dans Obtenir les résultats de recherche.
API : Si vous intégrez des appels d'API à votre application, vous pouvez effectuer des appels curl pour prévisualiser vos configurations de recherche. Consultez les instructions REST dans Obtenir les résultats de recherche.
Enrichissez l'index de votre entrepôt de données en exploitant les données structurées ajoutées à vos pages Web.
Actions
L'ajout de données structurées à vos pages Web est un processus itératif:
- Modifiez les données structurées sur les pages Web. Pour en savoir plus, consultez Utiliser des données structurées pour l'indexation avancée de sites Web.
- Mettez à jour le schéma de votre entrepôt de données avec les attributs de données structurées, si nécessaire.
- Reconfigurez vos résultats de recherche. Consultez l'étape 6 de cette checklist.
- Prévisualisez les résultats de recherche. Consultez l'étape 7 de cette checklist.
- Répétez ce processus autant de fois que nécessaire pour obtenir le comportement de recherche requis avant de déployer votre application de recherche.
Lorsque vous êtes satisfait de la version preview de votre application de recherche, partagez-la avec vos utilisateurs en la déployant sur votre site Web.
Actions
Vous pouvez déployer votre application de recherche de l'une des manières suivantes:
Intégrez le widget de recherche à votre site Web. Vertex AI Search fournit du code que vous pouvez copier dans votre site Web ou votre application Web. Le widget de recherche est alors déployé. Vous pouvez prévisualiser les résultats de recherche dans la console. Consultez Ajouter le widget de recherche à une page Web.
Intégrez les appels d'API Search à votre serveur ou à votre application. Pour contrôler entièrement l'affichage de vos résultats de recherche, vous pouvez intégrer des appels d'API à votre serveur ou à vos applications. Pour en savoir plus sur les appels d'API, consultez Obtenir les résultats de recherche. Pour en savoir plus sur les ressources de bibliothèque cliente, consultez Bibliothèques clientes Vertex AI Agent Builder.
Vous pouvez gérer votre application pour vous assurer que les données les plus récentes et nécessaires sont disponibles dans votre datastore.
Actions
- Actualisez vos données.
- Facultatif: si votre entrepôt de données utilise l'indexation et l'actualisation basées sur un sitemap, envoyez vos sitemaps ou les index de sitemaps, et maintenez-les à jour. L'index du magasin de données est mis à jour automatiquement et les URL incluses sont actualisées quotidiennement. Pour comprendre l'indexation et l'actualisation basées sur un sitemap, consultez Indexer et actualiser des pages Web à l'aide d'un sitemap.