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

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 Create App (Créer une application), sous Recommendations engine (Moteur de recommandations), cliquez sur Create (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 votre ID d'application.

  6. Cliquez sur Continuer.

  7. 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 data store 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, puis suivez les étapes dans le volet Créer un data store 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 générique.

  8. 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 data store peut être indisponible:

    • Votre type de data store ne permet de se connecter 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 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.

  9. 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 disposez pas de data store, créez-en un en suivant la procédure décrite dans Créer un data store de recommandations générique.

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 et cliquez sur Data Stores 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. Un data store ne peut être associé qu'à une seule application et ne peut pas être supprimé de l'application par la suite.

    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 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