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

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

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

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

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

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

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

כמה דברים שכדאי לדעת על שימוש בכינויים:

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

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

1. במסוף Google Cloud , נכנסים לדף מרשם המודלים של Agent Platform.

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

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

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

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

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

1. במסוף Google Cloud , נכנסים לדף מרשם המודלים של Agent Platform.

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

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

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

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

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

המסוף

1. במסוף Google Cloud , נכנסים לדף מרשם המודלים של Agent Platform.

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

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
    )