Gestionar modelos

En esta página se describe cómo ajustar, pausar, reanudar, eliminar y enumerar modelos de recomendación. Para obtener ayuda sobre cómo crear un modelo de recomendación, consulta el artículo Crear modelos de recomendación.

Recomendaciones generales para la calidad de los modelos

Por lo general, los eventos deben subirse al menos una vez al día para mantener una buena calidad de los datos.

  • Límites de antigüedad de los datos: no se aceptan eventos de usuario anteriores al 2015. En el caso de las sugerencias de aprendizaje automático, el sistema usa los eventos de usuario de los últimos 180 días. Del mismo modo, las métricas de eventos de usuario que tengan más de 180 días o que se hayan generado hace más de 180 días no se pueden exportar.

  • IDs de visitante únicos: el número total de IDs de visitante únicos de cada tipo de evento debe ser de al menos 100 para que haya suficientes datos y los resultados sean de calidad.

La mayoría de los modelos funcionan mejor con al menos tres meses de datos de vistas de páginas de producto, vistas de páginas principales y eventos add-to-cart.

En el caso del modelo de artículos que se suelen comprar juntos, se recomienda usar entre uno y dos años de historial de compras. Este modelo requiere específicamente uno de los siguientes elementos:

  • De media, 10 repeticiones por elemento de catálogo (con un periodo de un año de eventos de compra completada).

  • Ambos: 90 días de eventos de compra completada en el último año y 1000 eventos de compra completada en ese mismo año.

Con una o dos semanas de vistas de páginas de detalles, puede ser suficiente para empezar a entrenar los modelos Otros que te pueden gustar y Recomendado para ti.

Ajustar un modelo

Vertex AI Search para el sector del comercio usa los datos de entrada que proporciones a tu modelo para ajustar los hiperparámetros del entrenamiento.

El ajuste tarda entre 2 y 4 días, durante los cuales el modelo sigue funcionando con normalidad. Para obtener información detallada sobre los costes de ajuste, consulta la página Precios.

Definir la frecuencia de ajuste de un modelo

Te recomendamos que ajustes tu modelo periódicamente. De esta forma, el entrenamiento del modelo se mantiene óptimo a medida que cambian los datos y el comportamiento de los clientes a lo largo del año. Además, algunas actualizaciones importantes internas del modelo solo se pueden aplicar después de que se haya ajustado el modelo.

Cuando crees el modelo, puedes configurarlo para que se ajuste automáticamente cada tres meses o elegir ajustarlo manualmente. Independientemente del ajuste que elijas, el modelo se ajustará automáticamente una vez después de la creación.

Puedes cambiar el ajuste de estado de la sintonización en cualquier momento. Cambiar este ajuste no afecta a los procesos de ajuste en curso.

Para editar el ajuste de estado de un modelo, sigue estos pasos:

Consola

  1. Ve a la página Modelos de la consola de Search for Commerce.

    Ve a la página Modelos.

    Puede ver el estado de ajuste de cada modelo en Estado del ajuste.

  2. Haga clic en el nombre de un modelo para ver su página de detalles.

  3. Haz clic en Editar junto a Estado de la configuración.

  4. En la lista desplegable, selecciona una opción:

    • Cada tres meses. Se ajusta automáticamente cuando el último ajuste se realizó hace 90 días.
    • Solo ajuste manual. Solo se ajusta cuando lo configuras manualmente.

  5. Haz clic en Hecho para guardar la configuración.

curl

Haz una solicitud Models.patch con la API. Consulta la referencia de la API Models.patch.

Para obtener información sobre todos los campos Models, consulta la referencia de la API Models.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID",
  "PeriodicTuningState": "NEW_TUNING_STATE_VALUE"
}' \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID?updateMask=PeriodicTuningState'

Ajustar un modelo manualmente

El ajuste manual activa un ajuste único de tu modelo. Puede ajustar manualmente su modelo cuando haya un cambio significativo en su catálogo (por ejemplo, un aumento de tamaño o un cambio en la jerarquía del catálogo) o en los eventos (por ejemplo, al rellenar eventos históricos o al cambiar la distribución de los datos después de promocionar determinados grupos de artículos).

Para ajustar manualmente un modelo, sigue estos pasos:

