Gérer des modèles

Cette page explique comment régler, mettre en pause, reprendre, supprimer et répertorier des modèles de recommandation. Pour obtenir de l'aide concernant la création d'un modèle de recommandation, consultez la section Créer des modèles de recommandation.

Régler un modèle

Vertex AI Search for retail utilise les données d'entrée que vous fournissez à votre modèle pour ajuster les hyperparamètres d'entraînement.

Le réglage prend deux à quatre jours, au cours desquels le modèle continue de fonctionner comme d'habitude. Pour en savoir plus sur les coûts de réglage, consultez la page Tarifs.

Définir la fréquence de réglage d'un modèle

Nous vous recommandons de régler régulièrement votre modèle. Cela permet d'optimiser l'entraînement du modèle en fonction de l'évolution des données et des différences de comportement des clients au cours de l'année. En outre, certaines mises à niveau internes majeures de modèle ne peuvent être appliquées qu'après le réglage du modèle.

Lors de la création du modèle, vous pouvez choisir de le régler automatiquement tous les trois mois ou de le régler manuellement de façon ponctuelle. Quel que soit le paramètre choisi, le modèle est automatiquement réglé une première fois après sa création.

Vous pouvez modifier le paramètre d'état de réglage à tout moment. La modification de ce paramètre n'affecte pas les processus de réglage en cours.

Pour modifier le paramètre d'état de réglage d'un modèle, procédez comme suit :

Console

  1. Accédez à la page Modèles dans la console Search for Retail.

    Accéder à la page "Modèles"

    Vous pouvez voir l'état du réglage de chaque modèle sous État du réglage.

  2. Cliquez sur le nom d'un modèle pour afficher sa page d'informations.

  3. Cliquez sur Modifier à côté de État du réglage.

  4. Dans la liste déroulante, sélectionnez un paramètre :

    • Tous les trois mois. Le modèle est réglé automatiquement dès que le dernier réglage remonte à plus de 90 jours.
    • Réglage manuel uniquement. Le réglage n'est effectué que lorsque vous effectuez un réglage manuel.

  5. Cliquez sur OK pour enregistrer votre paramètre.

curl

Envoyez une requête Models.patch à l'aide de l'API. Consultez le Documentation de référence de l'API Models.patch

Pour en savoir plus sur tous les champs Models, consultez la documentation de référence de l'API Models.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID",
  "PeriodicTuningState": "NEW_TUNING_STATE_VALUE"
}' \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID?updateMask=PeriodicTuningState'

Régler manuellement un modèle

