Créer des configurations de diffusion

Cette page explique comment créer des configurations de diffusion. Une configuration de diffusion est une entité de diffusion qui associe un modèle ou un ensemble de contrôles permettant de générer vos résultats de recherche ou de recommandation. Pour en savoir plus sur les configurations de diffusion, consultez À propos des configurations de diffusion.

Avant de commencer

Les configurations de diffusion des recommandations et de la recherche ont des exigences et des options différentes :

• Les configurations de diffusion des recommandations nécessitent un modèle. Si vous prévoyez d'associer un modèle existant à une nouvelle configuration de diffusion, obtenez l'ID du modèle que vous prévoyez d'utiliser (obligatoire lorsque vous utilisez la méthode ServingConfig.create).

  Si vous créez la configuration de diffusion à l'aide de la console, vous pouvez créer un modèle pendant le processus de création au lieu d'associer un modèle existant.

  Vous pourrez changer de modèle ultérieurement, à condition qu'il soit du même type.

• La recherche peut utiliser des contrôles de diffusion, mais ce n'est pas obligatoire. Si vous prévoyez d'associer des contrôles existants à une nouvelle configuration de diffusion, obtenez les ID des contrôles que vous prévoyez d'utiliser.

  Si vous créez la configuration de diffusion à l'aide de la console, vous pouvez également créer des contrôles lors du processus de création.

  Vous pouvez ajouter ou modifier des contrôles de diffusion dans votre configuration de diffusion après l'avoir créée.

Créer une configuration de diffusion

Vous pouvez créer une configuration de diffusion à l'aide des éléments suivants :

• La console de recherche pour le commerce.
• L'API ServingConfig.create.

Jusqu'à 100 configurations de diffusion sont autorisées par catalogue.

La recherche fonctionne avec les configurations de diffusion non configurées. Tout serving_config_id peut être placé dans la requête de recherche. Ce default_search effectuera une recherche dans le catalogue à l'aide de la fonctionnalité de recherche par défaut de Vertex AI Search pour le commerce.

Si vous disposez d'emplacements existants ou si vous créez de nouveaux emplacements, une configuration de diffusion associée à chaque emplacement est automatiquement créée. La création d'une configuration de diffusion ne crée pas d'emplacement correspondant. La suppression d'une configuration de diffusion entraîne celle de l'emplacement correspondant, et la suppression d'un emplacement entraîne celle de la configuration de diffusion correspondante.

Créer une configuration de diffusion dans la console

Ajoutez une configuration de diffusion sur la page Configurations de diffusion de la console Search for Commerce.

Pour créer une configuration de diffusion :

1. Accédez à la page Configurations de diffusion dans la console Search for Commerce.
   
   Accéder à la page "Configurations de diffusion"

2. Cliquez sur add_boxCréer une configuration de diffusion.

   Recommandations

   1. Sélectionnez Recommendation comme produit pour lequel la configuration de diffusion sera utilisée.

   2. Attribuez un nom à votre configuration de diffusion.

      Ce nom doit comporter 1 024 caractères au maximum, et ne peut contenir que des caractères alphanumériques, des traits de soulignement, des traits d'union et des espaces.

   3. (Facultatif) Si nécessaire, mettez à jour l'ID.

      L'ID est généré à partir du nom que vous fournissez et doit être unique dans votre projet. Il doit comporter 50 caractères au maximum, et ne peut pas contenir d'espaces.

   4. Sélectionnez ou créez un modèle pour lequel cette configuration de diffusion doit fournir des recommandations.

      En savoir plus sur la création de modèles.

   5. Sélectionnez l'impact du reclassement de prix sur les résultats des recommandations, si cette option est disponible pour le modèle que vous avez sélectionné.

      Le reclassement du prix permet de classer par prix les produits recommandés ayant une probabilité de recommandation similaire, les articles ayant le prix le plus élevé figurant en premier. La pertinence étant toujours utilisée pour trier les articles, l'activation du reclassement du prix est différente d'un simple tri des articles par prix décroissant.

   6. Sélectionnez si vous souhaitez utiliser la diversification des résultats basée sur des règles ou sur des données :

      • Basée sur des règles : la diversification des résultats basée sur des règles détermine si les résultats renvoyés par une requête de prédiction donnée proviennent de différentes catégories de votre catalogue de produits.

      • Basée sur les données : la diversification des résultats basée sur les données utilise le machine learning pour équilibrer la diversité et la pertinence des catégories dans vos résultats de prédiction.

      Pour en savoir plus, consultez Diversification des résultats.

   7. Sélectionnez le degré de diversification des résultats des recommandations.

   8. Si vous avez sélectionné un modèle d'articles similaires pour cette configuration de diffusion, indiquez si vous souhaitez activer la correspondance des catégories.

      Lorsque la correspondance des catégories est activée, seuls les résultats de produits qui partagent au moins une catégorie avec le produit de contexte sont renvoyés. La correspondance des catégories peut être utilisée en combinaison avec d'autres options de filtrage, telles que le prix, la disponibilité et les tags de filtre.

   Rechercher

   1. Sur la page Créer une configuration de diffusion, sélectionnez Search comme produit pour lequel la configuration de diffusion sera utilisée.
   2. Donnez un nom à votre configuration de diffusion.
      
      Ce nom doit comporter 1 024 caractères au maximum, et ne peut contenir que des caractères alphanumériques, des traits de soulignement, des traits d'union et des espaces.
   3. Facultatif : Si nécessaire, mettez à jour l'ID.
      
      L'ID est généré à partir du nom que vous fournissez et doit être unique dans votre projet. Il doit comporter 50 caractères au maximum, et ne peut pas contenir d'espaces.
   4. Cliquez sur Continuer.
   5. Choisissez d'activer ou non les attributs dynamiques pour cette configuration de diffusion.
   6. Choisissez ou créez des commandes de diffusion pour optimiser vos recherches.
      
      Pour en savoir plus sur les commandes, consultez Créer et gérer des commandes.

