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

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

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

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

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

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

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

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

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

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

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

   כניסה לדף Model Registry

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

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

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

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

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

   כניסה לדף Model Registry

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. במסוף Google Cloud , נכנסים לדף מרשם המודלים של Agent Platform.

   כניסה לדף Model Registry

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
    )