Managing recommendation models

This page describes how to tune, pause, resume, delete, and list recommendation models. For help with creating a new recommendation model, see Creating recommendation models.

Tuning a model

Recommendations AI uses the input data you provide to your model to adjust hyperparameters for training.

Tuning takes 2-4 days, during which the model continues to work as usual. For tuning cost details, see Pricing.

Setting a model's tuning frequency

We recommend you periodically tune your model. This keeps model training optimal as data changes and customer behavior differs thorughout the year.

When creating the model, you can set it to automatically tune every three months, or choose to only tune it manually. Regardless of the setting you choose, the model automatically tunes one time after creation.

You can change the tuning status setting at any time. Changing this setting doesn't affect currently running tuning processes.

To edit a model's tuning status setting:

  1. Go to the Recommendations AI Models page in the Google Cloud Console.
    Go to the Recommendations AI Models page

    You can see the tuning status of every model under Tuning status.

  2. Click a model name to view its details page.

  3. Click Edit next to Tuning status.

  4. From the drop-down list, select a setting:

    • Every three months. Automatically tunes when the last tune was 90 days ago.
    • Manual tune only. Tunes only when you manually tune.
  5. Click Done to save your setting.

Manually tuning a model

Manual tune triggers a one-time tune of your model. You might manually tune your model when there is a significant change in your catalog (eg. size increase, or change in catalog hierarchy) or events (eg. backfilling historical events, or a change in data distribution after promoting certain groups of items).

To manually tune a model:

  1. Go to the Recommendations AI Models page in the Google Cloud Console.
    Go to the Recommendations AI Models page

  2. Click a model name to view its details page.

  3. Click Manual Tune in the button bar.

    Tuning takes 2-4 days, during which the model continues to work as usual.

Pausing and resuming training for a model

If your model is active (not paused) and you are uploading new user event or catalog data for the model, the model is retrained at least once a week, but no more often than once a day. For consistent retraining, make sure you upload user event data no more than 24 hours after the event occurs.

You can pause your model to stop retraining. You might want to do this if you have imported bad data, or to stay under the limit of 10 active models per project. You can restart a paused model at any time, if you have less than 10 active models.

For training cost details, see Pricing.

You can start up to 5 model operations per minute. Limited model operations include creation, deletion, pause, and resume.

To pause or restart a model:

  1. Go to the Recommendations AI Models page in the Google Cloud Console.
    Go to the Recommendations AI Models page

    You can see the training status of every model under Training status.

  2. To pause an active model (Training status of TRAINING), click Pause .

  3. To start a paused model (Training status of PAUSED), click Resume .

Listing your models

To see a list of all of your models, including their training and query status and settings, go to the Recommendations AI Models page.

Deleting a model

You can start up to 5 model operations per minute. Limited model operations include creation, deletion, pause, and resume.

You delete a model by opening its details page from the models list.

  1. Go to the Recommendations AI Models page in the Google Cloud Console.
    Go to the Recommendations AI Models page

  2. Click the name of the model you want to delete to open its details page.

  3. Click Delete in the button bar.

  4. Reenter the model name and click Confirm.