Migrer depuis l'API JSON Custom Search Site Restricted

Si vous utilisez l'API JSON Custom Search Site Restricted de Programmable Search Engine, vous pouvez créer et déployer une recherche de qualité Google limitée à des sites en quelques minutes à l'aide de Vertex AI Search. Pour déployer votre application, vous pouvez utiliser le widget de recherche en copiant le code de la console Google Cloud directement dans une page Web. Aucun codage n'est requis. Vous pouvez également implémenter un déploiement d'API pour contrôler l'apparence de la fonctionnalité de recherche sur votre site Web. Pour en savoir plus sur l'utilisation de l'API, consultez l'onglet REST de Obtenir les résultats de recherche d'une application avec des données de site Web et la méthode servingConfigs.search dans la documentation de référence REST.

En plus des extraits courts standards que Vertex AI Search renvoie avec les résultats de recherche, vous pouvez ajouter des fonctionnalités avancées à votre recherche. Il s'agit notamment des résultats de recherche générés, de la recherche avec questions pour une recherche contextuelle permettant de poser des questions complémentaires, et des réponses extractives pour le texte extrait renvoyé avec chaque résultat de recherche. Pour bénéficier de ces fonctionnalités avancées pour votre recherche sur le Web, vous devez valider votre domaine et vous devrez payer des coûts d'indexation supplémentaires.

Vous pouvez également filtrer ou trier vos résultats de recherche, et appliquer des commandes de promotion pour afficher un lien en tant que résultat sponsorisé.

Pour en savoir plus, consultez la page Tarifs de Vertex AI Agent Builder.

Configurer Vertex AI Search

Pour configurer la recherche Vertex AI, procédez comme suit:

  1. Dans la console Google Cloud, sur la page de sélection du projet, sélectionnez le projet que vous avez utilisé pour l'API JSON de recherche personnalisée avec restriction de site.

  2. Activez Vertex AI Agent Builder.

Créer une application de recherche

Pour créer une application de recherche, procédez comme suit:

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

    Agent Builder

  2. Cliquez sur Créer l'application.

  3. Sur la page Créer une application, sous Rechercher votre site Web, cliquez sur Créer.

  4. Assurez-vous que les fonctionnalités de l'édition Enterprise sont activées. Ce paramètre est obligatoire pour la recherche sur le site Web. Pour en savoir plus, consultez la section Fonctionnalités de l'édition Enterprise.

  5. Désactivez Fonctionnalités LLM avancées. Si vous désactivez cette option, vous bénéficiez de fonctionnalités similaires à celles de l'API JSON Custom Search Site Restricted de Programmable Search Engine. Désactivez cette option si vous n'avez pas besoin de la synthèse de la recherche ni de la recherche avec suivi. Pour en savoir plus, consultez la section Fonctionnalités LLM avancées.

  6. Dans le champ Nom de votre application, saisissez le nom de votre application.

  7. Dans le champ Nom externe de votre entreprise ou organisation, saisissez le nom commun de votre entreprise ou organisation.

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

  9. Sur la page Datastores, cliquez sur Créer un data store.

  10. Dans le volet Sélectionner une source de données, sélectionnez Contenu de site Web.

  11. Désactivez l'indexation avancée de site Web. Si vous désactivez cette option, vous bénéficiez de fonctionnalités similaires à celles de l'API JSON Custom Search Site Restricted de Programmable Search Engine. Désactivez cette option si vous n'avez pas besoin de la synthèse des recherches ni de la recherche avec des suivis, ou si vous n'êtes pas propriétaire des domaines que vous spécifiez. Pour en savoir plus, consultez la page Indexation avancée de sites Web.

  12. Dans le volet Spécifier des formats d'URL à indexer, dans le champ Sites à inclure, saisissez les formats d'URL des sites Web que vous souhaitez rechercher, puis cliquez sur Continuer.

  13. Dans le volet Configurer votre data store, saisissez un nom à afficher pour votre data store, puis cliquez sur Créer.

  14. Sur la page Data stores, sélectionnez votre nouveau data store, puis cliquez sur Créer.

Déployer l'application de recherche

Déterminez comment vous prévoyez d'authentifier votre application de recherche Vertex AI Search: à l'aide d'OAuth 2.0 ou d'une clé API. Pour en savoir plus sur les avantages et les inconvénients de chaque méthode, consultez la section À propos de l'authentification.

Déployer l'application de recherche (OAuth 2.0)

Pour déployer votre application de recherche à l'aide de l'authentification OAuth 2.0, procédez comme suit:

  1. Pour configurer OAuth 2.0, consultez la section Sur Google Cloud dans S'authentifier auprès de Vertex AI Agent Builder. Veillez à ajouter le rôle Utilisateur du moteur de découverte ou Visionneuse du moteur de découverte au compte de service.

  2. Déployez votre application de recherche de l'une des manières suivantes:

Déployer l'application de recherche (clé API)

Pour déployer votre application de recherche à l'aide d'une clé API pour l'authentification, procédez comme suit:

  1. Créez la clé API:

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

      Identifiants

    2. Si vous n'êtes pas déjà dans votre projet, sélectionnez-le dans la liste des projets en haut de la page de la console Google Cloud.

    3. Cliquez sur Créer des identifiants, puis sélectionnez Clé API. N'ajoutez aucune restriction de référent. Certains paramètres de confidentialité de l'utilisateur ne transmettent pas l'URL de provenance.

      • Prenez note de la clé API générée, que vous utiliserez lors des appels à la méthode searchLite.

    4. Pour renforcer la sécurité, ajoutez une restriction HTTP à votre clé API afin de restreindre l'accès au service Vertex AI Agent Builder à l'adresse https://discoveryengine.googleapis.com/*.

  2. Déployez votre application de recherche à l'aide de l'API. Consultez Obtenir les résultats de recherche d'une application avec des données de site Web (clé API) et la méthode servingConfigs.searchLite dans la documentation de référence REST. Pour trier les résultats de vos requêtes de recherche Web, consultez Trier les résultats de recherche Web.

À propos de l'authentification

L'API JSON Custom Search Site Restricted de Programmable Search Engine s'authentifie à l'aide d'une clé API. Alors que, à quelques exceptions près, Vertex AI Search nécessite OAuth 2.0. Si vous souhaitez continuer à utiliser une clé API pour l'authentification, vous devez utiliser la méthode searchLite via des appels d'API.

Si vous choisissez de vous authentifier via OAuth 2.0, vous devez utiliser la méthode search et la méthode answer pour interroger votre site Web. De plus, vous pouvez déployer votre application de recherche via le widget de recherche sans code.

Le tableau suivant présente les différences entre l'utilisation de la méthode searchLite avec l'authentification par clé API et les méthodes search et answer avec l'authentification OAuth 2.0.

Fonctionnalité/Méthodes Méthode searchLite Méthode search
Authentification Clé API OAuth 2.0
Widget Recherche disponible ✘ ✔
Résumés de recherche ✔ ✔
Rechercher sur des sites Web publics ✔ ✔

Étapes suivantes