Come utilizzare gli alias di versione del modello

Un alias del modello è un riferimento denominato modificabile a una versione del modello univoca all'interno di una risorsa del modello. Un alias è "mutabile" perché è possibile spostare gli alias da una versione del modello a un altro e "con nome" perché sono stringhe arbitrarie definite dall'utente. Modello sono utili per recuperare o eseguire il deployment di una determinata versione 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, la prima versione viene assegnato automaticamente l'alias predefinito. L'alias predefinito fa riferimento la versione del modello utilizzata se un utente esegue un comando su un modello senza che specifica una determinata versione. È necessaria una versione di un modello per avere quello predefinito alias. Altrimenti, l'alias predefinito si comporta come qualsiasi altro alias definito dall'utente.

Dalla console Google Cloud, l'indicatore alias può aiutare gli stakeholder a comprendere a colpo d'occhio la versione stabile pronta per il deployment. Oltre alla sezione alias predefinito, puoi creare e assegnare i tuoi alias personalizzati ai modelli in Model Registry.

In Model Registry, puoi vedere all'istante quale modello ha l'alias predefinito osservando la colonna degli alias.

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

Alcune considerazioni sull'uso degli alias:

• Gli alias di versione devono essere univoci. e un alias può essere assegnato a una singola versione, per modello, alla volta.
• 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 del modello qui.
• Se applichi un alias esistente che viene usato in un'altra versione del modello, l'alias viene rimosso dalla versione.

Imposta una versione del modello come predefinita

1. Nella console Google Cloud, vai al registro dei modelli di Vertex AI .

   Vai alla pagina del registro dei modelli

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

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

4. Fai clic su Imposta come predefinito.

Aggiungi un alias a una versione del modello

1. Nella console Google Cloud, vai al registro dei modelli di Vertex AI .

   Vai alla pagina del registro dei modelli

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

3. Dalla pagina dei dettagli, seleziona la versione del modello che ti interessa 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 desiderato. da aggiungere alla versione del modello.

6. Fai clic su Salva.

Carica una nuova versione del modello con alias

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

Elimina l'alias di un modello

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

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
    )