Train and tune media apps

This page describes tuning and training media recommendations apps.

For information about tuning for search, see Improve search results with search tuning.

Media recommendations apps are automatically tuned every three months, and automatically trained at least once a week and at most once a day. You can use these instructions to manually restart tuning for your app, or to pause and resume training.

Before you begin

Before you can train or tune your app, you must meet the app's minimum data requirements.

For information about data requirements, see Prepare data for ingesting.

Manually tune a media recommendations app

Media recommendations apps use the data you upload to adjust hyperparameters for training underlying models. They are automatically tuned every three months.

Tuning keeps training optimal as data and end user behavior change throughout the year. In addition, some internal upgrades can only be applied after the app has been tuned.

For information about tuning costs, see Pricing.

Manually restarting tuning triggers a one-time tune for your app. You might restart tuning for your app when there is a significant change in your data store (such as size increase or change in hierarchy) or events (such as backfilling historical events or a change in data distribution after promoting certain groups of content).

To restart tuning, follow these steps:

  1. In the Google Cloud console, go to the Agent Builder page.

    Agent Builder

  2. Click the name of the app that you plan to tune.

  3. Go to the Configurations page and click the Training tab. This page shows the tuning status of your app.

  4. Click Restart tuning.

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

Pause and resume training for a model

If your app is active (not paused), training occurs at least once a week, but no more often than once a day. For consistent retraining, make sure that 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 recommendation apps per project. If you have fewer than 10 active models, you can restart a paused app at any time.

For training cost details, see Pricing.

You can start up to five media app creation, deletion, pause training, and resume training operations per minute.

To pause or resume training:

  1. In the Google Cloud console, go to the Agent Builder page.

    Agent Builder

  2. Click the name of the app you plan to tune.

  3. Go to the Configurations page and click the Training tab. This page shows the training status of your app.

  4. To pause training, click Pause training.

  5. To resume a paused training, click Resume training.