Le réglage manuel déclenche un réglage ponctuel de votre modèle. Vous pouvez ajuster manuellement votre modèle en cas de modification importante de votre catalogue (par exemple, augmentation de la taille ou modification de la hiérarchie du catalogue) ou des événements (par exemple, intégration d'un historique d'événements ou modification de la distribution des données après avoir fait la promotion de certains groupes d'articles).

Pour régler manuellement un modèle, procédez comme suit :

Console

  1. Accédez à la page Modèles dans la console Search for Retail.

    Accéder à la page Modèles

  2. Cliquez sur le nom d'un modèle pour afficher sa page d'informations.

  3. Cliquez sur Régler manuellement dans la barre de boutons.

    Le réglage prend deux à quatre jours, au cours desquels le modèle continue de fonctionner comme d'habitude.

curl

Envoyez une requête Models.tune à l'aide de l'API. Consultez le Documentation de référence de l'API Models.tune

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:tune'

Mettre en pause et reprendre l'entraînement d'un modèle

Si votre modèle est actif (et pas en pause), il est réentraîné au moins une fois par semaine, mais pas plus d'une fois par jour. Pour assurer un réentraînement cohérent, veillez à importer les données d'événement utilisateur dans un délai maximal de 24 heures après l'événement.

Vous pouvez mettre en pause l'entraînement de votre modèle pour arrêter le réentraînement. Cela peut vous être utile si vous avez importé des données erronées ou pour respecter la limite de 10 modèles actifs par projet. Si vous avez moins de 10 modèles actifs, vous pouvez redémarrer un modèle mis en pause à tout moment.

Pour en savoir plus sur les coûts d'entraînement, consultez la page Tarifs.

Vous pouvez lancer jusqu'à cinq opérations de modèle par minute. Les opérations de modélisation limitées sont la création, la suppression, la pause et la reprise.

Pour mettre en pause ou redémarrer un modèle, procédez comme suit :

Console

  1. Accédez à la page Modèles dans la console de la recherche pour le commerce.

    Accéder à la page "Modèles"

    Vous pouvez consulter l'état de l'entraînement de chaque modèle sous État de l'entraînement.

  2. Pour mettre en pause un modèle actif (État de l'entraînement défini sur ENTRAÎNEMENT), cliquez sur Mettre en pause .

  3. Pour démarrer un modèle mis en pause (État de l'entraînement défini sur EN PAUSE), cliquez sur Reprendre .

curl

Pour suspendre un modèle actif, exécutez une requête Models.pause à l'aide de la méthode API. Consultez la documentation de référence de l'API Models.pause.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:pause'

Pour démarrer un modèle mis en veille, envoyez une requête Models.resume à l'aide de l'API.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:resume'

Afficher les détails du modèle

Affichez les détails d'un modèle dans la console ou à l'aide de la méthode API Models.get.

Pour afficher les configurations de diffusion associées à un modèle spécifique, suivez la procédure de la console ci-dessous. Tous les autres détails du modèle sont disponibles console et la réponse de l'API.

Console

  1. Accédez à la page Modèles dans la console de la recherche pour le commerce.

    Accéder à la page "Modèles"

  2. La page Modèles liste tous vos modèles, ainsi que leur état d'entraînement et de requête.

  3. Cliquez sur le nom d'un modèle pour afficher sa page Détails.

curl

Pour obtenir les informations d'un seul modèle, exécutez une requête Models.get à l'aide de la méthode API. Consultez la documentation de référence de l'API Models.get.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'

Lister vos modèles

Affichez la liste de vos modèles dans la console ou à l'aide de la méthode de l'API Models.list.

Console

  1. Accédez à la page Modèles dans la console Search for Retail.

    Accéder à la page "Modèles"

  2. La page Modèles liste tous vos modèles, ainsi que leur état d'entraînement et de requête.

curl

Pour répertorier tous les modèles et leurs informations de façon intégrée, exécutez une requête Models.list. à l'aide de l'API. Consultez la documentation de référence de l'API Models.list.

Vous pouvez éventuellement utiliser le paramètre pageSize pour définir un nombre maximal à renvoyer. Si davantage de résultats sont disponibles, la réponse list inclut un jeton de page. Vous pouvez transmettre un jeton de page dans pageToken d'une requête list pour récupérer la page de résultats suivante. L'exemple ci-dessous utilise les deux paramètres.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

Supprimer un modèle

Vous pouvez lancer jusqu'à cinq opérations de modélisation par minute. Les opérations de modélisation limitées sont la création, la suppression, la pause et la reprise.

Supprimez un modèle dans la console ou à l'aide de la méthode API Models.delete.

Console

  1. Accédez à la page Modèles dans la console de la recherche pour le commerce.

    Accéder à la page Modèles

  2. Cliquez sur le nom du modèle que vous souhaitez supprimer pour ouvrir sa page d'informations.

  3. Dans la barre de boutons, cliquez sur Supprimer.

  4. Saisissez à nouveau le nom du modèle, puis cliquez sur Confirmer.

curl

Envoyez une requête Models.delete à l'aide de l'API. Consultez la documentation de référence de l'API Models.delete.

Pour en savoir plus sur les champs Models, consultez les Documentation de référence de l'API Models

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'