Nesta página, descrevemos como ajustar, pausar, retomar, excluir e listar modelos de recomendação. Para receber ajuda com a criação de 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
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.
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. Faz o ajuste automaticamente quando o último foi feito 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 mais detalhes sobre 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 modelo quando há uma mudança significativa em seu catálogo (como aumento de tamanho ou alteração na hierarquia do catálogo) ou eventos (como o 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
Acesse a página Modelos no console da Pesquisa para varejo.
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 novo treinamento consistente, certifique-se que você faça o upload de dados de eventos do usuário no máximo 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
Acesse a página Modelos no console do Search 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 do treinamento de PAUSADO), clique em Retomar play_arrow.
curl
Para pausar um modelo ativo, faça uma solicitação Models.pause usando o
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 o
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
Acesse os detalhes de um modelo no console ou use o método de API Models.get.
Para ver as configurações de veiculação associadas a um modelo específico, use o do console do Cloud, abaixo. Todos os outros detalhes do modelo estão disponíveis e a resposta da API.
Console
Acesse a página Modelos no console da Pesquisa para varejo.
Acessar a página "Modelos"A página Modelos lista todos os seus modelos e os status de treinamento e consulta.
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 o
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 de API Models.list.
Console
Acesse a página Modelos no console da Pesquisa para varejo.
Acessar a página "Modelos"A página Modelos lista todos os seus modelos e os status de treinamento e consulta.
curl
Para listar todos os modelos e os respectivos detalhes in-line, faça uma solicitação Models.list.
usando a API. Consulte a API Models.list
de referência.
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 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 use o método de API Models.delete.
Console
Acesse a página Modelos no console da Pesquisa para varejo.
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 mais detalhes sobre 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'