Créer une application de recommandations personnalisée

Remarque : Cette fonctionnalité est une offre en version bêta soumise aux conditions des offres avant disponibilité générale des Conditions spécifiques du 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 l'IA générative ("Conditions d'utilisation bêta"). Pour cette fonctionnalité, vous pouvez traiter les données à caractère personnel comme indiqué dans l' avenant relatif au traitement des données dans le cloud, sous réserve des restrictions et obligations applicables dans le contrat (tel que défini dans les Conditions d'aperçu).

Cette page explique comment créer une application de recommandations personnalisées.

Console

Pour utiliser la Google Cloud console afin de créer une application de recommandations personnalisées, procédez comme suit :

1. Dans la Google Cloud console, accédez à la page Applications d'IA.

   AI Applications

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

3. Sur la page Créer une application, sous Moteur de recommandations, cliquez Créer.

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

5. Facultatif : Cliquez sur Modifier pour modifier l'ID de votre application.

6. Cliquez sur Continuer.

7. Pour vous connecter à un data store, sur la page Datastores, sélectionnez un data store contenant des données structurées ou choisissez d'en créer un. Effectuez l'une des opérations suivantes :

   • Sélectionnez un data store existant, s'il y en a un de disponible. Un data store ne peut être associé qu'à une seule application, et il ne peut pas être supprimé de l'application ultérieurement.

   • Créez un data store structurées et ingérez-y des données. Pour ce faire, cliquez sur Créer un datastore , puis suivez les étapes du volet Créer un datastore qui s'ouvre. Sélectionnez ensuite votre nouveau data store. Pour en savoir plus sur la création d'un data store, consultez Créer un datastore de recommandations personnalisées.

8. Facultatif : Pour afficher la liste des datastores non disponibles, cliquez sur En savoir plus.

   Un tableau s'affiche avec la liste des datastores et la raison pour laquelle ils ne sont pas disponibles. Voici quelques raisons pour lesquelles un data store peut ne pas être disponible :

   • Votre type de data store n'autorise la connexion qu'à une seule application, et le datastore est déjà connecté.
   • 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 connecter un data store multimédia à une application de recommandations personnalisées.
   • Votre data store dispose d'une recherche de base sur le site Web, tandis qu'une application de recommandations personnalisées nécessite un data store avec une indexation avancée du site Web.

9. Cliquez sur Créer.

REST

Avant d'utiliser la ligne de commande pour créer une application, vous devez disposer d'un datastore existant. Si vous n'en avez pas, créez-en un en suivant les étapes décrites dans Créer un datastore de recommandations personnalisées.

Remarque : Cette fonctionnalité est expérimentale.

Pour utiliser la ligne de commande afin de créer une application de recommandations, 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 Google Cloud console, accédez à la page Applications d'IA et cliquez sur Datastores dans le menu de navigation.

      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 structurées. Un data store ne peut être associé qu'à une seule application, et il ne peut pas être supprimé de l'application ultérieurement.

   Terme clé : Dans la recherche d'agent, 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 Google Cloud projet.
   • APP_ID : ID de l'application de recommandations que vous souhaitez créer.
   • APP_DISPLAY_NAME : nom à afficher de l'application de recommandations que vous souhaitez créer.
   • DATA_STORE_ID: ID d'un data store de recommandations existant que vous souhaitez ajouter à l'application de recommandations.

Étape suivante

• Pour voir un aperçu de l'apparence de vos recommandations, consultez Obtenir des recommandations.