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 pour les recommandations et la recherche ont des exigences et des options différentes :

Les configurations de diffusion pour les 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 lors du processus de création au lieu d'associer un modèle existant.

Vous pouvez changer de modèle ultérieurement, à condition qu'il soit du même type.
La recherche peut utiliser des contrôles de diffusion, mais ils ne sont pas obligatoires. 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 modifier ou ajouter des contrôles de diffusion à 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 recherche AI Commerce dans la console Gemini Enterprise for Customer Experience.
L'ServingConfig.create API.

Vous pouvez créer jusqu'à 100 configurations de diffusion par catalogue.

La recherche fonctionne avec des configurations de diffusion non configurées. N'importe quel serving_config_id peut être placé dans la requête de recherche, et cette default_search effectuera une recherche dans le catalogue avec la fonctionnalité de recherche par défaut d'AI Commerce Search.

Si vous disposez d'emplacements existants ou si vous créez de nouveaux emplacements, une configuration de diffusion associée à chaque emplacement est créée automatiquement. 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 recherche AI Commerce dans la console Gemini Enterprise for Customer Experience.

Pour créer une configuration de diffusion :

Accédez à la page Configurations de diffusion de la recherche AI Commerce dans la console Gemini Enterprise for Customer Experience.

Accéder à la page "Configurations de diffusion"
Cliquez sur Créer une configuration de diffusion.
Recommandations
1. Sélectionnez Recommandation comme produit pour lequel la configuration de diffusion sera utilisée.
2. Indiquez un nom pour 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, modifiez 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 du prix sur les résultats de recommandation, s'il 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 les 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 renvoyés partagent au moins une catégorie avec le produit contextuel. 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 Rechercher comme produit pour lequel la configuration de diffusion sera utilisée.
2. Indiquez un nom pour 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, modifiez 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 contrôles de diffusion pour optimiser vos recherches.
  
  Pour en savoir plus sur les contrôles, consultez Créer et gérer des contrôles.
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.
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 obtenir 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 ServingConfigs documentation de référence de l'API.

Recommandations

Effectuez une ServingConfig.create requête avec un ID de configuration de diffusion et une instance de ServingConfig contenus dans le corps de la requête.

servingConfigId : valeur obligatoire. Crée un ID pour votre ServingConfig. Cette valeur doit comporter entre 4 et 63 caractères. Les caractères valides sont /[a-z][0-9]-_/.
displayName : valeur obligatoire. Nom ServingConfig lisible par l'utilisateur affiché dans la recherche AI Commerce dans la console Gemini Enterprise for Customer Experience.
modelID : valeur obligatoire. ID du modèle à utiliser au moment de la diffusion.
priceRerankingLevel : facultatif. Définit l'impact du reclassement du prix sur les résultats de recommandation. Les valeurs autorisées sont no-price-reranking (valeur par défaut si elle n'est pas définie), low-price-raranking, medium-price-reranking et high-price-reranking.
diversityLevel : facultatif. Définit le degré de diversification des résultats de recommandation. Les valeurs autorisées sont no-diversity (par défaut), low-diversity, medium-diversity, high-diversity et auto-diversity. Si diversityLevel n'est pas défini, la diversification est désactivée.
diversityType : facultatif. Définissez la valeur sur RULE_BASED_DIVERSITY pour diversifier les résultats de recommandation en fonction de la catégorie de produit. Définissez la valeur sur DATA_DRIVEN_DIVERSITY pour diversifier les recommandations en fonction de l'apprentissage à partir des métadonnées du produit afin d'équilibrer la pertinence et la diversité des catégories. Si diversityLevel est défini, mais que diversityType ne l'est pas, la valeur par défaut de diversityType est basée sur des règles. Pour en savoir plus, consultez Diversification des résultats.
enableCategoryFilterLevel : facultatif. Indique si des filtres de catégorie supplémentaires doivent être ajoutés au modèle d'articles similaires. Les valeurs autorisées sont relaxed-category-match (valeur par défaut si elle n'est pas définie) et no-category-match.
solutionTypes : valeur obligatoire. Définissez la valeur sur SOLUTION_TYPE_RECOMMENDATION pour les configurations de diffusion des recommandations.

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"

Rechercher

Effectuez une ServingConfig.create requête avec un ID de configuration de diffusion et une instance de ServingConfig contenus dans le corps de la requête.

servingConfigId : valeur obligatoire. Crée un ID pour votre ServingConfig. Cette valeur doit comporter entre 4 et 63 caractères. Les caractères valides sont /[a-z][0-9]-_/.
displayName : valeur obligatoire. Nom ServingConfig lisible par l'utilisateur affiché dans la recherche AI Commerce dans la console Gemini Enterprise for Customer Experience.
facetControlIds : facultatif. ID des contrôles pour lesquels seul FacetSpec est défini.
dynamicFacetSpec.mode : facultatif. Mode de la fonctionnalité DynamicFacet. Les valeurs autorisées sont DISABLED (par défaut si elle n'est pas définie) et ENABLED.
boostControlIds : facultatif. ID des contrôles de diffusion de l'amplification.
filterControlIds : facultatif. ID des contrôles de diffusion du filtre.
redirectControlIds : facultatif. ID des contrôles de diffusion de la redirection.
twowaySynonymsControlIds : facultatif. ID des contrôles de diffusion des synonymes bidirectionnels.
onewaySynonymsControlIds : facultatif. ID des contrôles de diffusion des synonymes unidirectionnels.
doNotAssociateControlIds : facultatif. ID des contrôles de diffusion de l'association.
replacementControlIds : facultatif. ID des contrôles de diffusion du remplacement.
ignoreControlIds : facultatif. ID des contrôles de diffusion de l'ignorance.
solutionTypes : valeur obligatoire. Définissez la valeur sur SOLUTION_TYPE_SEARCH pour les configurations de diffusion de la recherche.

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.

Créer des configurations de diffusion Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Avant de commencer

Créer une configuration de diffusion

Créer une configuration de diffusion dans la console

Recommandations

Rechercher

Créer une configuration de diffusion avec ServingConfig.create

Recommandations

Rechercher

Étapes suivantes

Créer des configurations de diffusion

Créer une configuration de diffusion avec `ServingConfig.create`