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

כדי לאמן את AutoML, מודלים גדולים ומודלים בהתאמה אישית ב-Agent Platform לרמה הרצויה, צריך זמן וניסויים. אם יש לכם מודל עם ביצועים טובים שאתם רוצים להשתמש בו בפרויקט או במיקום אחר, אימון של מודל חדש הוא לא האפשרות הכי טובה. אימון המודל הוא לא דטרמיניסטי, ולכן לא סביר שתקבלו מודל זהה מנתונים זהים. בנוסף, אימון מודל בכל אזור או פרויקט לא מבטיח עקביות בהתנהגות של המודל בין האזורים. בעזרת Gemini Enterprise Agent Platform Model Registry, אתם יכולים להעתיק מודל מ-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 של פרויקט היעד כחשבון משתמש חדש לפרויקט המקור, ומקצים לו את התפקיד "סוכן שירות של Vertex AI".
6. אחרי שלוחצים על Save, לפרויקט היעד P4SA יהיו הרשאות לייצא מודלים מפרויקט המקור.

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

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

1. יוצרים חשבון שירות בהתאמה אישית או משתמשים בחשבון קיים. חשבון השירות הזה צריך להיות שייך לפרויקט היעד שאליו המודל מועתק, וצריכה להיות לכם ההרשאה iam.serviceAccounts.actAs בחשבון השירות הזה.
2. בוחרים את פרויקט המקור במסוף Google Cloud .
3. עוברים לדף IAM & Admin.
4. בדף ההרשאות של IAM, לוחצים על Grant access. ייפתח חלון קופץ שבו אפשר להוסיף חשבון משתמש חדש לפרויקט המקור.
5. מוסיפים את חשבון השירות בהתאמה אישית כחשבון משתמש חדש לפרויקט המקור, ומקצים לו את התפקיד "משתמש בפלטפורמת הסוכן" או כל תפקיד בהתאמה אישית עם ההרשאה aiplatform.models.export.
6. אחרי שלוחצים על Save, לחשבון השירות בהתאמה אישית יהיו הרשאות לייצא מודלים מפרויקט המקור.
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. במסוף Google Cloud , נכנסים לדף Gemini Enterprise Agent Platform מרשם המודלים. מעבר אל Gemini Enterprise Agent Platform Model Registry
2. ב-מרשם המודלים, לוחצים על התפריט More actions של המודל שרוצים להעתיק.
   
3. לוחצים על העתקת המודל.
4. בוחרים באפשרות To another project או To another region.

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

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

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

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. במסוף Google Cloud , נכנסים לדף Gemini Enterprise Agent Platform מרשם המודלים. כניסה לדף Model Registry
2. ב-מרשם המודלים, לוחצים על התפריט More actions של המודל שרוצים להעתיק.
   
3. לוחצים על העתקת המודל.
4. בוחרים באפשרות To another project או To another region.

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

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