הצגת קבוצות של תכונות

אתם יכולים לאחזר רשימה של כל קבוצות התכונות שנוצרו למיקום ספציפי בפרויקט Cloud de Confiance , יחד עם ה-URI של טבלת המקור או התצוגה של BigQuery שמשויכים לכל קבוצת תכונות.

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

לפני שמתחילים

מאמתים את Gemini Enterprise Agent Platform, אלא אם כבר עשיתם זאת.

צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:

המסוף

כשמשתמשים במסוף Cloud de Confiance כדי לגשת לשירותים Cloud de Confiance by S3NS ולממשקי ה-API, לא צריך להגדיר אימות.

REST

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

    מתקינים את ה-CLI של Google Cloud ואז נכנסים ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.

מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Cloud de Confiance .

רשימה של קבוצות תכונות

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

המסוף

כדי לראות את רשימת קבוצות התכונות למיקום ספציפי באמצעות מסוף Cloud de Confiance , פועלים לפי ההוראות הבאות.

  1. בקטע Agent Platform במסוף Cloud de Confiance , עוברים לדף Feature Store.

    כניסה לדף Feature Store

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

REST

כדי לאחזר רשימה של כל משאבי FeatureGroup במיקום ספציפי בפרויקט, שולחים בקשת GET באמצעות השיטה featureGroups.list.

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

  • ‫LOCATION_ID: האזור שרוצים להציג את רשימת קבוצות התכונות שלו, למשל us-central1.
  • ‫PROJECT_ID: מזהה הפרויקט.

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

GET https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups

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

curl

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups"

PowerShell

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

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו: ‫BIGQUERY_URI_1 היא טבלת המקור או התצוגה המפורטת ב-BigQuery שנרשמו באמצעות FEATURE_GROUP_NAME_1, ו-BIGQUERY_URI_2 היא טבלת המקור או התצוגה המפורטת ב-BigQuery שנרשמו באמצעות FEATURE_GROUP_NAME_2.‫
אם לאחת מקבוצות התכונות שמופיעות בתגובה יש הגדרה ייעודית של חשבון שירות, כתובת האימייל בחשבון השירות תופיע גם בפרטים שלה. בדוגמה הזו, SERVICE_ACCOUNT_EMAIL היא כתובת האימייל בחשבון השירות שמשויך לקבוצת התכונות FEATURE_GROUP_NAME_1. 
{
  "featureGroups": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME_1",
      "createTime": "2023-09-07T00:57:00.142639Z",
      "updateTime": "2023-09-07T00:57:00.142639Z",
      "etag": "AMEw9yOY0byP8qKsDY0DoZyouAtX23zDru2l422C0affZZPYNFOGgIrONELNrM49uH4=",
      "bigQuery": {
        "bigQuerySource": {
          "inputUri": "BIGQUERY_URI_1"
        }
      }
      "serviceAccountEmail": "SERVICE_ACCOUNT_EMAIL"
    },
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME_2",
      "createTime": "2023-09-06T23:14:30.795502Z",
      "updateTime": "2023-09-06T23:14:30.795502Z",
      "etag": "AMEw9yO5UfrPWobGR2Ry-PnbJUQoklW5lX0uW4JmKqj6OgQui6p-rMdUHfuENpQjbJ3t",
      "bigQuery": {
        "bigQuerySource": {
          "inputUri": "BIGQUERY_URI_2"
        }
      }
    }
  ]
}

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