Aliase für Modellversionen verwenden

Ein Modellalias ist ein änderbarer, benannter Verweis auf eine Modellversion, die innerhalb einer Modellressource eindeutig ist. Ein Alias ist "veränderlich", da Aliasse von einer Modellversion in eine andere verschoben und "benannt" werden können, da es sich um benutzerdefinierte Strings handelt. Modellaliasse sind hilfreich, um eine bestimmte Modellversion durch Verweis abzurufen oder bereitzustellen, ohne die ID der jeweiligen Version zu kennen. Auf diese Weise funktionieren sie ähnlich wie Docker-Tags oder Zweigreferenzen in Git.

Wenn Sie ein neues Modell in Model Registry erstellen, wird der ersten Version automatisch der Alias default zugewiesen. Der Standardalias verweist auf die Modellversion, die verwendet wird, wenn ein Nutzer einen Befehl für ein Modell ausführt, ohne eine bestimmte Version anzugeben. Für die Übertragung des Standardalias ist immer eine Version eines Modells erforderlich. Ansonsten verhält sich der Standardalias wie jeder andere benutzerdefinierte Alias.

In der Google Cloud Console kann die Alias-Markierung den Beteiligten auf einen Blick helfen, welches Modell die stabile Version ist, die bereit für die Bereitstellung ist. Neben dem Standard-Alias können Sie Ihre eigenen benutzerdefinierten Aliasse erstellen und Modellen in Model Registry zuweisen.

In Model Registry sehen Sie in der Alias-Spalte auf einen Blick, welche Modellversion den Standardalias hat.

Wenn Sie den Alias einer anderen Modellversion zuweisen möchten, können Sie Aliasse einfach in eine andere Version verschieben.

Hinweis: Das erforderliche Format des Versionsalias ist [a-z][a-zA-Z0-9-]{0,126}[a-z0-9], um es von version_id zu unterscheiden. Für die erste Version des Modells wird ein Alias der Standardversion erstellt. Für jedes Modell muss genau ein Alias der Standardversion vorhanden sein.

Beachten Sie bei der Verwendung von Aliassen Folgendes:

• Die Versionsaliasse sollten einmalig sein. Ein Alias kann jeweils immer nur einer Version für ein Modell zugewiesen sein.
• Versionsaliasse dürfen nicht numerisch sein.
• Wenn Sie keine Modellversion für die Produktion angeben, wird das Standardmodell verwendet.
• Ein Alias unterscheidet sich von einem Label. Weitere Informationen zu Modelllabels finden Sie hier.
• Wenn Sie einen vorhandenen Alias anwenden, der in einer anderen Modellversion verwendet wird, wird der Alias aus dieser Version entfernt.

Modellversion als Standard festlegen

1. Rufen Sie in der Google Cloud Console die Seite Vertex AI Model Registry auf.

   Zur Seite Model Registry

2. Wählen Sie in Model Registry den Namen des Modells aus, das Sie bearbeiten möchten. Das Fenster mit den Modelldetails wird geöffnet. Alle Modellversionen werden aufgelistet. Eine der Modellversionen hat den Alias Standard.

3. Klicken Sie auf die Schaltfläche Aktionen für die Modellversion, die Sie die Standardversion zuweisen möchten.

4. Klicken Sie auf Als Standard festlegen.

Alias einer Modellversion hinzufügen

1. Rufen Sie in der Google Cloud Console die Seite Vertex AI Model Registry auf.

   Zur Seite Model Registry

2. Wählen Sie in Model Registry den Namen des Modells aus, das Sie bearbeiten möchten. Das Fenster mit den Modelldetails wird geöffnet.

3. Wählen Sie auf der Detailseite die gewünschte Modellversion aus und klicken Sie auf Mehr.

4. Klicken Sie auf Alias bearbeiten. Wählen Sie Neu hinzufügen aus.

5. Alias bearbeiten: Klicken Sie auf Alias hinzufügen und geben Sie den Namen des Alias ein, den Sie der Modellversion hinzufügen möchten.

6. Klicken Sie auf Speichern.

Modellversion mit neuem Alias hochladen

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

Hinweis: Wenn die Spalte „Alias“ nicht angezeigt wird, klicken Sie auf die Schaltfläche Spaltenanzeigeoptionen, um sicherzustellen, dass das Aliasspaltenelement für die Anzeige ausgewählt ist.

Modellalias löschen

Wenn Sie eine Modellversion löschen, die dem Standardalias zugewiesen ist, wird der Alias automatisch der nächsten Version zugewiesen.

Console

1. Rufen Sie in der Google Cloud Console die Seite Vertex AI Model Registry auf.

   Zur Seite Model Registry

2. Wählen Sie in Model Registry den Namen des Modells aus, das Sie bearbeiten möchten. Das Fenster mit den Modelldetails wird geöffnet.

3. Klicken Sie auf der Detailseite auf die Schaltfläche Aktionen bei der Modellversion.

4. Klicken Sie auf Alias bearbeiten.

5. Eine Liste der mit der Modellversion verknüpften Aliasse wird angezeigt. Bewegen Sie den Mauszeiger rechts neben das Alias-Textfeld für das Label, damit das Papierkorbsymbol angezeigt wird.

6. Klicken Sie für den Alias, die Sie löschen möchten, auf das Papierkorbsymbol.

7. Klicken Sie auf Speichern.

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
    )