This page describes serving configs for media recommendation apps and how to create, edit, and delete them. A serving config contains configurations that are used when generating your media recommendations results.
About serving configs
Serving configs are referenced at serving time to determine what recommendations to generate.
When any Vertex AI Search app is created, a default serving config is
also automatically created. For search apps, the default serving config's ID is
default_search. For recommendations apps, the serving config's ID is the same
as the engine ID. The default serving config ID is specified when making
recommend or search API calls.
However, search and generic recommendations apps don't allow you to modify serving configs or create additional serving configs. Only media recommendation apps have modifiable serving configs and allow multiple serving configs.
For any media recommendation app, you can create multiple serving configs with
different settings for recommendations demotion and recommendations diversity.
To get recommendations from a specific serving config with the demotion and
diversity settings you need, specify that serving config's ID in the recommend
request.
Serving config settings
The following settings are available for serving configs:
- Recommendation demotion. You can demote media recommendations based on viewer data or content age. For information about demotion settings and how to set them, see Demote media recommendations.
- Recommendation diversity. You can diversify recommendations to reduce the likelihood that similar content is shown in a recommendation panel. For information about diversification settings and how to set them, see Diversify media recommendations.
Create a serving config
To create a serving config, follow these steps:
In the Google Cloud console, go to the Agent Builder page.
Click the name of the app for which you will create a serving config.
Go to the Configurations > Serving tab.
Click Create new serving config.
Enter a name for your serving config.
Set configurations for recommendation demotion and diversity.
For more information about these settings, see Demote media recommendations and Diversify media recommendations.
Click Save and publish.
Edit a serving config
To edit a serving config, follow these steps:
In the Google Cloud console, go to the Agent Builder page.
Click the name of the app whose serving config you want to edit.
Go to the Configurations > Serving tab.
If you have more than one serving config, click the name of the serving config that you want to edit.
Update your configurations for recommendation demotion or diversity.
For more information about these settings, see Demote media recommendations and Diversify media recommendations.
Click Save and publish.
Delete a serving config
You can delete a serving config only if you have multiple serving configs.
To delete a serving config, follow these steps:
In the Google Cloud console, go to the Agent Builder page.
Click the name of the app whose serving config you will delete.
Go to the Configurations > Serving tab.
For the serving config you that want to delete, click , and then click Delete.
In the confirmation dialog, type the name of the serving config to delete, and then click Confirm.