Come utilizzare gli alias versione del modello

Un alias del modello è un riferimento denominato e modificabile a una versione del modello univoca all'interno di una risorsa modello. Un alias è "modificabile" perché può essere spostato da una versione del modello a un'altra e "denominato" perché è una stringa arbitraria definita dall'utente. Gli alias del modello sono utili per recuperare o eseguire il deployment di una particolare versione del modello per riferimento senza dover conoscere l'ID specifico della versione. 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 particolare. È necessario che una versione di un modello abbia sempre l'alias predefinito. In caso contrario, l'alias predefinito si comporta come qualsiasi altro alias definito dall'utente.

Dallaconsolle, il marcatore dell'alias può aiutare le parti interessate a capire a colpo d'occhio qual è la versione stabile del modello pronta per il deployment. Google Cloud Oltre all'alias predefinito, puoi creare e assegnare i tuoi alias personalizzati ai modelli in Model Registry.

In Model Registry, puoi vedere a colpo d'occhio quale versione del modello ha l'alias predefinito esaminando la colonna dell'alias.

Se decidi di riassegnare l'alias a una versione del modello diversa, puoi spostare gli alias in un'altra versione.

Nota: il formato obbligatorio dell'alias della versione è [a-z][a-z0-9-]{0,126}[a-z0-9] per distinguerlo da version_id. Verrà creato un alias della versione predefinita per la prima versione del modello e deve esistere esattamente un alias della versione predefinita per un modello.

Alcune considerazioni sull'utilizzo degli alias:

• Gli alias della versione devono essere univoci e un alias può essere assegnato a una sola versione, per modello, alla volta.
• Gli alias della 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 che viene utilizzato in un'altra versione del modello, l'alias viene rimosso da quella versione.

Impostare una versione del modello come predefinita

1. Nella Google Cloud console, vai alla pagina Model Registry di Vertex AI.

   Vai alla pagina Model Registry

2. In Model Registry, seleziona il nome del modello che vuoi modificare. Viene visualizzata la finestra dei dettagli del modello. Sono elencate tutte le versioni del modello. Una delle versioni del modello ha l'alias default.

3. Seleziona il pulsante Azioni per la versione del modello a cui vuoi assegnare la versione predefinita.

4. Fai clic su Imposta come predefinito.

Aggiungere un alias a una versione del modello

1. Nella Google Cloud console, vai alla pagina Model Registry di Vertex AI.

   Vai alla pagina Model Registry

2. In Model Registry, seleziona il nome del modello che vuoi modificare. Viene visualizzata la finestra dei dettagli del modello.

3. Nella pagina dei dettagli, seleziona la versione del modello che vuoi e fai clic su Altro.

4. Fai clic su Modifica alias. Seleziona Aggiungi nuovo.

5. Modifica alias: fai clic su Aggiungi alias e inserisci il nome dell'alias che vuoi aggiungere alla versione del modello.

6. Fai clic su Salva.

Caricare una nuova versione del modello con alias

API

Python

from typing import List

from google.cloud import aiplatform


def upload_new_aliased_model_version_sample(
    parent_name: str,
    artifact_uri: str,
    serving_container_image: str,
    is_default_version: bool,
    version_aliases: List[str],
    version_description: str,
    project: str,
    location: str,
):
    """
    Uploads a new aliased version of a model with ID 'model_id'.
    Args:
        parent_name: The parent resource name of an existing model.
        artifact_uri: The URI of the model artifact to upload.
        serving_container_image: The name of the serving container image to use.
        is_default_version: Whether this version is the default version of the model.
        version_aliases: The aliases of the model version.
        version_description: The description of the model version.
        project: The project ID.
        location: The region name.
    Returns:
        The new version of the model.
    """
    # Initialize the client.
    aiplatform.init(project=project, location=location)

    # Upload a new aliased version of the Model resource with the ID 'model_id'. The parent_name of Model resource can be also
    # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
    model = aiplatform.Model.upload(
        artifact_uri=artifact_uri,
        serving_container_image=serving_container_image,
        parent_name=parent_name,
        is_default_version=is_default_version,
        version_aliases=version_aliases,
        version_description=version_description,
    )

    return model

Nota: se non vedi la colonna Alias, potrebbe essere necessario fare clic sul pulsante Opzioni di visualizzazione delle colonne per assicurarti che l'elemento della colonna Alias sia selezionato per la visualizzazione.

Eliminare un alias del modello

Quando elimini una versione del modello a cui è assegnato l'alias predefinito, l'alias viene assegnato automaticamente alla versione più recente successiva.

Console

1. Nella Google Cloud console, vai alla pagina Model Registry di Vertex AI.

   Vai alla pagina Model Registry

2. In Model Registry, seleziona il nome del modello che vuoi modificare. Viene visualizzata la finestra dei dettagli del modello.

3. Nella pagina dei dettagli, fai clic sul pulsante Azioni nella versione del modello.

4. Fai clic su Modifica alias.

5. Viene visualizzato un elenco degli alias collegati alla versione del modello. Passa il mouse a destra del campo Alias per l'etichetta per visualizzare l'icona di eliminazione.

6. Fai clic sull'icona di eliminazione per l'alias che vuoi eliminare.

7. Fai clic su Salva.

API

Python

from typing import List

from google.cloud import aiplatform


def delete_aliases_model_version_sample(
    model_id: str,
    version_aliases: List[str],
    version_id: str,
    project: str,
    location: str,
):
    """
    Delete aliases to a model version.
    Args:
        model_id: The ID of the model.
        version_aliases: The version aliases to assign.
        version_id: The version ID of the model to assign the aliases to.
        project: The project ID.
        location: The region name.
    Returns
        None.
    """
    # Initialize the client.
    aiplatform.init(project=project, location=location)

    # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of Model resource can be also
    # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
    model_registry = aiplatform.models.ModelRegistry(model=model_id)

    # Remove the version aliases to the model version with the version 'version'.
    model_registry.remove_version_aliases(
        target_aliases=version_aliases, version=version_id
    )