Consola

  1. Ve a la página Modelos de la consola de Search for Commerce.

    Ve a la página Modelos.

  2. Haga clic en el nombre de un modelo para ver su página de detalles.

  3. En la barra de botones, haz clic en Ajuste manual.

    El ajuste tarda entre 2 y 4 días, durante los cuales el modelo sigue funcionando con normalidad.

curl

Haz una solicitud Models.tune con la API. Consulta la referencia de la API Models.tune.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:tune'

Pausar y reanudar la preparación de un modelo

Si tu modelo está activo (no en pausa), se vuelve a entrenar al menos una vez a la semana, pero no más de una vez al día. Para que el reentrenamiento sea constante, asegúrate de subir los datos de eventos de usuario en un plazo de 24 horas después de que se produzcan.

Puedes pausar tu modelo para detener el reentrenamiento. Puede que quieras hacerlo si has importado datos incorrectos o para no superar el límite de 10 modelos activos por proyecto. Si tienes menos de 10 modelos activos, puedes reiniciar un modelo pausado en cualquier momento.

Para obtener más información sobre el coste de la preparación, consulta la página Precios.

Puedes iniciar un máximo de cinco operaciones de modelos por minuto. Entre las operaciones de modelos limitadas se incluyen las de creación, eliminación, pausa y reanudación.

Para pausar o reiniciar un modelo, haz lo siguiente:

Consola

  1. Ve a la página Modelos de la consola de Search for Commerce.

    Ve a la página Modelos.

    Puedes ver el estado de entrenamiento de cada modelo en Estado del entrenamiento.

  2. Para pausar un modelo activo (Estado de entrenamiento ENTRENANDO), haz clic en Pausar .

  3. Para iniciar un modelo en pausa (Estado de entrenamiento PAUSADO), haz clic en Reanudar .

curl

Para pausar un modelo activo, haz una solicitud Models.pause con la API. Consulta la referencia de la API Models.pause.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:pause'

Para iniciar un modelo pausado, haz una solicitud Models.resume mediante la API.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:resume'

Ver detalles del modelo

Consulta los detalles de un modelo en la consola o mediante el método de la API Models.get.

Para ver las configuraciones de servicio asociadas a un modelo específico, sigue este procedimiento. El resto de los detalles del modelo están disponibles en la consola y en la respuesta de la API.

Consola

  1. Ve a la página Modelos de la consola de Search for Commerce.

    Ve a la página Modelos.

  2. En la página Modelos se muestran todos tus modelos, así como sus estados de entrenamiento y de consulta.

  3. Haga clic en el nombre de un modelo para ver su página Detalles.

curl

Para obtener información de un solo modelo, haz una solicitud Models.get mediante la API. Consulta la referencia de la API Models.get.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'

Mostrar tus modelos

Consulta una lista de tus modelos en la consola o con el método Models.list de la API.

Consola

  1. Ve a la página Modelos de la consola de Search for Commerce.

    Ve a la página Modelos.

  2. En la página Modelos se muestran todos tus modelos, así como sus estados de entrenamiento y de consulta.

curl

Para enumerar todos los modelos y sus detalles de forma insertada, haz una solicitud Models.list con la API. Consulta la referencia de la API Models.list.

También puedes usar el parámetro pageSize para definir el número máximo de resultados que se devolverán. Si hay más resultados disponibles, la respuesta list incluye un token de página. Puedes transferir un token de página en el parámetro pageToken de una solicitud list para obtener la siguiente página de resultados. En este ejemplo se usan ambos parámetros.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

Eliminar un modelo

Puedes iniciar un máximo de cinco operaciones de modelos por minuto. Entre las operaciones de modelos limitadas se incluyen las de creación, eliminación, pausa y reanudación.

Elimina un modelo en la consola o con el método Models.delete de la API.

Consola

  1. Ve a la página Modelos de la consola de Search for Commerce.

    Ve a la página Modelos.

  2. Haz clic en el nombre del modelo que quieras eliminar para abrir su página de detalles.

  3. En la barra de botones, haz clic en Eliminar.

  4. Vuelve a introducir el nombre del modelo y haz clic en Confirmar.

curl

Haz una solicitud Models.delete con la API. Consulta la referencia de la API Models.delete.

Para obtener información sobre todos los campos Models, consulta la referencia de la API Models.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'