העתקת מודל ב-Gemini Enterprise Agent Platform מרשם המודלים

כדי לאמן את מודלי ה-AutoML, המודלים הגדולים והמודלים המותאמים אישית בפלטפורמת הסוכנים לרמה הרצויה, צריך זמן וניסויים. אם יש לכם מודל עם ביצועים טובים שאתם רוצים להשתמש בו בפרויקט או במיקום אחר, אימון של מודל חדש הוא לא האפשרות הכי טובה. האימון של המודל הוא לא דטרמיניסטי, ולכן לא סביר שתקבלו מודל זהה מנתונים זהים. בנוסף, אימון מודל בכל אזור או פרויקט הוא לא דרך בטוחה לשמור על עקביות בהתנהגות המודל בין אזורים שונים. בעזרת Gemini Enterprise Agent Platform Model Registry copy model, אתם יכולים להעתיק מודל מ-Gemini Enterprise Agent Platform מרשם המודלים למיקום נפרד באותו פרויקט או לפרויקט אחר.

הערה: אי אפשר להשתמש באפשרות 'העתקת מודל' כדי להעתיק מודלים של AutoML Natural Language ושל BigQuery ML.

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

מגבלות

כשמעתיקים מודל, לא כל פרטי המודל מועתקים. המודל שהועתק לא ישמור את הדברים הבאים:

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

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

העתקת מודלים בין פרויקטים

דרישות מוקדמות

כדי להעתיק מודל בין פרויקטים, הבעלים של מודל המקור צריך קודם להעניק את הרשאת ייצוא המודל לפרויקט היעד:

ברירת מחדל

1. בוחרים את פרויקט המקור מתוך Google Cloud המסוף.
2. עוברים לדף IAM & Admin.
3. בדף ההרשאות של IAM, לוחצים על Grant access (מתן גישה). חלון קופץ יופיע ויאפשר לכם להוסיף חשבון משתמש חדש לפרויקט המקור.
4. מקבלים את חשבון השירות (P4SA) לכל מוצר ולכל פרויקט service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com של פרויקט היעד.
5. מוסיפים את חשבון P4SA של פרויקט היעד כישות מורשית חדשה לפרויקט המקור ומקצים לו את התפקיד 'סוכן שירות של Gemini Enterprise Agent Platform'.
6. אחרי שלוחצים על שמירה, ל-P4SA של פרויקט היעד יהיו הרשאות לייצא מודלים מפרויקט המקור.

הערה: אם מעניקים את הרשאת ייצוא המודל לפרויקט היעד P4SA, כל מי שיש לו הרשאת העלאת מודל בפרויקט השני יכול להפעיל את תהליך ייצוא המודל.

שימוש בחשבון שירות בהתאמה אישית

1. יוצרים חשבון שירות בהתאמה אישית או משתמשים בחשבון קיים. חשבון השירות הזה צריך להיות שייך לפרויקט היעד שאליו מועתק המודל, וצריכה להיות לכם ההרשאה iam.serviceAccounts.actAs בחשבון השירות הזה.
2. בוחרים את פרויקט המקור מתוך Google Cloud המסוף.
3. עוברים לדף IAM & Admin.
4. בדף ההרשאות של IAM, לוחצים על Grant access (מתן גישה). חלון קופץ יופיע ויאפשר לכם להוסיף חשבון משתמש חדש לפרויקט המקור.
5. מוסיפים את חשבון השירות המותאם אישית כחשבון משתמש חדש לפרויקט המקור ומקצים לו את התפקיד Gemini Enterprise Agent Platform User או כל תפקיד מותאם אישית עם ההרשאה aiplatform.models.export.
6. אחרי שלוחצים על שמירה, לחשבון השירות המותאם אישית יהיו הרשאות לייצא מודלים מפרויקט המקור.
7. מקבלים את חשבון השירות (P4SA) לכל מוצר ולכל פרויקט service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com של פרויקט היעד.
8. מקצים לחשבון P4SA של פרויקט היעד את התפקיד Service Account Token Creator בחשבון השירות המותאם אישית.

העתקת מודלים בין פרויקטים:

REST

