‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

יצירת מופע של חנות וירטואלית

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

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

אחרי שיוצרים את החנות אונליין, אפשר להוסיף תצוגות של מאפיינים ולשייך אותן למקורות נתונים של מאפיינים ב-BigQuery.

אתם יכולים להצפין את המכונה של חנות האונליין שלכם על ידי ציון מפתח הצפנה בניהול הלקוח (CMEK) כשאתם יוצרים את המכונה של חנות האונליין. רק Bigtable online serving תומך בהצפנה באמצעות CMEK. כדי להבין יותר על היתרונות של שימוש ב-CMEK ולהבין אם CMEK שימושי לחנות האונליין שלכם, כדאי לעיין ביתרונות של CMEK.

שימוש במפתחות CMEK עשוי לכלול עלויות שימוש נוספות, בהתאם לסוג המפתח שבו נעשה שימוש. מידע נוסף על תמחור זמין במאמר בנושא תמחור של Cloud Key Management Service.

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

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

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

המסוף

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

Python

כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של Python שבדף הזה, מתקינים ומפעילים את ה-CLI של gcloud, ואז מגדירים את Application Default Credentials באמצעות פרטי הכניסה של המשתמש.

התקינו את ה-CLI של Google Cloud.
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
אם אתם משתמשים במעטפת מקומית, צריך ליצור פרטי כניסה לאימות מקומי עבור חשבון המשתמש:
```
gcloud auth application-default login
```
אם אתם משתמשים ב-Cloud Shell, אתם לא צריכים לעשות את זה.

אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.

REST

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

התקינו את ה-CLI של Google Cloud.

אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

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

יצירת חנות וירטואלית להצגת נתונים אונליין ב-Bigtable

כשמשתמשים ב-Bigtable להצגת נתונים אונליין, אפשר להצפין את החנות הווירטואלית באמצעות CMEK.

יצירת חנות וירטואלית להצגת נתונים אונליין ב-Bigtable ללא CMEK

כדי ליצור מופע של חנות אונליין להצגת נתונים אונליין ב-Bigtable עם שינוי גודל אוטומטי, בלי לציין CMEK, משתמשים במסוף Google Cloud או ב-API בארכיטקטורת REST.

המסוף

כך יוצרים חנות אונליין להצגת נתונים אונליין ב-Bigtable באמצעות מסוף Google Cloud .

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

כניסה לדף Feature Store
לוחצים על חנות אונליין כדי לעבור לקטע חנות אונליין.
לוחצים על יצירה כדי לפתוח את הדף יצירת חנות וירטואלית.
מציינים שם לחנות אונליין.
אופציונלי: כדי להוסיף תוויות, לוחצים על הוספת תווית ומציינים את שם התווית והערך שלה. אפשר להוסיף כמה תוויות לחנות אונליין.
בשדה Choose a storage solution for your online store (בחירת פתרון אחסון לחנות אונליין), לוחצים על Bigtable.
משנים את הערכים של מספר הצמתים המינימלי, מספר הצמתים המקסימלי ויעד השימוש במעבד לפי הצורך.
לוחצים על יצירה.

Python

במאמר התקנת Vertex AI SDK ל-Python מוסבר איך להתקין או לעדכן את Vertex AI SDK ל-Python. מידע נוסף מופיע ב מאמרי העזרה של Python API.


from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_bigtable_feature_online_store_sample(
    project: str,
    location: str,
    feature_online_store_id: str,
):
    aiplatform.init(project=project, location=location)
    fos = feature_store.FeatureOnlineStore.create_bigtable_store(
        feature_online_store_id
    )
    return fos

‫project: מזהה הפרויקט.
‫location: האזור שבו נמצאת חנות האונליין, למשל us-central1.
‫feature_online_store_id: השם של מופע FeatureOnlineStore חדש.

REST

כדי ליצור משאב FeatureOnlineStore, שולחים בקשת POST באמצעות ה-method‏ featureOnlineStores.create.

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

‫LOCATION_ID: האזור שבו רוצים ליצור את חנות האונליין, למשל us-central1.
‫PROJECT_ID: מזהה הפרויקט.
‫FEATUREONLINESTORE_NAME: השם של המופע החדש של החנות אונליין.
‫BOOLEAN: אופציונלי: כדי ליצור חנות אונליין שתומכת בניהול הטמעה, מזינים true. ערך ברירת המחדל הוא false.

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

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

גוף בקשת JSON:

{
  "bigtable": {
    "auto_scaling": {
      "min_node_count": 1,
      "max_node_count": 3,
      "cpu_utilization_target": 50
    }
  }
}

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

curl

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-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://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

PowerShell

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-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://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

יצירת חנות אונליין שמשתמשת במפתח CMEK

כדי ליצור מופע של חנות וירטואלית להצגת נתונים אונליין ב-Bigtable שמוצפנים באמצעות CMEK, פועלים לפי השלבים הבאים.

שימוש בהצפנת CMEK עשוי לכלול עלויות שימוש נוספות, בהתאם לסוג המפתח שבו נעשה שימוש. מידע נוסף על תמחור זמין במאמר בנושא תמחור של Cloud Key Management Service.

