This page describes tuning and training media recommendations apps.

For information about tuning for search, see [Improve search results with
search tuning](https://docs.cloud.google.com/generative-ai-app-builder/docs/tune-search).

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](https://docs.cloud.google.com/generative-ai-app-builder/docs/prepare-data.md.txt#structured-media).

## 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](https://docs.cloud.google.com/generative-ai-app-builder/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 **AI Applications** page.

   [AI Applications](https://console.cloud.google.com/gen-app-builder/start)
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](https://docs.cloud.google.com/generative-ai-app-builder/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 **AI Applications** page.

   [AI Applications](https://console.cloud.google.com/gen-app-builder/start)
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**.