Cómo usar los alias de la versión de modelo

Un alias del modelo es una referencia mutable con nombre a una versión del modelo única dentro de un recurso de modelo. Un alias es “mutable” porque se puede mover de una versión del modelo a otra y “con nombre” porque son strings arbitrarias definidas por el usuario. Los alias de modelo son útiles para recuperar o implementar una versión del modelo en particular por referencia sin necesidad de conocer el ID de la versión específica. De esta manera, funcionan de manera similar a las etiquetas de Docker o a las referencias de ramas en Git.

Cuando creas un modelo nuevo en Model Registry, a la primera versión se le asigna automáticamente el alias predeterminado. El alias predeterminado hace referencia a la versión del modelo que se usará si un usuario ejecuta un comando en un modelo sin especificar una versión particular. Una versión de un modelo debe llevar el alias predeterminado en todo momento. De lo contrario, el alias predeterminado se comporta como cualquier otro alias definido por el usuario.

En la consola de Google Cloud, el marcador de alias puede ayudar a las partes interesadas a comprender con rapidez qué modelo es la versión estable lista para su implementación. Además del alias predeterminado, puedes crear y asignar tus propios alias personalizados a los modelos en Model Registry.

En Model Registry, puedes ver a simple vista qué versión del modelo tiene el alias predeterminado si observas la columna de alias.

La columna de alias y la etiqueta de alias predeterminada.

Si decides reasignar el alias a una versión de modelo diferente, puedes mover los alias con facilidad a una versión diferente.

A continuación, se detallan algunas consideraciones para el uso de alias:

  • Los alias de tu versión deben ser únicos; y un alias solo se puede asignar a una sola versión, por modelo, a la vez.
  • Los alias de la versión no deben ser numéricos.
  • Si no especificas una versión del modelo para la producción, se usa el modelo predeterminado.
  • Un alias es diferente a una etiqueta. Obtén más información sobre las etiquetas de modelos aquí.
  • Si aplicas un alias existente que se usa en otra versión del modelo, el alias se quita de esa versión.

Configura una versión del modelo como predeterminada

  1. En la consola de Google Cloud, ve a la página Model Registry de Vertex AI.

    Ir a la página Model Registry

  2. En el registro de modelos, selecciona el nombre del modelo que deseas editar. Se abre la ventana de detalles del modelo. Se enumeran todas las versiones del modelo. Una de las versiones del modelo tiene el alias predeterminado.

  3. Selecciona el botón Acciones para la versión del modelo a la que deseas asignar la versión predeterminada.

  4. Haz clic en Establecer como predeterminado.

Agrega un alias a una versión modelo

  1. En la consola de Google Cloud, ve a la página Model Registry de Vertex AI.

    Ir a la página Model Registry

  2. En el registro de modelos, selecciona el nombre del modelo que deseas editar. Se abre la ventana de detalles del modelo.

  3. En la página de detalles, selecciona la versión del modelo que deseas y haz clic en Más.

  4. Haz clic en Editar alias. Selecciona Añadir nuevo.

  5. Editar alias: Haz clic en Agregar alias y, luego, ingresa el nombre del alias que deseas agregar a la versión del modelo.

  6. Haga clic en Guardar.

Sube una nueva versión del modelo 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

Borra un alias del modelo

Cuando borras una versión del modelo al que se le asignó el alias predeterminado, este se asigna automáticamente a la siguiente versión más reciente.

Console

  1. En la consola de Google Cloud, ve a la página Model Registry de Vertex AI.

    Ir a la página Model Registry

  2. En el registro de modelos, selecciona el nombre del modelo que deseas editar. Se abre la ventana de detalles del modelo.

  3. En la página de detalles, haz clic en el botón Acciones en la versión del modelo.

  4. Haz clic en Editar alias.

  5. Aparecerá una lista de los alias adjuntos a la versión del modelo. Coloca el cursor sobre la derecha del cuadro de texto de alias para que la etiqueta muestre el ícono de borrar.

  6. Haz clic en el ícono de borrar para el alias que deseas borrar.

  7. Haz clic en Guardar.

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
    )