3. Cliquez sur Créer pour créer une configuration.

   La nouvelle configuration s'affiche sur la page Configurations de diffusion.

   Quelques minutes peuvent être nécessaires pour que la configuration soit disponible dans les requêtes de recherche. Elle est immédiatement disponible pour les recommandations.

4. Facultatif : Sur la page "Configurations de diffusion", cliquez sur un nom de configuration de diffusion, puis accédez à son onglet Évaluation pour prévisualiser les produits qui seraient renvoyés pour cette configuration.

   L'aperçu d'évaluation peut vous aider à vérifier que votre configuration fonctionne comme prévu.

Créer une configuration de diffusion avec ServingConfig.create

Vous pouvez créer une configuration de diffusion avec la méthode d'API ServingConfig.create. Pour consulter la documentation de référence de l'API pour cette méthode, consultez ServingConfig.create.

Les champs que vous utilisez dépendent du type de configuration de diffusion que vous créez (recommandations ou recherche).

Pour en savoir plus sur les champs ServingConfig, consultez la documentation de référence de l'API ServingConfigs.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "modelId": "MODEL_ID",
              "priceRerankingLevel": "PRICE_RERANKING_LEVEL",
              "diversityType": "DIVERSITY_TYPE",
              "diversityLevel": "DIVERSITY_LEVEL",
              "enableCategoryFilterLevel": "CATEGORY_FILTER_LEVEL",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ]
            }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
  

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "facetControlIds": [
                "FACET_CONTROL_ID_1",
                "FACET_CONTROL_ID_2"
              ],
              "dynamicFacetSpec": {
                "mode": "DYNAMIC_FACET_MODE"
              },
              "boostControlIds": [
                "BOOST_CONTROL_ID_1",
                "BOOST_CONTROL_ID_2"
              ],
              "filterControlIds": [
                "FILTER_CONTROL_ID_1",
                "FILTER_CONTROL_ID_2"
              ],
              "redirectControlIds": [
                "REDIRECT_CONTROL_ID_1",
                "REDIRECT_CONTROL_ID_2"
              ],
              "twowaySynonymsControlIds": [
                "TWO_WAY_SYNONYM_CONTROL_ID_1",
                "TWO_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "onewaySynonymsControlIds": [
                "ONE_WAY_SYNONYM_CONTROL_ID_1",
                "ONE_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "doNotAssociateControlIds": [
                "DO_NOT_ASSOCIATE_CONTROL_ID_1",
                "DO_NOT_ASSOCIATE_CONTROL_ID_2"
              ],
              "replacementControlIds": [
                "REPLACEMENT_CONTROL_ID_1",
                "REPLACEMENT_CONTROL_ID_2"
              ],
              "ignoreControlIds": [
                "IGNORE_CONTROL_ID_1",
                "IGNORE_CONTROL_ID_2"
              ],
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ]
    }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
  

Étapes suivantes

• Demandez des prédictions à partir de votre nouvel emplacement.