הערה: אם אתם משתמשים בחשבון שירות בהתאמה אישית, צריך להוסיף את השדה customServiceAccount בגוף ה-JSON של הבקשה.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫DESTINATION_LOCATION: האזור שאליו רוצים להעתיק את המודל. לדוגמה, us-central1.
• ‫DESTINATION_PROJECT_ID: מזהה הפרויקט או מספר הפרויקט שאליו רוצים להעתיק את המודל.
• ‫SOURCE_PROJECT_ID: מזהה הפרויקט או מספר הפרויקט.
• ‫SOURCE_LOCATION: האזור ב-Agent Platform שממנו מעתיקים מודל.
• ‫SOURCE_MODEL_ID: המקור של מזהה המודל להעתקה.
• ‫VERSION_ID: (אופציונלי) מזהה של גרסת המודל להעתקה (אם לא מצוין, מועתקת גרסת ברירת המחדל)

ה-method של ה-HTTP וכתובת ה-URL:

POST https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/models:copy

תוכן בקשת JSON:

   {
    "sourceModel": "projects/SOURCE_PROJECT_ID/locations/SOURCE_LOCATION/models/SOURCE_MODEL_ID"
    }

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/models:copy"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/models:copy" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

  {
    "name": "projects/PROJECT_ID/locations/LOCATION/models/MODEL_ID/operations/OPERATION_ID",
    "metadata": {
      "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CopyModelOperationMetadata",
      "genericMetadata": {
        "createTime": "2022-07-01T00:10:55.621355Z",
        "updateTime": "2022-07-01T00:10:55.621355Z"
      }
    }
  }

המסוף

כדי להעתיק מודלים לפרויקט אחר, פועלים לפי ההוראות הבאות.

1. נכנסים לדף Gemini Enterprise Agent Platform מרשם המודלים במסוף Google Cloud . מעבר למרשם המודלים של Gemini Enterprise Agent Platform
2. במאגר המודלים, בוחרים את תפריט פעולות נוספות של המודל שרוצים להעתיק.
   
3. לוחצים על העתקת המודל.
4. בוחרים באפשרות לפרויקט אחר או לאזור אחר.

העתקת מודל לפרויקט אחר

1. בוחרים באפשרות לפרויקט אחר.
2. בוחרים את גרסת המודל שרוצים להעתיק.
3. בוחרים את פרויקט היעד שאליו רוצים להעתיק.
4. בוחרים את אזור היעד, לדוגמה, us-central1.
5. אפשרויות מתקדמות: אפשר לבחור את שיטת ההצפנה באמצעות Google-owned and Google-managed encryption key או מפתח Cloud KMS.

העתקת מודלים בין מיקומים

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫DESTINATION_LOCATION: האזור שבו משתמשים ב-Agent Platform. לדוגמה, us-central1.
• ‫SOURCE_LOCATION: האזור ב-Agent Platform שממנו תעתיקו את המודל.
• ‫PROJECT_ID: מזהה הפרויקט או מספר הפרויקט.
• ‫MODEL_ID:המזהה של המודל שרוצים להעתיק.
• ‫VERSION_ID: (אופציונלי) מזהה של גרסת המודל להעתקה (אם לא מצוין, מועתקת גרסת ברירת המחדל)

ה-method של ה-HTTP וכתובת ה-URL:

POST https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy

תוכן בקשת JSON:

{"sourceModel": "projects/PROJECT_ID/locations/SOURCE_LOCATION/models/MODEL_ID[@VERSION_ID]"
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

  {
    "name": "projects/PROJECT_ID/locations/LOCATION/models/MODEL_ID/operations/OPERATION_ID",
    "metadata": {
      "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CopyModelOperationMetadata",
      "genericMetadata": {
        "createTime": "2022-07-01T00:10:55.621355Z",
        "updateTime": "2022-07-01T00:10:55.621355Z"
      }
    }
  }

המסוף

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

כדי להעתיק מודלים, פועלים לפי ההוראות הבאות.

1. נכנסים לדף Gemini Enterprise Agent Platform מרשם המודלים במסוף Google Cloud . כניסה למרשם המודלים
2. במאגר המודלים, בוחרים את תפריט פעולות נוספות של המודל שרוצים להעתיק.
   
3. לוחצים על העתקת המודל.
4. בוחרים באפשרות לפרויקט אחר או לאזור אחר.

העתקת מודל לאזור אחר

1. בוחרים באפשרות לאזור אחר.
2. בוחרים את גרסת המודל שרוצים להעתיק.
3. בוחרים באפשרות העתקה כמודל חדש או באפשרות העתקה כגרסה חדשה.
4. בוחרים את אזור היעד.
5. מוסיפים את שם מודל היעד או את מזהה המודל. אם מעתיקים מודל בפעם הראשונה, המערכת מקצה לו את הכינוי שמוגדר כברירת מחדל באזור החדש.