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 page Créer des modèles de recommandation.
Régler un modèle
Vertex AI Search pour le commerce 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 de 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.
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. Règle automatiquement la date du dernier réglage datant 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 (augmentation de la taille ou modification de la hiérarchie du catalogue, par exemple) ou d'événements (remplissage d'événements historiques ou modification de la distribution des données après la promotion de certains groupes d'éléments).
Pour régler manuellement un modèle, procédez comme suit :
Console
Accédez à la page Modèles de la console Search for Retail.
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 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 que l'événement s'est produit.
Vous pouvez mettre en pause l'entraînement de votre modèle pour arrêter le réentraînement. Cela peut être utile si vous avez importé des données incorrectes ou si vous souhaitez rester sous 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 suspendu à 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
Accédez à la page Modèles de la console Search for Retail.
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 veille (État de l'entraînement défini sur PAUSE), cliquez sur Reprendre play_arrow.
curl
Pour suspendre un modèle actif, exécutez 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 suspendu, 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, utilisez 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 de la console Search for Retail.
Accéder à la page "Modèles"La page Modèles répertorie 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 la page Details (Détails).
curl
Pour obtenir les informations d'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'
Lister vos modèles
Affichez la liste de vos modèles dans la console ou à l'aide de la méthode API Models.list.
Console
Accédez à la page Modèles de la console Search for Retail.
Accéder à la page "Modèles"La page Modèles répertorie 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 détails de façon intégrée, 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èle 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 de la console Search for Retail.
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'