Um alias de modelo é uma referência mutável e nomeada de uma versão de modelo exclusiva dentro de um recurso de modelo. Um alias é "mutável", porque pode ser movido de uma versão de modelo para outra e "nomeado" porque são strings arbitrárias definidas pelo usuário. Os aliases de modelo são úteis para buscar ou implantar uma versão de modelo específica por referência sem precisar saber o código dela. Dessa forma, elas operam de maneira semelhante às tags do Docker ou às referências do Branch no Git.
Quando você cria um modelo novo no Model Registry, a primeira versão recebe automaticamente o alias padrão. O alias padrão faz referência à versão do modelo que será usada se um usuário executar um comando em um modelo sem especificar uma versão específica. É necessário ter uma versão de um modelo para manter o alias padrão em todos os momentos. Caso contrário, o alias padrão se comportará como qualquer outro alias definido pelo usuário.
No Console do Google Cloud, o marcador de alias ajuda as partes interessadas a entender rapidamente qual modelo é a versão estável pronta para implantação. Além do alias padrão, é possível criar e atribuir seus próprios aliases personalizados a modelos no Model Registry.
No Model Registry, é possível ver rapidamente qual versão de modelo tem o alias padrão na coluna de alias.
Se você decidir reatribuir o alias a uma versão de modelo diferente, poderá mover facilmente os aliases para uma versão diferente.
Algumas considerações para usar aliases:
- Os aliases de versão precisam ser exclusivos. e um alias só podem ser atribuídos a uma única versão, por modelo, por vez.
- Os aliases de versão não podem ser numéricos.
- Se você não especificar uma versão do modelo para produção, o modelo padrão será usado.
- Um alias é diferente de um rótulo. Saiba mais sobre rótulos de modelo aqui.
- Se você aplicar um alias existente que seja usado em outra versão do modelo, o alias será removido dessa versão.
Definir uma versão de modelo como padrão
No console do Google Cloud, acesse a página Registro de modelos da Vertex AI.
No Model Registry, selecione o nome do modelo que você quer editar. A janela de detalhes do modelo será aberta. Todas as versões do modelo são listadas. Uma das versões de modelo tem o alias default.
Selecione o botão Ações da versão de modelo à qual você quer atribuir a versão padrão.
Clique em Definir como padrão.
Adicionar um alias a um modelo
No console do Google Cloud, acesse a página Registro de modelos da Vertex AI.
No Model Registry, selecione o nome do modelo que você quer editar. A janela de detalhes do modelo será aberta.
Na página de detalhes, selecione a versão do modelo que você quer e clique em Mais.
Clique em Editar alias. Selecione Adicionar novo.
Editar alias: clique em Adicionar alias e insira o nome do alias que você quer adicionar ao modelo.
Clique em Salvar.
Fazer upload de uma nova versão de modelo com alias
API
Python
Excluir um alias de modelo
Quando você exclui uma versão de modelo atribuída ao alias padrão, o alias é atribuído automaticamente à próxima versão mais recente.
Console
No console do Google Cloud, acesse a página Registro de modelos da Vertex AI.
No Model Registry, selecione o nome do modelo que você quer editar. A janela de detalhes do modelo será aberta.
Na página de detalhes, clique no botão Ações na versão do modelo.
Clique em Editar alias.
Uma lista dos aliases anexados à versão de modelo é exibida. Passe o cursor à direita da caixa de texto "Alias" para que o rótulo exiba o ícone de exclusão.
Clique no ícone de exclusão do alias que você quer excluir.
Clique em Save.