Administrar modelos

En esta página, se describe cómo ajustar, pausar, reanudar, borrar y enumerar modelos de recomendación. Para obtener ayuda con la creación de un nuevo modelo de recomendaciones, consulta Crea modelos de recomendaciones.

Recomendaciones generales para la calidad de los modelos

Por lo general, los eventos se deben subir 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 a 2015. Para las sugerencias de aprendizaje automático, el sistema usa eventos de usuario de los últimos 180 días. Del mismo modo, las métricas de eventos de usuario anteriores a 180 días o generadas hace más de 180 días no se pueden exportar.

  • IDs de visitantes únicos: La cantidad total de IDs de visitantes únicos para cada tipo de evento debe ser de al menos 100 para garantizar que haya suficientes datos para obtener resultados de calidad.

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

Para el modelo de productos que se suelen comprar juntos, se recomienda entre uno y dos años de historial de compras. Este modelo requiere específicamente una de las siguientes opciones:

  • En promedio, 10 casos por artículo de catálogo (con un período de un año de eventos de compra completada).

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

Una o dos semanas de páginas de detalles vistas pueden ser suficientes para comenzar a entrenar los modelos Otras opciones que te podrían gustar y Recomendado para ti.

Ajusta un modelo

AI Commerce Search usa los datos de entrada que proporcionas a tu modelo para ajustar los hiperparámetros del entrenamiento.

El ajuste tarda entre 2 y 4 días. Durante este tiempo, el modelo seguirá funcionando como de costumbre. Para ajustar los detalles de los costos, consulta Precios.

Configura la frecuencia de ajuste de un modelo

Te recomendamos ajustar el modelo de forma periódica. Esto mantiene la eficacia del entrenamiento de modelos a medida que los datos cambian y el comportamiento de los clientes difiere durante el año. Además, algunas actualizaciones internas de modelos principales solo se pueden aplicar después de que se haya ajustado el modelo.

Cuando creas el modelo, puedes configurarlo para que se ajuste de forma automática cada tres meses o puedes elegir solo ajustarlo de forma manual. Independientemente de la configuración que elijas, el modelo se ajusta de forma automática una vez después de la creación.

Puedes cambiar la configuración del estado de los ajustes en cualquier momento. El cambio de esta configuración no afecta los procesos de ajuste que se ejecutan actualmente.

Para editar la configuración del estado de los ajustes de un modelo, haz lo siguiente:

Console

  1. Ve a la página Modelos en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.

    Ve a la página Modelos

    Puedes ver el estado de los ajustes de cada modelo en Estado de los ajustes.

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

  3. Haz clic en Editar junto al Estado de los ajustes.

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

    • Cada tres meses : Se ajusta automáticamente cuando el último ajuste se haya realizado hace 90 días.
    • Solo ajuste manual : Se ajusta solo cuando lo ajustas manualmente.

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

curl

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

Para obtener detalles sobre todos los campos Models, consulta la Models referencia de la API.

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'

Ajusta un modelo de forma manual

El ajuste manual activa un ajuste único de tu modelo. Puedes ajustar manualmente tu modelo cuando haya un cambio significativo en tu catálogo (como un aumento de tamaño o un cambio en la jerarquía del catálogo) o eventos (como el reabastecimiento de eventos históricos o un cambio en la distribución de los datos después de promover ciertos grupos de elementos).

Para ajustar de forma manual un modelo, haz lo siguiente:

Console

  1. Ve a la página Modelos en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.

    Ve a la página Modelos

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

  3. Haz clic en Ajuste manual en la barra de botones.

    El ajuste tarda entre 2 y 4 días. Durante este tiempo, el modelo seguirá funcionando como de costumbre.

curl

Realiza una solicitud Models.tune con la API. Consulta la Models.tune referencia de 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:tune'

Pausa y reanuda el entrenamiento de un modelo

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

Puedes pausar el modelo para detener el reentrenamiento. Te recomendamos hacerlo si importaste datos incorrectos o si permaneces por debajo del límite de 10 modelos activos por proyecto. Si tienes menos de 10 modelos activos, puedes reiniciar un modelo en pausa en cualquier momento.

Para obtener información sobre los costos de entrenamiento, consulta Precios.

Puedes iniciar hasta cinco operaciones de modelo por minuto. Este límite se aplica a la creación, eliminación, detención y reanudación de modelos.

Para pausar o reiniciar un modelo, haz lo siguiente:

Console

  1. Ve a la página Modelos en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.

    Ve a la página Modelos

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

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

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

curl

Para pausar un modelo activo, realiza una solicitud Models.pause con la API. Consulta la referencia de la API de 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 en pausa, realiza una solicitud Models.resume con 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 con el método de la API de Models.get.

Para ver las configuraciones de entrega asociadas a un modelo específico, usa este procedimiento. Todos los demás detalles del modelo están disponibles en la consola y en la respuesta de la API.

Console

  1. Ve a la página Modelos en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.

    Ve a la página Modelos

  2. En la página Modelos , se enumeran todos tus modelos y sus estados de entrenamiento y de consulta.

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

curl

Para obtener información sobre un solo modelo, realiza una solicitud Models.get con la API. Consulta la referencia de la API de 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'

Enumera tus modelos

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

Console

  1. Ve a la página Modelos en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.

    Ve a la página Modelos

  2. En la página Modelos , se enumeran todos tus modelos y sus estados de entrenamiento y de consulta.

curl

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

De manera opcional, puedes usar el parámetro pageSize para establecer una cantidad máxima de resultados que se mostrarán. Si hay más resultados disponibles, la respuesta list incluye un token de página. Puedes pasar un token de página en el parámetro pageToken de una solicitud list para recuperar 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'

Borra un modelo

Puedes iniciar hasta cinco operaciones de modelo por minuto. Este límite se aplica a la creación, eliminación, detención y reanudación de modelos.

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

Console

  1. Ve a la página Modelos en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.

    Ve a la página Modelos

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

  3. Haz clic en Borrar en la barra de botones.

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

curl

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

Para obtener detalles sobre todos los campos Models, consulta la Models referencia de la API.

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'