איך משתמשים בשמות בדויים של גרסאות מודל

כינוי של מודל הוא הפניה בעלת שם לגרסת מודל, שניתנת לשינוי וייחודית במשאב מודל. כינוי הוא 'ניתן לשינוי' כי אפשר להעביר כינויים מגרסה אחת של מודל לגרסה אחרת, ו'בעל שם' כי הם מחרוזות שרירותיות שמוגדרות על ידי המשתמש. כינויי מודלים עוזרים לאחזר או לפרוס גרסה מסוימת של מודל באמצעות הפניה, בלי לדעת את המזהה הספציפי של הגרסה. בצורה הזו, הם פועלים באופן דומה לתגי Docker או להפניות לענפים ב-Git.

כשיוצרים מודל חדש במאגר המודלים, הגרסה הראשונה מקבלת באופן אוטומטי את הכינוי default. כינוי ברירת המחדל מפנה לגרסת המודל שבה נעשה שימוש אם משתמש מריץ פקודה במודל בלי לציין גרסה מסוימת. גרסה אחת של המודל צריכה לשאת את הכינוי שמוגדר כברירת מחדל בכל רגע נתון. אחרת, הכינוי שמוגדר כברירת מחדל מתנהג כמו כל כינוי אחר שהמשתמש מגדיר.

במסוף Google Cloud , סמן הכינוי יכול לעזור לבעלי עניין להבין במבט חטוף איזה מודל הוא הגרסה היציבה שמוכנה לפריסה. בנוסף לכינוי ברירת המחדל, אתם יכולים ליצור כינויים מותאמים אישית משלכם ולהקצות אותם למודלים במאגר המודלים.

במאגר המודלים, אפשר לראות במבט חטוף איזו גרסה של המודל כוללת את הכינוי שמוגדר כברירת מחדל, בעמודת הכינוי.

אם תחליטו שאתם רוצים להקצות מחדש את הכינוי לגרסה אחרת של המודל, תוכלו להעביר כינויים לגרסה אחרת.

הערה: הפורמט הנדרש של שם הגרסה הוא [a-z][a-z0-9-]{0,126}[a-z0-9] כדי להבדיל בין version_id. כינוי גרסת ברירת מחדל ייצור עבור הגרסה הראשונה של המודל, וחייב להיות בדיוק כינוי אחד של גרסת ברירת מחדל לכל מודל.

כמה דברים שכדאי לזכור כשמשתמשים בכתובות אימייל חלופיות:

• כינויי הגרסאות צריכים להיות ייחודיים, וכל כינוי יכול להיות משויך רק לגרסה אחת של מודל בכל פעם.
• כינויי גרסה לא יכולים להיות מספריים.
• אם לא מציינים גרסת מודל להפקה, המערכת משתמשת במודל שמוגדר כברירת מחדל.
• כינוי שונה מתווית. מידע נוסף על תוויות של מודלים
• אם אתם מחילים כינוי קיים שמשמש בגרסה אחרת של המודל, הכינוי יוסר מהגרסה הזו.

הגדרת גרסת מודל כברירת מחדל

1. נכנסים לדף Model Registry של Vertex AI במסוף Google Cloud .

   כניסה לדף מרשם המודלים

2. במאגר המודלים, בוחרים את שם המודל שרוצים לערוך. ייפתח חלון עם פרטי המודל. כל הגרסאות של המודל מופיעות ברשימה. אחת מגרסאות המודל כוללת את הכינוי default.

3. לוחצים על הלחצן פעולות לצד גרסת המודל שרוצים להגדיר כגרסת ברירת המחדל.

4. לוחצים על הגדרה כברירת מחדל.

הוספת כינוי לגרסת מודל

1. נכנסים לדף Model Registry של Vertex AI במסוף Google Cloud .

   כניסה לדף מרשם המודלים

2. במאגר המודלים, בוחרים את שם המודל שרוצים לערוך. ייפתח חלון עם פרטי המודל.

3. בדף הפרטים, בוחרים את גרסת המודל הרצויה ולוחצים על עוד.

4. לוחצים על עריכת הכינוי. לוחצים על הוספה.

5. עריכת כינוי: לוחצים על הוספת כינוי ומזינים את שם הכינוי שרוצים להוסיף לגרסת המודל.

6. לוחצים על שמירה.

העלאה של גרסה חדשה של מודל עם כינוי

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

הערה: אם העמודה 'כינוי' לא מוצגת, יכול להיות שתצטרכו ללחוץ על הלחצן אפשרויות להצגת עמודות כדי לוודא שהאפשרות 'כינוי' מסומנת להצגה.

מחיקת כינוי של מודל

כשמוחקים גרסת מודל שהוקצה לה הכינוי שמוגדר כברירת מחדל, הכינוי מוקצה באופן אוטומטי לגרסה הבאה הכי עדכנית.

המסוף

1. נכנסים לדף Model Registry של Vertex AI במסוף Google Cloud .

   כניסה לדף מרשם המודלים

2. במאגר המודלים, בוחרים את שם המודל שרוצים לערוך. ייפתח חלון עם פרטי המודל.

3. בדף הפרטים, לוחצים על הלחצן פעולות בגרסת המודל.

4. לוחצים על עריכת הכינוי.

5. מוצגת רשימה של הכינויים שמצורפים לגרסת המודל. מעבירים את הסמן שמאלה לשדה 'כינוי' של התווית כדי להציג את סמל המחיקה.

6. לוחצים על סמל המחיקה לצד הכינוי שרוצים למחוק.

7. לוחצים על Save.

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
    )