Nesta página, descrevemos como ajustar, pausar, retomar, excluir e listar modelos de recomendação. Para ajuda sobre como criar um novo modelo de recomendação, consulte Criar modelos de recomendação.
Ajustar um modelo
A Vertex AI para Pesquisa para varejo usa os dados de entrada que você fornece ao seu modelo para ajustar os 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
Acesse a página Modelos no console da Pesquisa for Retail.
Acessar a página "Modelos"Você pode ver o status de ajuste de cada modelo em Status de ajuste.
Clique no nome de um modelo para ver a respectiva página de detalhes.
Clique em Editar edit ao lado de Status do ajuste.
Na lista suspensa, selecione uma configuração:
- A cada três meses. Ajusta automaticamente quando a última música foi feita há 90 dias.
- Somente ajuste manual. Ajustar somente quando você fizer o ajuste manual.
Clique em Concluído done 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 seu modelo quando houver uma mudança significativa no catálogo (como aumento de tamanho ou mudança na hierarquia do catálogo) ou eventos (como preenchimento de eventos históricos ou uma alteração 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
Acesse a página Modelos no console da Pesquisa for Retail.
Acessar a página "Modelos"Clique no nome de um modelo para ver a respectiva página de detalhes.
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 um retreinamento consistente, faça upload dos dados de eventos do usuário no máximo 24 horas após a ocorrência do evento.
É possível pausar seu modelo para interromper o novo treinamento. Faça isso se tiver importado dados inválidos ou ficar abaixo do limite de 10 modelos ativos por projeto. Se você tiver menos de 10 modelos ativos, será 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
Acesse a página Modelos no console da Pesquisa for Retail.
Acessar a página "Modelos"Veja o status de cada modelo em Status do treinamento.
Para pausar um modelo ativo (Status de treinamento de Training), clique em Pausar pause.
Para iniciar um modelo pausado (Status de treinamento PAUSADO), clique em Retomar play_arrow.
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 use o método de API Models.get
.
Para ver as configurações de exibiçã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
Acesse a página Modelos no console da Pesquisa for Retail.
Acessar a página "Modelos"A página Modelos lista todos os seus modelos e os respectivos status de treinamento e consulta.
Clique no nome de um modelo para ver a página Detalhes dele.
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'
Liste seus modelos
Confira uma lista de seus modelos no console ou usando o método de API Models.list
.
Console
Acesse a página Modelos no console da Pesquisa for Retail.
Acessar a página "Modelos"A página Modelos lista todos os seus modelos e os respectivos 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
.
Se preferir, use 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. Você pode 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.
Exclua um modelo no console ou usando o método de API Models.delete
.
Console
Acesse a página Modelos no console da Pesquisa for Retail.
Acessar a página "Modelos"Clique no nome do modelo que você quer excluir para abrir a página de detalhes.
Clique em Excluirdelete na barra de botões.
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'