Un alias modello è un riferimento denominato modificabile a una versione univoca del modello all'interno di una risorsa del modello. Un alias è "modificabile" perché gli alias possono essere spostati da una versione del modello a un'altra e vengono "denominati" perché sono stringhe arbitrarie definite dall'utente. Gli alias del modello sono utili per recuperare o eseguire il deployment di una determinata versione di un modello tramite riferimento senza dover conoscere l'ID della versione specifica. In questo modo, funzionano in modo simile ai tag Docker o ai riferimenti ai rami in Git.
Quando crei un nuovo modello in Model Registry, alla prima versione viene assegnato automaticamente l'alias default. L'alias predefinito fa riferimento alla versione del modello utilizzata se un utente esegue un comando su un modello senza specificare una versione specifica. È necessaria una versione di un modello per avere sempre l'alias predefinito. In caso contrario, l'alias predefinito si comporta come qualsiasi altro alias definito dall'utente.
Dalla console Google Cloud, l'indicatore dell'alias può aiutare gli stakeholder a capire rapidamente quale modello è la versione stabile pronta per il deployment. Oltre all'alias predefinito, puoi creare e assegnare alias personalizzati ai modelli nel registro dei modelli.
In Model Registry, puoi vedere a colpo d'occhio la versione del modello con l'alias predefinito osservando la colonna alias.
Se decidi di riassegnare l'alias a una versione diversa del modello, puoi spostare facilmente gli alias in una versione diversa.
Alcune considerazioni sull'utilizzo degli alias:
- Gli alias di versione devono essere univoci e un alias può essere assegnato a una sola versione alla volta per modello.
- Gli alias di versione non devono essere numerici.
- Se non specifichi una versione del modello per la produzione, viene utilizzato il modello predefinito.
- Un alias è diverso da un'etichetta. Scopri di più sulle etichette dei modelli qui.
- Se applichi un alias esistente utilizzato in un'altra versione del modello, l'alias viene rimosso da quella versione.
Imposta una versione del modello come predefinita
Nella console Google Cloud, vai alla pagina Model Registry di Vertex AI.
In Model Registry, seleziona il nome del modello che vuoi modificare. Si apre la finestra dei dettagli del modello. Sono elencate tutte le versioni. Una delle versioni del modello ha l'alias predefinito.
Seleziona il pulsante Azioni per la versione del modello che desideri assegnare alla versione predefinita.
Fai clic su Imposta come predefinito.
Aggiungi un alias a una versione del modello
Nella console Google Cloud, vai alla pagina Model Registry di Vertex AI.
In Model Registry, seleziona il nome del modello che vuoi modificare. Si apre la finestra dei dettagli del modello.
Nella pagina dei dettagli, seleziona la versione del modello che preferisci e fai clic su Altro.
Fai clic su Modifica alias. Seleziona Aggiungi nuovo.
Modifica alias:fai clic su Aggiungi alias e inserisci il nome dell'alias che vuoi aggiungere alla versione del modello.
Fai clic su Salva.
Carica una nuova versione del modello con alias
API
Python
Elimina un alias del modello
Quando elimini una versione del modello a cui è stato assegnato l'alias predefinito, quest'ultimo viene assegnato automaticamente alla versione più recente successiva.
Console
Nella console Google Cloud, vai alla pagina Model Registry di Vertex AI.
In Model Registry, seleziona il nome del modello che vuoi modificare. Si apre la finestra dei dettagli del modello.
Nella pagina dei dettagli, fai clic sul pulsante Azioni sulla versione del modello.
Fai clic su Modifica alias.
Viene visualizzato un elenco degli alias associati alla versione del modello. Passa il cursore a destra della casella di testo Alias per visualizzare l'icona di eliminazione dell'etichetta.
Fai clic sull'icona di eliminazione relativa all'alias che desideri eliminare.
Fai clic su Salva.