Créer une application de recommandations générique

Remarque: Cette fonctionnalité est une offre preview soumise aux "Conditions des offres de pré-DG". des Conditions spécifiques au service GCP. Les fonctionnalités et produits pré-DG sont susceptibles de présenter une compatibilité limitée, et les modifications apportées à ces fonctionnalités ou produits peuvent ne pas être compatibles avec d'autres versions pré-DG. Pour en savoir plus, consultez les descriptions des étapes de lancement. En outre, en utilisant cette fonctionnalité, vous acceptez les Conditions d'utilisation de la version bêta de Generative AI ("Conditions d'utilisation bêta"). Pour cette fonctionnalité, vous pouvez traiter les données à caractère personnel comme indiqué dans les Avenant relatif au traitement des données dans le cloud, soumis aux restrictions et obligations applicables dans le Contrat (tel que défini dans les Conditions d'utilisation du Programme Aperçus).

Cette page explique comment créer une application de recommandations générique.

Console

Pour créer une application de recommandations générique à l'aide de la console Google Cloud, procédez comme suit :

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

   Agent Builder

2. Sur la page Applications, cliquez sur Créer une application.

3. Sur la page Créer une application, sélectionnez Recommandations.

4. Dans le champ Nom de votre application, saisissez le nom de votre application. ID de votre application s'affiche sous le nom du moteur.

5. Facultatif : cliquez sur Modifier pour modifier votre ID d'application.

6. Sous Contenu, assurez-vous que l'option Générique est sélectionnée.

7. Cliquez sur Continuer.

8. Pour vous connecter à un data store, sur la page Data Stores (Datastores), sélectionnez un data store que vous avez créé précédemment ou créez-en un. Effectuez l'une des opérations suivantes :

   • Sélectionnez un data store existant, le cas échéant. Un entrepôt de données ne peut être associé qu'à une seule application et ne peut pas être supprimé de l'application par la suite.

   • Créez un data store et y insérez des données. Pour ce faire, cliquez sur Créer un data store et en suivant les étapes de la section Créer un data store qui s'ouvre. Sélectionnez ensuite votre nouveau data store. Pour plus sur la création d'un data store, consultez Créer des données de recommandations génériques Google Store.

9. Facultatif : Pour afficher la liste des entrepôts de données indisponibles, cliquez sur En savoir plus.

   Un tableau s'affiche avec la liste des data stores et la raison pour laquelle ils ne sont pas disponibles. Voici quelques raisons pour lesquelles un entrepôt de données peut être indisponible :

   • Votre type de data store vous permet de vous connecter à une seule application et aux données magasin est déjà associé.
   • Votre data store et votre application se trouvent dans des régions différentes.
   • Votre data store et votre application sont de types différents. Par exemple, vous ne pouvez pas associer un data store de contenus multimédias à une application de recommandations générique.
   • Votre data store dispose d'une recherche de site Web de base, tandis qu'une application de recommandations génériques nécessite un data store avec indexation avancée de site Web.

10. Cliquez sur Créer.

REST

Avant d'utiliser la ligne de commande pour créer une application, vous devez disposer d'un magasin de données existant. Si vous ne possédez pas de data store, créez-en un en suivant les étapes décrites dans Créez un data store de recommandations générique.

Remarque :Cette fonctionnalité est expérimentale.

Pour créer une application de recommandations à l'aide de la ligne de commande, procédez comme suit :

1. Recherchez l'ID de votre data store. Si vous disposez déjà de l'ID de votre data store, passez à l'étape suivante.

   1. Dans la console Google Cloud, accédez à la page Agent Builder. Dans le menu de navigation, cliquez sur Data stores (Magasins de données).

      Accéder à la page "Datastores"

   2. Cliquez sur le nom de votre data store.

   3. Sur la page Données de votre data store, obtenez l'ID du data store.

2. Créez une application et associez-la à un data store. Un data store ne peut être associé qu'à une seule application et ne peut pas être supprimé de l'application par la suite.

   Terme clé : Dans Vertex AI Search, le terme application peut être utilisé de manière interchangeable avec le terme moteur dans le contexte des API.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines?engineId=APP_ID" \
   -d '{
     "displayName": "APP_DISPLAY_NAME",
     "dataStoreIds": ["DATA_STORE_ID"],
     "solutionType": ["SOLUTION_TYPE_RECOMMENDATION"],
     "similarDocumentsConfig": {}
   }'
   

   Remplacez les éléments suivants :

   • PROJECT_ID : ID de votre projet Google Cloud
   • APP_ID : ID de l'application de recommandations que vous souhaitez créer.
   • APP_DISPLAY_NAME: nom à afficher pour l'application de recommandations que vous souhaitez créer.
   • DATA_STORE_ID : ID d'un entrepôt de données de recommandations existant que vous souhaitez ajouter à l'application de recommandations.

Étape suivante

• Pour voir un aperçu de vos recommandations, consultez Obtenez des recommandations.