Crear configuraciones de publicación

En esta página se describe cómo crear configuraciones de servicio. Una configuración de servicio es una entidad de servicio que asocia un modelo o un conjunto de controles que se usan para generar los resultados de búsqueda o de recomendación. Para obtener más información sobre las configuraciones de servicio, consulta Acerca de las configuraciones de servicio.

Antes de empezar

Las recomendaciones y las configuraciones de publicación de búsquedas tienen requisitos y opciones diferentes:

• Las configuraciones de servicio de recomendaciones requieren un modelo. Si tiene previsto adjuntar un modelo a una nueva configuración de servicio, obtenga el ID del modelo que quiera usar (es obligatorio cuando se usa el método ServingConfig.create).

  Si crea la configuración de servicio mediante la consola, puede crear un modelo durante el proceso de creación en lugar de adjuntar uno que ya tenga.

  Puedes cambiar de modelo más adelante, siempre que sea del mismo tipo.

• La búsqueda puede usar controles de publicación, pero no son obligatorios. Si tienes previsto adjuntar controles a una nueva configuración de publicación, obtén los IDs de los controles que quieras usar.

  Si creas la configuración de servicio mediante la consola, también puedes crear controles durante el proceso.

  Puedes cambiar o añadir controles de publicación a tu configuración de publicación después de crearla.

Crear una configuración de publicación

Puedes crear una configuración de publicación de las siguientes formas:

• La consola de búsqueda de comercio.
• La API ServingConfig.create.

Se permiten hasta 100 configuraciones de publicación por catálogo.

La búsqueda funciona con configuraciones de servicio no configuradas. Cualquier serving_config_id se puede incluir en la solicitud de búsqueda, y este default_search buscará en el catálogo con la función de búsqueda predeterminada de Vertex AI Search para el sector del comercio.

Si ya tiene emplazamientos o crea otros nuevos, se creará automáticamente una configuración de publicación asociada a cada emplazamiento. Crear una configuración de publicación no crea un emplazamiento correspondiente. Si eliminas una configuración de publicación, se eliminará el emplazamiento correspondiente, y si eliminas un emplazamiento, se eliminará la configuración de publicación correspondiente.

Crear una configuración de publicación en la consola

Añada una nueva configuración de publicación en la página Configuraciones de publicación de la consola de búsqueda de comercio.

Para crear una configuración de publicación, sigue estos pasos:

1. Ve a la página Serving Configs (Configuraciones de servicio) de la consola de Search for Commerce.
   
   Ve a la página Configuraciones de servicio.

2. Haz clic en add_boxCrear configuración de servicio.

   Recomendaciones

   1. Seleccione Recomendación como el producto para el que se usará la configuración de publicación.

   2. Proporciona un nombre para tu configuración de servicio.

      El nombre debe tener 1024 caracteres como máximo y solo puede contener caracteres alfanuméricos, guiones bajos, guiones y espacios.

   3. Opcional: Si es necesario, actualiza el ID.

      El ID se genera a partir del nombre que proporciones y debe ser único en todo el proyecto. Debe tener 50 caracteres como máximo y no puede contener espacios.

   4. Elige o crea un modelo para el que quieras que esta configuración de publicación proporcione recomendaciones.

      Más información sobre cómo crear modelos

   5. Selecciona cuánto debe influir la reordenación de precios en los resultados de las recomendaciones, si está disponible en el modelo que has seleccionado.

      Si reclasificas los precios, los productos recomendados que tengan una probabilidad de recomendación similar se ordenarán por precio, y aparecerán en primer lugar los que tengan un precio más alto. La relevancia también se sigue usando para ordenar los elementos, por lo que habilitar la reordenación por precio no es lo mismo que ordenar por precio.

   6. Selecciona si quieres usar la diversificación de resultados basada en reglas o en datos:

      • Basada en reglas: la diversificación de resultados basada en reglas afecta a si los resultados que devuelve una única solicitud de predicción proceden de distintas categorías de tu catálogo de productos.

      • Basada en datos: la diversificación de resultados basada en datos usa el aprendizaje automático para equilibrar la diversidad de categorías y la relevancia en los resultados de las predicciones.

      Para obtener más información, consulta Diversificación de resultados.

   7. Selecciona el grado de diversificación de los resultados de las recomendaciones.

   8. Si ha seleccionado un modelo de artículos similares para esta configuración de publicación, elija si quiere habilitar la coincidencia de categorías.

      Cuando la coincidencia de categorías está habilitada, los únicos resultados de producto que se devuelven son los que comparten al menos una categoría con el producto de contexto. La coincidencia de categorías se puede usar en combinación con otras opciones de filtrado, como el precio, la disponibilidad y las etiquetas de filtro.

   Buscar

   1. En la página Create Serving Config (Crear configuración de servicio), elija Search (Búsqueda) como producto para el que se usará la configuración de servicio.
   2. Asigna un nombre a la configuración de servicio.
      
      El nombre debe tener 1024 caracteres como máximo y solo puede contener caracteres alfanuméricos, guiones bajos, guiones y espacios.
   3. Opcional: Si es necesario, actualiza el ID.
      
      El ID se genera a partir del nombre que proporciones y debe ser único en todo el proyecto. Debe tener 50 caracteres como máximo y no puede contener espacios.
   4. Haz clic en Continuar.
   5. Elige si quieres habilitar la facetado dinámico en esta configuración de servicio.
   6. Elige o crea controles de publicación para optimizar tus búsquedas.
      
      Para obtener más información sobre los controles, consulta el artículo Crear y gestionar controles.

3. Haz clic en Crear para crear la configuración.

   La nueva configuración aparece en la página Configuraciones de servicio.

   La configuración puede tardar unos minutos en estar disponible para usarse en las solicitudes de búsqueda. Está disponible de inmediato para las recomendaciones.

4. Opcional: En la página Configuraciones de servicio, haga clic en el nombre de una configuración de servicio y vaya a la pestaña Evaluar para ver los productos que se devolverían con esta configuración.

   La vista previa de la evaluación puede ayudarte a confirmar que tu configuración funciona como esperas.

Crear una configuración de publicación con ServingConfig.create

Puedes crear una configuración de servicio con el método ServingConfig.create de la API. Para consultar la documentación de referencia de la API de este método, ve a ServingConfig.create.

Los campos que utilices dependerán de si vas a crear una configuración de servicio para recomendaciones o para búsquedas.

Para obtener más información sobre los campos ServingConfig, consulta la referencia de la 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"
  

Pasos siguientes

• Solicita predicciones desde tu nuevo emplazamiento.