שימוש ב-Cloud Key Management Service כדי להגדיר מפתח הצפנה בניהול הלקוח
כדי ליצור משאב FeatureOnlineStore, שולחים את בקשת POST הבאה באמצעות השיטה featureOnlineStores.create ומציינים את ה-CMEK.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- ‫LOCATION_ID: האזור שבו רוצים ליצור את חנות האונליין, למשל us-central1.
- ‫PROJECT_ID: מזהה הפרויקט.
- ‫FEATUREONLINESTORE_NAME: השם של המופע החדש של החנות אונליין.
- ‫BOOLEAN: אופציונלי: כדי ליצור חנות אונליין שתומכת בניהול הטמעה, מזינים true. ערך ברירת המחדל הוא false.
- ‫KEY_NAME: השם של מפתח ההצפנה שרוצים להשתמש בו עבור מאגר המטא-נתונים הזה.
ה-method של ה-HTTP וכתובת ה-URL:
```
POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME
```
גוף בקשת JSON:
```
{
  "bigtable": {
    "auto_scaling": {
      "min_node_count": 1,
      "max_node_count": 3,
      "cpu_utilization_target": 50
    }
  },
  "encryption_spec": {
    "kms_key_name": "KEY_NAME"
  }
}
```
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-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://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"
PowerShell

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-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://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
```
{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}
```

יצירת חנות וירטואלית להצגה אופטימלית של מודעות אונליין

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

יצירת חנות וירטואלית להצגה אונליין אופטימלית עם נקודת קצה ציבורית

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

המסוף

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

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

כניסה לדף Feature Store
לוחצים על חנות אונליין כדי לעבור לקטע חנות אונליין.
לוחצים על יצירה כדי לפתוח את הדף יצירת חנות וירטואלית.
מציינים שם לחנות אונליין.
אופציונלי: כדי להוסיף תוויות, לוחצים על הוספת תווית ומציינים את שם התווית והערך שלה. אפשר להוסיף כמה תוויות לחנות אונליין.
בשדה Choose a storage solution for your online store (בחירת פתרון אחסון לחנות אונליין), לוחצים על Optimized (אופטימלי).
לוחצים על יצירה.

Python

במאמר התקנת Vertex AI SDK ל-Python מוסבר איך להתקין או לעדכן את Vertex AI SDK ל-Python. מידע נוסף מופיע ב מאמרי העזרה של Python API.


from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_optimized_public_feature_online_store_sample(
    project: str,
    location: str,
    feature_online_store_id: str,
):
    aiplatform.init(project=project, location=location)
    fos = feature_store.FeatureOnlineStore.create_optimized_store(
        feature_online_store_id
    )
    return fos

‫project: מזהה הפרויקט.
‫location: האזור שבו רוצים ליצור את מופע FeatureOnlineStore, לדוגמה us-central1.
‫feature_online_store_id: השם של מופע FeatureOnlineStore חדש.

REST

כדי ליצור מופע של חנות אונליין, שולחים בקשת POST באמצעות השיטה featureOnlineStores.create.

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

‫LOCATION_ID: האזור שבו רוצים ליצור את מופע FeatureOnlineStore, לדוגמה us-central1.
‫PROJECT_ID: מזהה הפרויקט.
‫FEATUREONLINESTORE_NAME: השם של מופע FeatureOnlineStore חדש.

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

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

גוף בקשת JSON:

{
  "optimized": {}
}

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

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_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

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_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

יצירת חנות וירטואלית להצגה אונליין אופטימלית עם נקודת קצה מסוג Private Service Connect

בדוגמאות הבאות מוסבר איך ליצור חנות אונליין למילוי בקשה באופן מיידי אופטימלי באמצעות Private Service Connect.

Python

במאמר התקנת Vertex AI SDK ל-Python מוסבר איך להתקין או לעדכן את Vertex AI SDK ל-Python. מידע נוסף מופיע ב מאמרי העזרה של Python API.


from typing import List

from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_optimized_private_feature_online_store_sample(
    project: str,
    location: str,
    feature_online_store_id: str,
    project_allowlist: List[str],
):
    aiplatform.init(project=project, location=location)
    fos = feature_store.FeatureOnlineStore.create_optimized_store(
        name=feature_online_store_id,
        enable_private_service_connect=True,
        project_allowlist=project_allowlist,
    )
    return fos

‫project: מזהה הפרויקט.
‫location: האזור שבו רוצים ליצור את מופע FeatureOnlineStore, לדוגמה us-central1.
‫feature_online_store_id: השם של מופע FeatureOnlineStore חדש.
‫project_allowlist: רשימת שמות הפרויקטים שרוצים להוסיף לרשימת ההיתרים ל-Private Service Connect ‏ (PSC).

REST

כדי ליצור מופע של חנות אונליין, שולחים בקשת POST באמצעות השיטה featureOnlineStores.create.

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

‫LOCATION_ID: האזור שבו רוצים ליצור את מופע FeatureOnlineStore, לדוגמה us-central1.
‫PROJECT_ID: מזהה הפרויקט.
‫FEATUREONLINESTORE_NAME: השם של מופע FeatureOnlineStore חדש.
‫PROJECT_NAMES: רשימת שמות הפרויקטים שרוצים להוסיף לרשימת ההיתרים ל-Private Service Connect ‏ (PSC).

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

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

גוף בקשת JSON:

{
  "optimized": {},
  "dedicated_serving_endpoint": {
    "private_service_connect_config": {
      "enable_private_service_connect": true,
      "project_allowlist": ["PROJECT_NAMES"]
    }
  }
}

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

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_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

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_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

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

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

המסוף

Python

REST

יצירת חנות וירטואלית להצגת נתונים אונליין ב-Bigtable

יצירת חנות וירטואלית להצגת נתונים אונליין ב-Bigtable ללא CMEK

המסוף

Python

REST

curl

PowerShell

יצירת חנות אונליין שמשתמשת במפתח CMEK

curl

PowerShell

יצירת חנות וירטואלית להצגה אופטימלית של מודעות אונליין

יצירת חנות וירטואלית להצגה אונליין אופטימלית עם נקודת קצה ציבורית

המסוף

Python

REST

curl

PowerShell

יצירת חנות וירטואלית להצגה אונליין אופטימלית עם נקודת קצה מסוג Private Service Connect

Python

REST

curl

PowerShell

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

יצירת מופע של חנות וירטואלית