Gerenciar modelos

Nesta página, descrevemos como ajustar, pausar, retomar, excluir e listar modelos de recomendação. Para criar um novo modelo de recomendação, consulte Criar modelos de recomendação.

Ajustar um modelo

A Vertex AI Search para varejo usa os dados de entrada que você fornece ao modelo para ajustar hiperparâmetros para treinamento.

O ajuste leva de 2 a 4 dias, em que o modelo continua funcionando normalmente. Para ajustar os detalhes de custo, consulte Preços.

Definir a frequência de ajuste de um modelo

Recomendamos que você ajuste periodicamente o modelo. Isso mantém o treinamento do modelo ideal à medida que as alterações nos dados e o comportamento do cliente diferem ao longo do ano. Além disso, alguns upgrades de modelos principais internos só podem ser aplicados depois que o modelo foi ajustado.

Ao criar o modelo, é possível configurá-lo para ajustar automaticamente a cada três meses ou optar por ajustá-lo apenas manualmente. Independentemente da configuração escolhida, o modelo é ajustado automaticamente uma vez após a criação.

É possível alterar a configuração de status do ajuste a qualquer momento. Alterar essa configuração não afeta os processos de ajuste em execução no momento.

Para editar a configuração de status de ajuste de um modelo:

Console

  1. Acesse a página Modelos no console da Pesquisa para varejo.

    Acessar a página "Modelos"

    Você pode ver o status de ajuste de cada modelo em Status de ajuste.

  2. Clique no nome de um modelo para ver a respectiva página de detalhes.

  3. Clique em Editar ao lado de Status do ajuste.

  4. Na lista suspensa, selecione uma configuração:

    • A cada três meses. Faz o ajuste automaticamente quando o último foi feito há 90 dias.
    • Somente ajuste manual. Ajustar somente quando você fizer o ajuste manual.

  5. Clique em Concluído para salvar a configuração.

curl

Faça uma solicitação Models.patch usando a API. Consulte a referência da API Models.patch.

Para detalhes sobre todos os campos Models, consulte a referência da 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 um modelo manualmente

O ajuste manual aciona um ajuste único do seu modelo. É possível ajustar manualmente o modelo quando houver uma mudança significativa no catálogo (como aumento do tamanho ou mudança na hierarquia do catálogo) ou eventos (como preenchimento de eventos históricos ou uma mudança na distribuição de dados após a promoção de determinados grupos de itens).

Para ajustar um modelo manualmente, faça o seguinte:

Console

  1. Acesse a página Modelos no console da Pesquisa para varejo.

    Acessar a página "Modelos"

  2. Clique no nome de um modelo para ver a respectiva página de detalhes.

  3. Clique em Ajuste manual na barra de botões.

    O ajuste leva de 2 a 4 dias, em que o modelo continua funcionando normalmente.

curl

Faça uma solicitação Models.tune usando a API. Consulte a referência da 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 e retomar o treinamento de um modelo

Se o modelo estiver ativo (não pausado), ele será treinado novamente pelo menos uma vez por semana, mas não mais do que uma vez por dia. Para fazer um novo treinamento consistente, faça upload dos dados do evento do usuário até 24 horas após o evento.

É possível pausar seu modelo para interromper o novo treinamento. Convém fazer isso se você importou dados inválidos ou ficar abaixo do limite de 10 modelos ativos por projeto. Se você tiver menos de 10 modelos ativos, é possível reiniciar um modelo pausado a qualquer momento.

Para detalhes sobre custos de treinamento, consulte Preços.

É possível iniciar até cinco operações de modelo por minuto. As operações limitadas do modelo incluem criação, exclusão, pausa e retomada.

Para pausar ou reiniciar um modelo, faça o seguinte:

Console

  1. Acesse a página Modelos no console da Pesquisa para varejo.

    Acessar a página "Modelos"

    Veja o status de cada modelo em Status do treinamento.

  2. Para pausar um modelo ativo (Status de treinamento de Training), clique em Pausar .

  3. Para iniciar um modelo pausado (Status do treinamento de PAUSADO), clique em Retomar .

curl

Para pausar um modelo ativo, faça uma solicitação Models.pause usando a API. Consulte a referência da 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 um modelo pausado, faça uma solicitação Models.resume usando a 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'

Acessar detalhes do modelo

Confira os detalhes de um modelo no console ou usando o método da API Models.get.

Para conferir as configurações de veiculação associadas a um modelo específico, use o procedimento do console abaixo. Todos os outros detalhes do modelo estão disponíveis no console e na resposta da API.

Console

  1. Acesse a página Modelos no console da Pesquisa para varejo.

    Acessar a página "Modelos"

  2. A página Modelos lista todos os seus modelos e os status de treinamento e consulta.

  3. Clique no nome de um modelo para acessar a página Detalhes.

curl

Para receber as informações de um único modelo, faça uma solicitação Models.get usando a API. Consulte a referência da 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'

Listar seus modelos

Confira uma lista dos seus modelos no console ou usando o método da API Models.list.

Console

  1. Acesse a página Modelos no console da Pesquisa para varejo.

    Acessar a página "Modelos"

  2. A página Modelos lista todos os seus modelos e os status de treinamento e consulta.

curl

Para listar todos os modelos e os detalhes deles inline, faça uma solicitação Models.list usando a API. Consulte a referência da API Models.list.

Também é possível usar o parâmetro pageSize para definir um número máximo de resultados a serem retornados. Se mais resultados estiverem disponíveis, a resposta list vai incluir um token de página. É possível transmitir um token de página no parâmetro pageToken de uma solicitação list para recuperar a próxima página de resultados. O exemplo abaixo usa os dois 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'

Excluir um modelo

É possível iniciar até cinco operações de modelo por minuto. As operações limitadas do modelo incluem criação, exclusão, pausa e retomada.

Excluir um modelo no console ou usando o método da API Models.delete.

Console

  1. Acesse a página Modelos no console da Pesquisa para varejo.

    Acessar a página "Modelos"

  2. Clique no nome do modelo que você quer excluir para abrir a página de detalhes.

  3. Clique em Excluir na barra de botões.

  4. Digite o nome do modelo novamente e clique em Confirmar.

curl

Faça uma solicitação Models.delete usando a API. Consulte a referência da API Models.delete.

Para detalhes sobre todos os campos Models, consulte a referência da 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'