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 à un site 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. Vous n'avez pas besoin de coder. 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 la page Obtenir les résultats de recherche pour 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 brefs extraits 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, entre autres, des résumés générés des résultats de recherche, de la recherche avec questions complémentaires pour une recherche contextuelle qui permet 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 la recherche sur le Web, vous devez valider votre domaine. Des frais d'indexation supplémentaires s'appliquent.

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

Pour en savoir plus, consultez la page Tarifs des applications d'IA.

Configurer Vertex AI Search

Pour configurer Vertex AI Search, 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 Custom Search Site Restricted.

  2. Activez les applications d'IA.

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 AI Applications.

    AI Applications

  2. Cliquez sur Créer l'application.

  3. Sur la page Créer une application, sous Recherche sur site avec le mode IA, 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 Fonctionnalités de l'édition Enterprise.

  5. Désactivez l'option Fonctionnalités LLM avancées. Si vous désactivez cette option, vous bénéficiez d'une fonctionnalité semblable à 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 recherche ni de la recherche avec questions de suivi. Pour en savoir plus, consultez 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, choisissez Contenu de site Web.

  11. Désactivez l'indexation avancée de site Web. Si vous désactivez cette option, vous bénéficierez de fonctionnalités semblables à celles de l'API JSON Custom Search Site Restricted de Programmable Search Engine. Désactivez cette option si vous n'avez pas besoin de résumés de recherche ni de recherches avec questions complémentaires, ou si vous n'êtes pas propriétaire des domaines que vous spécifiez. Pour en savoir plus, consultez Indexation avancée de sites Web.

  12. Dans le champ Sites à inclure du volet Spécifier les formats d'URL à indexer, saisissez les formats d'URL des sites Web sur lesquels vous souhaitez effectuer des recherches, 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

Choisissez comment 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 À 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 Sur Google Cloud dans S'authentifier auprès des applications d'IA. Veillez à ajouter le rôle Utilisateur Discovery Engine ou Lecteur Discovery Engine 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 AI Applications à l'adresse https://discoveryengine.googleapis.com/*.

  2. Déployez votre application de recherche à l'aide de l'API. Consultez Obtenir des résultats de recherche pour 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 sur le Web, consultez Trier les résultats de recherche sur le Web.

À propos de l'authentification

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

Si vous choisissez de vous authentifier via OAuth 2.0, vous devez utiliser les méthodes search et answer pour interroger votre site Web. Vous pouvez également déployer votre application de recherche à l'aide du widget de recherche sans code.

Le tableau suivant répertorie 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 de recherche disponible ✘ ✔
Résumés de recherche ✔ ✔
Rechercher des sites Web publics ✔ ✔

Étapes suivantes