בדף הזה מוסבר איך לאמן מודל AutoML לזיהוי אובייקטים באמצעות מערך נתונים של תמונות, דרך מסוף Cloud de Confiance או Agent Platform API.
אימון מודל AutoML
מסוף Cloud de Confiance
במסוף Cloud de Confiance , בקטע Agent Platform, נכנסים לדף Datasets.
לוחצים על השם של מערך הנתונים שבו רוצים להשתמש כדי לאמן את המודל, כדי לפתוח את דף הפרטים שלו.
לוחצים על אימון מודל חדש.
בשיטת האימון, בוחרים באפשרות AutoML.
בקטע Choose where to use the model, בוחרים את מיקום המארח של המודל: Cloud, Edge או Agent Platform Vision.
לוחצים על Continue.
נותנים שם למודל.
אם רוצים להגדיר ידנית את אופן הפיצול של נתוני האימון, מרחיבים את Advanced options ובוחרים אפשרות לפיצול הנתונים. מידע נוסף זמין במאמר מידע על פיצולי נתונים במודלים של AutoML.
לוחצים על התחלת האימון.
אימון המודל יכול להימשך שעות רבות, בהתאם לגודל ולמורכבות של הנתונים ולתקציב האימון, אם ציינתם תקציב. אפשר לסגור את הכרטיסייה הזו ולחזור אליה מאוחר יותר. כשהאימון של המודל יסתיים, תקבלו אימייל.
API
בוחרים את הכרטיסייה של השפה או הסביבה שלכם:
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- LOCATION: האזור שבו נמצאת קבוצת הנתונים ונוצר המודל. לדוגמה:
us-central1. - PROJECT: מזהה הפרויקט.
- TRAININGPIPELINE_DISPLAYNAME: שדה חובה. השם המוצג של trainingPipeline.
- DATASET_ID: מספר המזהה של מערך הנתונים שבו משתמשים לאימון.
-
fractionSplit: אופציונלי. אחת מכמה אפשרויות פיצול אפשריות של למידת מכונה לנתונים שלכם. הסכום של הערכים שלfractionSplitצריך להיות 1. לדוגמה:-
{"trainingFraction": "0.7","validationFraction": "0.15","testFraction": "0.15"}
-
- MODEL_DISPLAYNAME*: השם המוצג של המודל שהועלה (נוצר) על ידי TrainingPipeline.
- MODEL_DESCRIPTION*: תיאור המודל.
- modelToUpload.labels*: כל קבוצה של צמדי מפתח/ערך לארגון המודלים. לדוגמה:
- "env": "prod"
- "tier": "backend"
- MODELTYPE†: סוג המודל שמתארח בענן שרוצים לאמן. האפשרויות הן:
-
CLOUD_1– מודל שמותאם לשימוש ב-Google Cloud, ואי אפשר לייצא אותו. בהשוואה למודלים CLOUD_HIGH_ACCURACY_1 ו-CLOUD_LOW_LATENCY_1 שלמעלה, הוא צפוי לספק איכות חיזוי גבוהה יותר וזמן אחזור נמוך יותר. -
CLOUD_HIGH_ACCURACY_1– מודל שמותאם לשימוש ב-Google Cloud, ואי אפשר לייצא אותו. המודל הזה צפוי להיות בעל זמן אחזור גבוה יותר, אבל גם איכות חיזוי גבוהה יותר בהשוואה למודלים אחרים בענן. -
CLOUD_LOW_LATENCY_1– מודל שמתאים במיוחד לשימוש ב-Google Cloud, ואי אפשר לייצא אותו. המודל הזה צפוי להיות עם זמן אחזור קצר, אבל יכול להיות שאיכות החיזוי שלו תהיה נמוכה יותר מזו של מודלים אחרים בענן.
-
- NODE_HOUR_BUDGET†: עלות האימון בפועל תהיה שווה לערך הזה או נמוכה ממנו. במודלים של Cloud, התקציב צריך להיות: 20,000 עד 900,000 אלפיות של שעות שימוש בצומת (כולל). ערך ברירת המחדל הוא 216,000, שמייצג יום אחד בזמן בפועל, בהנחה שמשתמשים ב-9 צמתים.
- PROJECT_NUMBER: מספר הפרויקט שנוצר באופן אוטומטי
| * | התיאור של קובץ הסכימה שציינתם ב-trainingTaskDefinition מתאר את השימוש בשדה הזה. |
| † | קובץ הסכימה שציינתם ב-trainingTaskDefinition מצהיר על השדה הזה ומתאר אותו. |
ה-method של ה-HTTP וכתובת ה-URL:
POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/trainingPipelines
גוף בקשת JSON:
{
"displayName": "TRAININGPIPELINE_DISPLAYNAME",
"inputDataConfig": {
"datasetId": "DATASET_ID",
"fractionSplit": {
"trainingFraction": "DECIMAL",
"validationFraction": "DECIMAL",
"testFraction": "DECIMAL"
}
},
"modelToUpload": {
"displayName": "MODEL_DISPLAYNAME",
"description": "MODEL_DESCRIPTION",
"labels": {
"KEY": "VALUE"
}
},
"trainingTaskDefinition": "gs://google-cloud-aiplatform/schema/trainingjob/definition/automl_image_object_detection_1.0.0.yaml",
"trainingTaskInputs": {
"modelType": ["MODELTYPE"],
"budgetMilliNodeHours": NODE_HOUR_BUDGET
}
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם 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://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/trainingPipelines"
PowerShell
שומרים את גוף הבקשה בקובץ בשם 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://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/trainingPipelines" | Select-Object -Expand Content
התשובה מכילה מידע על המפרטים וגם את TRAININGPIPELINE_ID.
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Java במדריך למתחילים של Agent Platform באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Agent Platform Java API.
כדי לבצע אימות ב-Agent Platform, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Node.js במדריך למתחילים של Agent Platform באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Agent Platform Node.js API.
כדי לבצע אימות ב-Agent Platform, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Python
במאמר התקנת Vertex AI SDK ל-Python מוסבר איך להתקין או לעדכן את Vertex AI SDK ל-Python. מידע נוסף מופיע ב מאמרי העזרה של ה-API מבוסס-Python.
שליטה בחלוקת הנתונים באמצעות REST
אתם יכולים לקבוע איך נתוני האימון יחולקו בין קבוצות האימון, האימות והבדיקה. כשמשתמשים ב-Agent Platform API, משתמשים באובייקט Split כדי לקבוע את פיצול הנתונים. האובייקט Split יכול להיכלל באובייקט InputConfig כאחד מכמה סוגי אובייקטים, שכל אחד מהם מספק דרך אחרת לפצל את נתוני האימון. אפשר לבחור רק שיטה אחת.
-
FractionSplit:- TRAINING_FRACTION: החלק מנתוני האימון שישמש כקבוצת הנתונים לאימון.
- VALIDATION_FRACTION: החלק מנתוני האימון שישמש כקבוצת הנתונים לתיקוף. לא משמש לנתוני וידאו.
- TEST_FRACTION: החלק מנתוני האימון שישמש לקבוצת הבדיקה.
אם מציינים את אחד מהשברים, צריך לציין את כולם. סכום השברים חייב להיות 1.0. ערכי ברירת המחדל של השברים משתנים בהתאם לסוג הנתונים. מידע נוסף
"fractionSplit": { "trainingFraction": TRAINING_FRACTION, "validationFraction": VALIDATION_FRACTION, "testFraction": TEST_FRACTION }, -
FilterSplit: - TRAINING_FILTER: פריטי נתונים שתואמים למסנן הזה משמשים לקבוצת הנתונים לאימון.
- VALIDATION_FILTER: פריטי נתונים שתואמים למסנן הזה משמשים לקבוצת הנתונים לאימות. בנתוני וידאו, הערך חייב להיות "-".
- TEST_FILTER: פריטי נתונים שתואמים למסנן הזה משמשים לקבוצת הבדיקה.
אפשר להשתמש במסננים האלה עם התווית ml_use, או עם כל תווית אחרת שמוסיפים לנתונים. איך משתמשים בתווית ml-use ובתוויות אחרות כדי לסנן את הנתונים.
בדוגמה הבאה אפשר לראות איך משתמשים באובייקט filterSplit עם התווית ml_use, כולל קבוצת הנתונים לתיקוף:
"filterSplit": {
"trainingFilter": "labels.aiplatform.googleapis.com/ml_use=training",
"validationFilter": "labels.aiplatform.googleapis.com/ml_use=validation",
"testFilter": "labels.aiplatform.googleapis.com/ml_use=test"
}