管理模型

本页面介绍如何调整、暂停、恢复、删除和列出推荐模型。如需创建新推荐模型方面的帮助，请参阅创建推荐模型。

调整模型

Vertex AI Search for Retail 使用您提供给模型的输入数据来调整用于训练的超参数。

调整需要 2 到 4 天的时间，在此期间，模型会继续照常工作。如需了解调整费用详情，请参阅价格。

设置模型的调整频率

我们建议您定期调整模型。这样可以让模型训练保持最佳状态，因为在一年当中，数据会发生变化，客户行为也会有所不同。此外，某些内部主要模型升级只能在模型调整后应用。

创建模型时，您可以将模型设置为每 3 个月自动调整，或者选择仅手动调整模型。无论您选择哪种设置，模型都会在创建后自动调整一次。

您可以随时更改调整状态设置。更改此设置不会影响当前正在运行的调整进程。

要修改模型的调整状态设置，请执行以下操作：

控制台

  1. 前往 Search for Retail 控制台中的模型页面。

    前往“模型”页面

    您可以在调整状态下查看每个模型的调整状态。

  2. 点击模型名称以查看其详情页面。

  3. 点击调整状态旁边的修改 。

  4. 从下拉列表中选择设置：

    • 每 3 个月。上次调整时间超过 90 天时自动调整。
    • 仅限手动调整。仅在您手动调整时调整。

  5. 点击完成 保存设置。

curl

使用 API 发出 Models.patch 请求。请参阅 Models.patch API 参考文档。

如需详细了解所有 Models 字段，请参阅 Models 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'

手动调整模型

手动调整会触发模型的一次性调整。如果目录发生重大变化（例如大小增加或目录层次结构发生变化），或者事件发生重大变化（例如回填历史事件或在促销特定商品组后数据分布发生变化），则您可能会手动调整模型。

要手动调整模型，请执行以下操作：

控制台

  1. 前往 Search for Retail 控制台中的模型页面。

    前往“模型”页面

  2. 点击模型名称以查看其详情页面。

  3. 点击按钮栏中的手动调整。

    调整需要 2 到 4 天的时间，在此期间，模型会继续照常工作。

curl

使用 API 发出 Models.tune 请求。请参阅 Models.tune 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'

暂停和恢复模型训练

如果您的模型处于活跃状态（未暂停），则该模型每周至少重新训练一次，但每天不超过一次。为了确保一致的重新训练，请确保在事件发生后 24 小时内上传用户事件数据。

您可以暂停模型以停止重新训练。如果您导入了错误数据，或者希望每个项目的活跃模型数量不超过 10 个，则可能需要执行此操作。如果活跃模型数量少于 10 个，您可以随时重启暂停的模型。

如需了解训练费用详情，请参阅价格。

每分钟最多可以启动 5 个模型操作。受限制的模型操作包括创建、删除、暂停和继续。

要暂停或重启模型，请执行以下操作：

控制台

  1. 前往 Search for Retail 控制台中的模型页面。

    前往“模型”页面

    您可以在训练状态下查看每个模型的训练状态。

  2. 要暂停活跃模型（训练状态为正在训练），请点击暂停 。

  3. 如需启动已暂停的模型（训练状态为已暂停），请点击恢复 。

curl

如需暂停正在运行的模型，请使用 API 发出 Models.pause 请求。请参阅 Models.pause 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:pause'

如需启动已暂停的模型，请使用 API 发出 Models.resume 请求。

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'

查看模型详细信息

在控制台中或使用 Models.get API 方法查看模型的详细信息。

如需查看与特定模型关联的广告投放配置，请使用以下控制台流程。控制台和 API 响应中均提供所有其他模型详细信息。

控制台

  1. 前往 Search for Retail 控制台中的模型页面。

    前往“模型”页面

  2. 模型页面会列出您的所有模型及其训练和查询状态。

  3. 点击模型名称以查看其详情页面。

curl

如需获取单个模型的信息，请使用 API 发出 Models.get 请求。请参阅 Models.get API 参考文档。

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'

列出模型

在控制台中或使用 Models.list API 方法查看模型列表。

控制台

  1. 前往 Search for Retail 控制台中的模型页面。

    前往“模型”页面

  2. 模型页面会列出您的所有模型及其训练和查询状态。

curl

如需内嵌列出所有模型及其详细信息，请使用 API 发出 Models.list 请求。请参阅 Models.list API 参考文档。

（可选）您可以使用参数 pageSize 设置要返回的最大结果数。如果有更多结果可用，list 响应中会包含页面令牌。您可以在 list 请求的 pageToken 参数中传递页面令牌，以检索下一页结果。以下示例使用了这两个参数。

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'

删除模型

每分钟最多可以启动 5 个模型操作。受限制的模型操作包括创建、删除、暂停和继续。

在控制台中或使用 Models.delete API 方法删除模型。

控制台

  1. 前往 Search for Retail 控制台中的模型页面。

    前往“模型”页面

  2. 点击要删除的模型的名称以打开其详情页面。

  3. 点击按钮栏中的删除。

  4. 重新输入模型名称，然后点击确认。

curl

使用 API 发出 Models.delete 请求。请参阅 Models.delete API 参考文档。

如需详细了解所有 Models 字段，请参阅 Models 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'