ניהול גרסאות של מערכי נתונים של תמונות (API בלבד)

‫Gemini Enterprise Agent Platform מאפשרת לכם ליצור גרסאות של מערך נתונים. היכולת הזו יכולה להיות שימושית לשחזור, למעקב ולניהול של שושלת הנתונים של מערך הנתונים.

אפשר ליצור גרסאות של מערכי נתונים של תמונות. כשיוצרים גרסה של מערך נתונים, Agent Platform יוצר מערך נתונים של BigQuery אם לא קיים כזה. מערך הנתונים ב-BigQuery מאחסן את כל הגרסאות של מערך הנתונים המשויך של Gemini Enterprise Agent Platform.

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

יצירת גרסה של מערך נתונים

אתם יכולים להשתמש ב-Agent Platform API כדי ליצור גרסה של מערך נתונים. פועלים לפי השלבים בכרטיסייה המתאימה:

REST

קבלת המזהה של מערך הנתונים

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

קבלת מזהה של Dataset לפי השם לתצוגה

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

  • ‫LOCATION: המיקום שבו מאוחסן Dataset. לדוגמה, us-central1.

  • ‫PROJECT_ID: מזהה הפרויקט. .

  • ‫DATASET_DISPLAY_NAME: השם המוצג של Dataset.

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

GET https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?filter=displayName=DATASET_DISPLAY_NAME

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

curl

מריצים את הפקודה הבאה: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?filter=displayName=DATASET_DISPLAY_NAME"

PowerShell

מריצים את הפקודה הבאה: 

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?filter=displayName=DATASET_DISPLAY_NAME" | Select-Object -Expand Content

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

{
  "datasets": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION/datasets/DATASET_ID",
      "displayName": "DATASET_DISPLAY_NAME",
      ...
    }
  ]
}

אפשר גם לקבל את המזהה של מערך הנתונים מ Google Cloud המסוף: עוברים לדף Datasets (מערכי נתונים) בפלטפורמת הסוכנים ומוצאים את המספר בעמודה ID (מזהה).

כניסה לדף Datasets

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

  • ‫LOCATION: האזור שבו מאוחסנת גרסת מערך הנתונים. לדוגמה, us-central.

  • ‫PROJECT_ID: מזהה הפרויקט. .

  • ‫DATASET_ID: המזהה המספרי של מערך הנתונים.

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

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/datasetVersions

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

curl

מריצים את הפקודה הבאה: 

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

PowerShell

מריצים את הפקודה הבאה: 

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/datasetVersions" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateDatasetVersionOperationMetadata",
    "genericMetadata": {
      "createTime": "2021-02-17T00:54:58.827429Z",
      "updateTime": "2021-02-17T00:54:58.827429Z"
    },
  }
}

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

שחזור גרסה של קבוצת נתונים

אפשר להשתמש ב-Agent Platform API כדי לשחזר גרסה של מערך נתונים. פועלים לפי השלבים בכרטיסייה המתאימה:

REST

איך מוצאים את המזהה של גרסת מערך הנתונים

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

פרסום של Dataset DatasetVersion

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

  • ‫LOCATION: האזור שבו מאוחסנת גרסת מערך הנתונים. לדוגמה, us-central.

  • ‫PROJECT_ID: מזהה הפרויקט. .

  • ‫DATASET_ID: המזהה המספרי של מערך הנתונים.

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

GET https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/datasetVersions

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

curl

מריצים את הפקודה הבאה: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/datasetVersions"

PowerShell

מריצים את הפקודה הבאה: 

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/datasetVersions" | Select-Object -Expand Content

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

{
  "datasetVersions": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION/datasets/DATASET_ID/datasetVersions/DATASET_VERSION_ID",
      ...
    }
  ]
}

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

  • ‫LOCATION: האזור שבו מאוחסנת גרסת מערך הנתונים. לדוגמה, us-central.

  • ‫PROJECT_ID: מזהה הפרויקט. .

  • ‫DATASET_ID: המזהה המספרי של מערך הנתונים.

  • ‫DATASET_VERSION_ID: המזהה המספרי של גרסת מערך הנתונים.

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

GET https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/datasetVersions/DATASET_VERSION_ID:restore

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

curl

מריצים את הפקודה הבאה: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/datasetVersions/DATASET_VERSION_ID:restore"

PowerShell

מריצים את הפקודה הבאה: 

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/datasetVersions/DATASET_VERSION_ID:restore" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.RestoreDatasetVersionOperationMetadata",
    "genericMetadata": {
      "createTime": "2021-02-17T00:54:58.827429Z",
      "updateTime": "2021-02-17T00:54:58.827429Z"
    },
  }
}

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

המאמרים הבאים

מידע נוסף על עבודה עם מערכי נתונים ב-Agent Platform