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
Accédez à la page Modèles dans la console de la recherche pour le commerce.
Accéder à la page "Modèles"Vous pouvez voir l'état du réglage de chaque modèle sous État du réglage.
Cliquez sur le nom d'un modèle pour afficher sa page d'informations.
Cliquez sur Modifier edit à côté de État du réglage.
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.
Cliquez sur OK done pour enregistrer votre paramètre.
curl
Envoyez une requête Models.patch à l'aide de l'API. Consultez la 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
Accédez à la page Modèles dans la console de la recherche pour le commerce.
Accéder à la page "Modèles"Cliquez sur le nom d'un modèle pour afficher sa page d'informations.
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 la 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élisation 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
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.
Pour mettre en pause un modèle actif (État de l'entraînement défini sur ENTRAÎNEMENT), cliquez sur Mettre en pause pause.
Pour démarrer un modèle mis en pause (État de l'entraînement défini sur EN PAUSE), cliquez sur Reprendre play_arrow.
curl
Pour suspendre un modèle actif, envoyez une requête Models.pause à l'aide de l'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 à la fois dans la console et dans la réponse de l'API.
Console
Accédez à la page Modèles dans la console de la recherche pour le commerce.
Accéder à la page "Modèles"La page Modèles liste tous vos modèles, ainsi que leur état d'entraînement et de requête.
Cliquez sur le nom d'un modèle pour afficher sa page Détails.
curl
Pour obtenir des informations sur un seul modèle, envoyez une requête Models.get à l'aide de l'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'
Répertorier 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
Accédez à la page Modèles dans la console de la recherche pour le commerce.
Accéder à la page "Modèles"La page Modèles liste tous vos modèles, ainsi que leur état d'entraînement et de requête.
curl
Pour lister tous les modèles et leurs détails en ligne, envoyez 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 de résultats à renvoyer. Si d'autres résultats sont disponibles, la réponse list inclut un jeton de page. Vous pouvez transmettre un jeton de page dans le paramètre 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
Accédez à la page Modèles dans la console de la recherche pour le commerce.
Accéder à la page "Modèles"Cliquez sur le nom du modèle que vous souhaitez supprimer pour ouvrir sa page d'informations.
Dans la barre de boutons, cliquez sur Supprimerdelete.
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 tous les champs Models, consultez la 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'