This is the documentation for Recommendations AI, Retail Search, and the new Retail console. To use Retail Search in the restricted GA phase, contact Cloud sales.

If you are only using Recommendations AI, remain on the Recommendations console and refer to the Recommendations AI documentation.

Creating serving configurations

This page describes how to create serving configurations. A serving configuration is a serving entity that associates a model or a set of controls that are used to generate your search or recommendation results.

Before you begin

You can first create a model (for Recommendations AI) or controls (for Retail Search), or you can create them at the same time you create a serving configuration.

Creating a serving configuration

Add a new serving configuration on the Serving Configs page in the Google Cloud Console.

To create a new serving configuration:

  1. Go to the Retail Serving Configs page in the Google Cloud Console.

    Go to the Serving Configs page

  2. Click Create serving config.

    Recommendations AI

    1. Select Recommendation as the product the serving configuration will be used for.

    2. Provide a name for your serving configuration.

      The name must be 1024 characters or less, and can contain only alphanumeric characters, underscores, hyphens, and spaces.

    3. (Optional) If needed, update the ID.

      The ID is generated from the name you provide, and must be unique across your project. It must be 50 characters or less, and cannot contain spaces.

    4. Choose or create a model you want this serving configuration to provide recommendations for.

      Learn more about creating new models.

    5. Select how much price reranking should affect recommendation results.

      Price reranking causes recommended products with a similar recommendation probability to be ordered by price, with the highest-priced items first. Relevance is still also used to order items, so enabling price reranking is not the same as sorting by price.

    6. Select how much to diversify recommendation results.

      Diversification affects whether results returned from a single prediction request are from different categories of your product catalog.

    1. Select Search as the product the serving configuration will be used for.

    2. Provide a name for your serving configuration.

      The name must be 1024 characters or less, and can contain only alphanumeric characters, underscores, hyphens, and spaces.

    3. (Optional) If needed, update the ID.

      The ID is generated from the name you provide, and must be unique across your project. It must be 50 characters or less, and cannot contain spaces.

    4. Choose whether to enable dynamic faceting for this serving configuration.

    5. Choose or create controls to optimize your searches with.

      Learn more about creating and managing controls.

    6. Add or create serving controls for this serving configuration.

  3. Click Create to create the new configuration.

    The new configuration appears in your Serving Configs page.

    It might take a few minutes for the configuration to become available for use in search requests. It is immediately available for recommendations.

  4. (Optional) On the Serving Configs page, click a serving configuration name and go to its Evaluate tab to preview the products that would be returned for this configuration.

    Evaluation preview can help you to confirm that your configuration is performing as you expect.

Next steps