Crea configuraciones de entrega

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

Antes de comenzar

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

• Las configuraciones de entrega de recomendaciones requieren un modelo. Si planeas adjuntar un modelo existente a una nueva configuración de servicio, obtén el ID del modelo que planeas usar (obligatorio cuando se usa el método ServingConfig.create).

  Si creas la configuración de entrega con la consola, puedes crear un modelo nuevo durante el proceso de creación en lugar de adjuntar un modelo existente.

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

• La Búsqueda puede usar controles de publicación, pero no son obligatorios. Si planeas adjuntar controles existentes a un nuevo parámetro de configuración de entrega, obtén los IDs de los controles que planeas usar.

  Si creas la configuración de entrega con la consola, también puedes crear controles nuevos durante el proceso de creación.

  Puedes cambiar o agregar controles de entrega a tu configuración de entrega después de crearla.

Crea una configuración de entrega

Puedes crear una configuración de entrega con el siguiente comando:

• La consola de Búsqueda para comercios
• La API de ServingConfig.create

Se permiten hasta 100 parámetros de configuración de la publicación por catálogo.

La búsqueda funciona con las configuraciones de entrega no configuradas. Cualquier serving_config_id se puede colocar como parte de la solicitud de búsqueda, y este default_search buscará en el catálogo con la capacidad de búsqueda predeterminada de Vertex AI Search for Commerce.

Si tienes posiciones existentes o creas nuevas, se creará automáticamente una configuración de entrega asociada con cada posición. Crear una configuración de entrega no crea una posición correspondiente. Si borras una configuración de entrega, se borrará la posición correspondiente, y si borras una posición, se borrará la configuración de entrega correspondiente.

Crea una configuración de entrega en la consola

Agrega una nueva configuración de entrega en la página de Opciones de configuración de entrega en la consola de Search for commerce.

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

1. Ve a la página Serving Configs en la consola de Search for commerce.
   
   Ir a la página Configuración de entrega

2. Haz clic en add_box Crear una opción de configuración de entrega.

   Recomendaciones

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

   2. Proporciona un nombre para la configuración de entrega.

      El nombre debe tener 1,024 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 proporcionas y debe ser único en todo el proyecto. Debe tener 50 caracteres o menos, y no puede contener espacios.

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

      Obtén más información para crear modelos nuevos.

   5. Selecciona la cantidad de tiempo que la reclasificación de precio debería afectar los resultados de la recomendación, si está disponible para el modelo que seleccionaste.

      La reclasificación de precio hace que los productos sugeridos del catálogo con una probabilidad de recomendarse similar se ordenen según el precio, con los elementos de precio más alto primero. La relevancia también se usa para ordenar elementos, por lo que habilitar la reclasificación de precio no es lo mismo que ordenarlos por precio.

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

      • Basada en reglas: La diversificación de resultados basada en reglas afecta si los resultados que se muestran de una sola solicitud de predicción son de diferentes 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 predicción.

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

   7. Selecciona cuánto quieres diversificar los resultados de recomendaciones.

   8. Si seleccionaste un modelo de artículos similares para esta configuración de entrega, elige si deseas habilitar la coincidencia de categorías.

      Cuando se habilita la correlación de categorías, los únicos resultados de productos que se muestran son aquellos que comparten al menos una categoría con el producto de contexto. La correlación 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, elige Search como el producto para el que se usará la configuración de entrega.
   2. Proporciona un nombre para tu configuración de publicación.
      
      El nombre debe tener 1, 024 caracteres o menos, 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 proporcionas y debe ser único en todo el proyecto. Debe tener 50 caracteres o menos, y no puede contener espacios.
   4. Haz clic en Continuar.
   5. Elige si deseas habilitar la faceta dinámica para esta configuración de entrega.
   6. Elige o crea controles de publicación para optimizar tus búsquedas.
      
      Para obtener más información sobre los controles, consulta Cómo crear y administrar controles.

3. Haz clic en Crear para crear el grupo nuevo.

   La configuración nueva aparecerá en la página de Opciones de configuración de entrega.

   Es posible que la configuración tarde unos minutos en estar disponible para su uso en solicitudes de búsqueda. Está disponible de inmediato para obtener recomendaciones.

4. Opcional: En la página Opciones de configuración de entrega, haz clic en un nombre de configuración de entrega y ve a la pestaña Evaluar para obtener una vista previa de los productos que se mostrarían con esta configuración.

   La vista previa de la evaluación puede ayudarte a confirmar que la configuración tiene el rendimiento esperado.

Crea una configuración de entrega con ServingConfig.create

Puedes crear una configuración de entrega con el método de la API de ServingConfig.create. Para obtener la documentación de referencia de la API de este método, consulta ServingConfig.create.

Los campos que uses dependerán de si creas una configuración de entrega para recomendaciones o para la búsqueda.

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

Próximos pasos

• Solicita predicciones desde tu posición nueva.