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.

Ajusta un modelo

Vertex AI Search para venta minorista 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.

Establece 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 Search for Retail.

    Ir 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 de Models.patch con la API. Consulta la referencia de la API de Models.patch.

Para obtener detalles sobre todos los campos de Models, consulta la referencia de la API de 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'

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 Search for Retail.

    Ir 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 de Models.tune con la API. Consulta la referencia de la API de 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'

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 detenido 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 Search for Retail.

    Ir 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 publicación asociadas con un modelo específico, usa el siguiente procedimiento de la consola. 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 Search for Retail.

    Ir a la página Modelos

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

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

curl

Para obtener la información de 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'

Cómo enumerar 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 Search for Retail.

    Ir a la página Modelos

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

curl

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

De forma 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 el siguiente 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 Search for Retail.

    Ir 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 de Models.delete con la API. Consulta la referencia de la API de Models.delete.

Para obtener detalles sobre todos los campos de Models, consulta la referencia de la API de 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'