פריסת אינדקס בנקודת קצה כוללת את שלוש המשימות הבאות:
- יוצרים
IndexEndpointחדש לפי הצורך, או משתמשים מחדש ב-IndexEndpointקיים. - מאתרים את המזהה של
IndexEndpoint. - פורסים את האינדקס ב-
IndexEndpoint.
יוצרים IndexEndpoint ברשת ה-VPC
אם אתם פורסים Index ב-IndexEndpoint קיים, אתם יכולים לדלג על השלב הזה.
כדי להשתמש באינדקס להצגת שאילתות אונליין להתאמת וקטורים, צריך לפרוס את Index ב-IndexEndpoint בתוך רשת ה-VPC Peering. השלב הראשון הוא ליצור IndexEndpoint. אפשר לפרוס יותר מאינדקס אחד ב-IndexEndpoint שמשתף את אותה רשת VPC.
gcloud
בדוגמה הבאה משתמשים בפקודה gcloud ai index-endpoints create.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- INDEX_ENDPOINT_NAME: השם המוצג של נקודת הקצה של האינדקס.
- VPC_NETWORK_NAME: השם של רשת Compute Engine שאליה צריך לקשר את נקודת הקצה של האינדקס.
- LOCATION: האזור שבו אתם משתמשים ב-Agent Platform.
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud ai index-endpoints create \ --display-name=INDEX_ENDPOINT_NAME \ --network=VPC_NETWORK_NAME \ --region=LOCATION \ --project=PROJECT_ID
Windows (PowerShell)
gcloud ai index-endpoints create ` --display-name=INDEX_ENDPOINT_NAME ` --network=VPC_NETWORK_NAME ` --region=LOCATION ` --project=PROJECT_ID
Windows (cmd.exe)
gcloud ai index-endpoints create ^ --display-name=INDEX_ENDPOINT_NAME ^ --network=VPC_NETWORK_NAME ^ --region=LOCATION ^ --project=PROJECT_ID
אמורים לקבל תגובה שדומה לזו:
The Google Cloud CLI tool might take a few minutes to create the IndexEndpoint.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- INDEX_ENDPOINT_NAME: השם המוצג של נקודת הקצה של האינדקס.
- VPC_NETWORK_NAME: השם של רשת Compute Engine שאליה צריך לקשר את נקודת הקצה של האינדקס.
- LOCATION: האזור שבו אתם משתמשים ב-Agent Platform.
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- PROJECT_NUMBER: מספר הפרויקט שנוצר באופן אוטומטי.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/indexEndpoints
תוכן בקשת JSON:
{
"display_name": "INDEX_ENDPOINT_NAME",
"network": "VPC_NETWORK_NAME"
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/PROJECT_NUMBER/locations/LOCATION/indexEndpoints/INDEX_ENDPOINT_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateIndexEndpointOperationMetadata",
"genericMetadata": {
"createTime": "2022-01-13T04:09:56.641107Z",
"updateTime": "2022-01-13T04:09:56.641107Z"
}
}
}
אפשר לדגום את סטטוס הפעולה עד שהתגובה תכלול את הערך "done": true.
Terraform
בדוגמה הבאה נעשה שימוש במשאב Terraform vertex_ai_index_endpoint כדי ליצור נקודת קצה של אינדקס.
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.
Python
במאמר התקנת Vertex AI SDK ל-Python מוסבר איך להתקין או לעדכן את Vertex AI SDK ל-Python. מידע נוסף מופיע ב מאמרי העזרה של ה-API מבוסס-Python.
המסוף
כך יוצרים נקודת קצה של אינדקס.
- בקטע Agent Platform במסוף Google Cloud , נכנסים לחלק Deploy and Use. בוחרים באפשרות חיפוש וקטורי.
- תוצג רשימה של האינדקסים הפעילים.
- בחלק העליון של הדף, לוחצים על הכרטיסייה Index endpoints. נקודות הקצה של האינדקס מוצגות.
- לוחצים על Create new index endpoint. החלונית Create a new index endpoint נפתחת.
- מזינים שם לתצוגה של נקודת הקצה של האינדקס.
- בשדה Region, בוחרים אזור מהתפריט הנפתח.
- בשדה Access, בוחרים באפשרות Private.
- מזינים את פרטי רשת ה-VPC המקושרת. מזינים את השם המלא של רשת Compute Engine שאליה רוצים לקשר את המשימה. הפורמט צריך להיות
projects/{project_num}/global/networks/{network_id} - לוחצים על יצירה.
פריסת אינדקס
gcloud
בדוגמה הזו משתמשים בפקודה gcloud ai index-endpoints deploy-index.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- INDEX_ENDPOINT_ID: המזהה של נקודת הקצה של האינדקס.
- DEPLOYED_INDEX_ID: מחרוזת שהמשתמש ציין כדי לזהות באופן ייחודי את האינדקס שנפרס. הוא חייב להתחיל באות ויכול להכיל רק אותיות, מספרים או קווים תחתונים. הנחיות לגבי הפורמט מפורטות במאמר DeployedIndex.id.
- DEPLOYED_INDEX_ENDPOINT_NAME: השם המוצג של נקודת הקצה של האינדקס שנפרס.
- INDEX_ID: מזהה האינדקס.
- LOCATION: האזור שבו אתם משתמשים ב-Agent Platform.
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud ai index-endpoints deploy-index INDEX_ENDPOINT_ID \ --deployed-index-id=DEPLOYED_INDEX_ID \ --display-name=DEPLOYED_INDEX_ENDPOINT_NAME \ --index=INDEX_ID \ --region=LOCATION \ --project=PROJECT_ID
Windows (PowerShell)
gcloud ai index-endpoints deploy-index INDEX_ENDPOINT_ID ` --deployed-index-id=DEPLOYED_INDEX_ID ` --display-name=DEPLOYED_INDEX_ENDPOINT_NAME ` --index=INDEX_ID ` --region=LOCATION ` --project=PROJECT_ID
Windows (cmd.exe)
gcloud ai index-endpoints deploy-index INDEX_ENDPOINT_ID ^ --deployed-index-id=DEPLOYED_INDEX_ID ^ --display-name=DEPLOYED_INDEX_ENDPOINT_NAME ^ --index=INDEX_ID ^ --region=LOCATION ^ --project=PROJECT_ID
אמורים לקבל תגובה שדומה לזו:
The Google Cloud CLI tool might take a few minutes to create the IndexEndpoint.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- INDEX_ENDPOINT_ID: המזהה של נקודת הקצה של האינדקס.
- DEPLOYED_INDEX_ID: מחרוזת שהמשתמש ציין כדי לזהות באופן ייחודי את האינדקס שנפרס. הוא חייב להתחיל באות ויכול להכיל רק אותיות, מספרים או קווים תחתונים. הנחיות לגבי הפורמט מפורטות במאמר DeployedIndex.id.
- DEPLOYED_INDEX_ENDPOINT_NAME: השם המוצג של נקודת הקצה של האינדקס שנפרס.
- INDEX_ID: מזהה האינדקס.
- LOCATION: האזור שבו אתם משתמשים ב-Agent Platform.
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- PROJECT_NUMBER: מספר הפרויקט שנוצר באופן אוטומטי.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/indexEndpoints/INDEX_ENDPOINT_ID:deployIndex
תוכן בקשת JSON:
{
"deployedIndex": {
"id": "DEPLOYED_INDEX_ID",
"index": "projects/PROJECT_ID/locations/LOCATION/indexes/INDEX_ID",
"displayName": "DEPLOYED_INDEX_ENDPOINT_NAME"
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/PROJECT_NUMBER/locations/LOCATION/indexEndpoints/INDEX_ENDPOINT_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeployIndexOperationMetadata",
"genericMetadata": {
"createTime": "2022-10-19T17:53:16.502088Z",
"updateTime": "2022-10-19T17:53:16.502088Z"
},
"deployedIndexId": "DEPLOYED_INDEX_ID"
}
}
Terraform
בדוגמה הבאה נעשה שימוש במשאב Terraform vertex_ai_index_endpoint_deployed_index כדי ליצור נקודת קצה פרוסה של אינדקס.
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.
Python
במאמר התקנת Vertex AI SDK ל-Python מוסבר איך להתקין או לעדכן את Vertex AI SDK ל-Python. מידע נוסף מופיע ב מאמרי העזרה של ה-API מבוסס-Python.
המסוף
כדי לפרוס את האינדקס בנקודת קצה, צריך לפעול לפי ההוראות הבאות.
- בקטע Agent Platform במסוף Google Cloud , נכנסים לחלק Deploy and Use. בוחרים באפשרות חיפוש וקטורי.
- תוצג רשימה של האינדקסים הפעילים.
- בוחרים את שם האינדקס שרוצים לפרוס. דף פרטי האינדקס נפתח.
- בדף פרטי האינדקס, לוחצים על Deploy to endpoint. החלונית לפריסת האינדקס תיפתח.
- מזינים שם לתצוגה – השם הזה משמש כמזהה ואי אפשר לעדכן אותו.
- בתפריט הנפתח Endpoint, בוחרים את נקודת הקצה שאליה רוצים לפרוס את האינדקס. הערה: נקודת הקצה לא זמינה אם האינדקס כבר נפרס בה.
- אופציונלי: בשדה Machine type, בוחרים באפשרות standard או high-memory.
- זה שינוי אופציונלי. בוחרים באפשרות Enable autoscaling כדי לשנות באופן אוטומטי את מספר הצמתים בהתאם לדרישות של עומסי העבודה. מספר ברירת המחדל של הרפליקות הוא 2 אם ההתאמה האוטומטית לעומס מושבתת.
- לוחצים על Deploy כדי לפרוס את האינדקס בנקודת הקצה. הערה: הפריסה נמשכת כ-30 דקות.
הפעלת התאמה אוטומטית לעומס (autoscaling)
בחיפוש וקטורי יש תמיכה בהתאמה אוטומטית לעומס, שמאפשרת לשנות באופן אוטומטי את מספר הצמתים בהתאם לדרישות של עומסי העבודה. כשהביקוש גבוה, צמתים נוספים למאגר הצמתים, עד לגודל המקסימלי שהגדרתם. כשהביקוש נמוך, מאגר הצמתים מצטמצם לגודל המינימלי שהגדרתם. כדי לבדוק את הצמתים שבהם אתם משתמשים בפועל ואת השינויים, אתם יכולים לעקוב אחרי הרפליקות הנוכחיות.
כדי להפעיל התאמה אוטומטית לעומס, מציינים את maxReplicaCount ואת minReplicaCount כשפורסים את האינדקס:
gcloud
בדוגמה הבאה משתמשים בפקודה gcloud ai index-endpoints deploy-index.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- INDEX_ENDPOINT_ID: המזהה של נקודת הקצה של האינדקס.
- DEPLOYED_INDEX_ID: מחרוזת שהמשתמש ציין כדי לזהות באופן ייחודי את האינדקס שנפרס. הוא חייב להתחיל באות ויכול להכיל רק אותיות, מספרים או קווים תחתונים. הנחיות לגבי הפורמט מפורטות במאמר DeployedIndex.id.
- DEPLOYED_INDEX_NAME: השם המוצג של האינדקס שנפרס.
- INDEX_ID: מזהה האינדקס.
- MIN_REPLICA_COUNT: המספר המינימלי של רפליקות של מכונות שהאינדקס שנפרס תמיד ייפרס בהן. אם מציינים ערך, הוא צריך להיות שווה ל-1 או גדול ממנו.
- MAX_REPLICA_COUNT: המספר המקסימלי של רפליקות של מכונות שאפשר לפרוס עליהן את האינדקס שנפרס.
- LOCATION: האזור שבו אתם משתמשים ב-Agent Platform.
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud ai index-endpoints deploy-index INDEX_ENDPOINT_ID \ --deployed-index-id=DEPLOYED_INDEX_ID \ --display-name=DEPLOYED_INDEX_NAME \ --index=INDEX_ID \ --min-replica-count=MIN_REPLICA_COUNT \ --max-replica-count=MAX_REPLICA_COUNT \ --region=LOCATION \ --project=PROJECT_ID
Windows (PowerShell)
gcloud ai index-endpoints deploy-index INDEX_ENDPOINT_ID ` --deployed-index-id=DEPLOYED_INDEX_ID ` --display-name=DEPLOYED_INDEX_NAME ` --index=INDEX_ID ` --min-replica-count=MIN_REPLICA_COUNT ` --max-replica-count=MAX_REPLICA_COUNT ` --region=LOCATION ` --project=PROJECT_ID
Windows (cmd.exe)
gcloud ai index-endpoints deploy-index INDEX_ENDPOINT_ID ^ --deployed-index-id=DEPLOYED_INDEX_ID ^ --display-name=DEPLOYED_INDEX_NAME ^ --index=INDEX_ID ^ --min-replica-count=MIN_REPLICA_COUNT ^ --max-replica-count=MAX_REPLICA_COUNT ^ --region=LOCATION ^ --project=PROJECT_ID
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- INDEX_ENDPOINT_ID: המזהה של נקודת הקצה של האינדקס.
- DEPLOYED_INDEX_ID: מחרוזת שהמשתמש ציין כדי לזהות באופן ייחודי את האינדקס שנפרס. הוא חייב להתחיל באות ויכול להכיל רק אותיות, מספרים או קווים תחתונים. הנחיות לגבי הפורמט מפורטות במאמר DeployedIndex.id.
- DEPLOYED_INDEX_NAME: השם המוצג של האינדקס שנפרס.
- INDEX_ID: מזהה האינדקס.
- MIN_REPLICA_COUNT: המספר המינימלי של רפליקות של מכונות שהאינדקס שנפרס תמיד ייפרס בהן. אם מציינים ערך, הוא צריך להיות שווה ל-1 או גדול ממנו.
- MAX_REPLICA_COUNT: המספר המקסימלי של רפליקות של מכונות שאפשר לפרוס עליהן את האינדקס שנפרס.
- LOCATION: האזור שבו אתם משתמשים ב-Agent Platform.
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- PROJECT_NUMBER: מספר הפרויקט שנוצר באופן אוטומטי.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/indexEndpoints/INDEX_ENDPOINT_ID:deployIndex
תוכן בקשת JSON:
{
"deployedIndex": {
"id": "DEPLOYED_INDEX_ID",
"index": "projects/PROJECT_NUMBER/locations/LOCATION/indexes/INDEX_ID",
"displayName": "DEPLOYED_INDEX_NAME",
"automaticResources": {
"minReplicaCount": MIN_REPLICA_COUNT,
"maxReplicaCount": MAX_REPLICA_COUNT
}
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/PROJECT_NUMBER/locations/LOCATION/indexEndpoints/INDEX_ENDPOINT_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeployIndexOperationMetadata",
"genericMetadata": {
"createTime": "2023-10-19T17:53:16.502088Z",
"updateTime": "2023-10-19T17:53:16.502088Z"
},
"deployedIndexId": "DEPLOYED_INDEX_ID"
}
}
Python
במאמר התקנת Vertex AI SDK ל-Python מוסבר איך להתקין או לעדכן את Vertex AI SDK ל-Python. מידע נוסף מופיע ב מאמרי העזרה של ה-API מבוסס-Python.
המסוף
אפשר להפעיל התאמה אוטומטית לעומס רק מהמסוף במהלך פריסת האינדקס.
- בקטע Agent Platform במסוף Google Cloud , נכנסים לחלק Deploy and Use. בוחרים באפשרות חיפוש וקטורי.
- תוצג רשימה של האינדקסים הפעילים.
- בוחרים את שם האינדקס שרוצים לפרוס. דף פרטי האינדקס נפתח.
- בדף פרטי האינדקס, לוחצים על Deploy to endpoint. החלונית לפריסת האינדקס תיפתח.
- מזינים שם לתצוגה – השם הזה משמש כמזהה ואי אפשר לעדכן אותו.
- בתפריט הנפתח Endpoint, בוחרים את נקודת הקצה שאליה רוצים לפרוס את האינדקס. הערה: נקודת הקצה לא זמינה אם האינדקס כבר נפרס בה.
- אופציונלי: בשדה Machine type, בוחרים באפשרות standard או high-memory.
- זה שינוי אופציונלי. בוחרים באפשרות Enable autoscaling כדי לשנות באופן אוטומטי את מספר הצמתים בהתאם לדרישות של עומסי העבודה. מספר ברירת המחדל של הרפליקות הוא 2 אם ההתאמה האוטומטית לעומס מושבתת.
- אם גם
minReplicaCountוגםmaxReplicaCountלא מוגדרים, הם מוגדרים כ-2 כברירת מחדל. - אם רק
maxReplicaCountמוגדר,minReplicaCountמוגדר כ-2 כברירת מחדל. - אם רק
minReplicaCountמוגדר,maxReplicaCountמוגדר להיות שווה ל-minReplicaCount.
שינוי של DeployedIndex
אתם יכולים להשתמש ב-API של MutateDeployedIndex כדי לעדכן את משאבי הפריסה (לדוגמה, minReplicaCount ו-maxReplicaCount) של אינדקס שכבר נפרס.
- המשתמשים לא יכולים לשנות את
machineTypeאחרי פריסת האינדקס. - אם לא מציינים את
maxReplicaCountבבקשה,DeployedIndexימשיך להשתמש ב-maxReplicaCountהקיים.
gcloud
בדוגמה הבאה השתמשנו בפקודה gcloud ai index-endpoints mutate-deployed-index.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- INDEX_ENDPOINT_ID: המזהה של נקודת הקצה של האינדקס.
- DEPLOYED_INDEX_ID: מחרוזת שהמשתמש ציין כדי לזהות באופן ייחודי את האינדקס שנפרס. הוא חייב להתחיל באות ויכול להכיל רק אותיות, מספרים או קווים תחתונים. הנחיות לגבי הפורמט מפורטות במאמר DeployedIndex.id.
- MIN_REPLICA_COUNT: המספר המינימלי של רפליקות של מכונות שהאינדקס שנפרס תמיד ייפרס בהן. אם מציינים ערך, הוא צריך להיות שווה ל-1 או גדול ממנו.
- MAX_REPLICA_COUNT: המספר המקסימלי של רפליקות של מכונות שאפשר לפרוס עליהן את האינדקס שנפרס.
- LOCATION: האזור שבו אתם משתמשים ב-Agent Platform.
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud ai index-endpoints mutate-deployed-index INDEX_ENDPOINT_ID \ --deployed-index-id=DEPLOYED_INDEX_ID \ --min-replica-count=MIN_REPLICA_COUNT \ --max-replica-count=MAX_REPLICA_COUNT \ --region=LOCATION \ --project=PROJECT_ID
Windows (PowerShell)
gcloud ai index-endpoints mutate-deployed-index INDEX_ENDPOINT_ID ` --deployed-index-id=DEPLOYED_INDEX_ID ` --min-replica-count=MIN_REPLICA_COUNT ` --max-replica-count=MAX_REPLICA_COUNT ` --region=LOCATION ` --project=PROJECT_ID
Windows (cmd.exe)
gcloud ai index-endpoints mutate-deployed-index INDEX_ENDPOINT_ID ^ --deployed-index-id=DEPLOYED_INDEX_ID ^ --min-replica-count=MIN_REPLICA_COUNT ^ --max-replica-count=MAX_REPLICA_COUNT ^ --region=LOCATION ^ --project=PROJECT_ID
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- INDEX_ENDPOINT_ID: המזהה של נקודת הקצה של האינדקס.
- DEPLOYED_INDEX_ID: מחרוזת שהמשתמש ציין כדי לזהות באופן ייחודי את האינדקס שנפרס. הוא חייב להתחיל באות ויכול להכיל רק אותיות, מספרים או קווים תחתונים. הנחיות לגבי הפורמט מפורטות במאמר DeployedIndex.id.
- MIN_REPLICA_COUNT: המספר המינימלי של רפליקות של מכונות שהאינדקס שנפרס תמיד ייפרס בהן. אם מציינים ערך, הוא צריך להיות שווה ל-1 או גדול ממנו.
- MAX_REPLICA_COUNT: המספר המקסימלי של רפליקות של מכונות שאפשר לפרוס עליהן את האינדקס שנפרס.
- LOCATION: האזור שבו אתם משתמשים ב-Agent Platform.
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- PROJECT_NUMBER: מספר הפרויקט שנוצר באופן אוטומטי.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/indexEndpoints/INDEX_ENDPOINT_ID:mutateDeployedIndex
תוכן בקשת JSON:
{
"deployedIndex": {
"id": "DEPLOYED_INDEX_ID",
"index": "projects/PROJECT_ID/locations/LOCATION/indexes/INDEX_ID",
"displayName": "DEPLOYED_INDEX_NAME",
"min_replica_count": "MIN_REPLICA_COUNT",
"max_replica_count": "MAX_REPLICA_COUNT"
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/PROJECT_NUMBER/locations/LOCATION/indexEndpoints/INDEX_ENDPOINT_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeployIndexOperationMetadata",
"genericMetadata": {
"createTime": "2020-10-19T17:53:16.502088Z",
"updateTime": "2020-10-19T17:53:16.502088Z"
},
"deployedIndexId": "DEPLOYED_INDEX_ID"
}
}
Terraform
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform. למידע נוסף, ראו את מאמרי העזרה לספקים של Terraform.
Python
במאמר התקנת Vertex AI SDK ל-Python מוסבר איך להתקין או לעדכן את Vertex AI SDK ל-Python. מידע נוסף מופיע ב מאמרי העזרה של ה-API מבוסס-Python.
הגדרות פריסה שמשפיעות על הביצועים
הגדרות הפריסה הבאות יכולות להשפיע על זמן האחזור, הזמינות והעלות כשמשתמשים בחיפוש וקטורי. ההנחיות האלה רלוונטיות לרוב המקרים. עם זאת, תמיד כדאי להתנסות בהגדרות האישיות כדי לוודא שהן מתאימות לתרחיש לדוגמה שלכם.
| הגדרה | השפעה על הביצועים |
|---|---|
| סוג המכונה |
בחירת החומרה משפיעה באופן ישיר על גודל השארד שנבחר. בהתאם לבחירות שלכם לגבי פיצול הנתונים בזמן יצירת האינדקס, כל סוג מכונה מציע פשרה בין ביצועים לעלות. בדף התמחור מפורטים סוגי החומרה הזמינים והמחירים שלהם. באופן כללי, הביצועים משתפרים לפי הסדר הבא:
|
| מספר מינימלי של רפליקות |
אם יש לכם עומסי עבודה שיורדים לרמות נמוכות ואז עולים במהירות לרמות גבוהות יותר, כדאי להגדיר את |
| מספר הרפליקות המקסימלי |
maxReplicaCount מאפשר בעיקר לשלוט בעלות השימוש. אתם יכולים לבחור למנוע עלייה בעלויות מעבר לסף מסוים, אבל זה עלול להגדיל את זמן האחזור ולהפחית את הזמינות.
|
רשימה IndexEndpoints
כדי להציג את רשימת המשאבים של IndexEndpoint ואת הפרטים של כל המכונות המשויכות של DeployedIndex, מריצים את הקוד הבא:
gcloud
בדוגמה הבאה השתמשנו בפקודה gcloud ai index-endpoints list.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- LOCATION: האזור שבו אתם משתמשים ב-Agent Platform.
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud ai index-endpoints list \ --region=LOCATION \ --project=PROJECT_ID
Windows (PowerShell)
gcloud ai index-endpoints list ` --region=LOCATION ` --project=PROJECT_ID
Windows (cmd.exe)
gcloud ai index-endpoints list ^ --region=LOCATION ^ --project=PROJECT_ID
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- LOCATION: האזור שבו אתם משתמשים ב-Agent Platform.
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- PROJECT_NUMBER: מספר הפרויקט שנוצר באופן אוטומטי.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/indexEndpoints
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"indexEndpoints": [
{
"name": "projects/PROJECT_NUMBER/locations/LOCATION/indexEndpoints/INDEX_ENDPOINT_ID",
"displayName": "INDEX_ENDPOINT_DISPLAY_NAME",
"deployedIndexes": [
{
"id": "DEPLOYED_INDEX_ID",
"index": "projects/PROJECT_NUMBER/locations/LOCATION/indexes/INDEX_ID",
"displayName": "DEPLOYED_INDEX_DISPLAY_NAME",
"createTime": "2021-06-04T02:23:40.178286Z",
"privateEndpoints": {
"matchGrpcAddress": "GRPC_ADDRESS"
},
"indexSyncTime": "2022-01-13T04:22:00.151916Z",
"automaticResources": {
"minReplicaCount": 2,
"maxReplicaCount": 10
}
}
],
"etag": "AMEw9yP367UitPkLo-khZ1OQvqIK8Q0vLAzZVF7QjdZ5O3l7Zow-mzBo2l6xmiuuMljV",
"createTime": "2021-03-17T04:47:28.460373Z",
"updateTime": "2021-06-04T02:23:40.930513Z",
"network": "VPC_NETWORK_NAME"
}
]
}
Python
במאמר התקנת Vertex AI SDK ל-Python מוסבר איך להתקין או לעדכן את Vertex AI SDK ל-Python. מידע נוסף מופיע ב מאמרי העזרה של ה-API מבוסס-Python.
המסוף
כדי לראות רשימה של נקודות הקצה של האינדקס:
- בקטע Agent Platform במסוף Google Cloud , נכנסים לחלק Deploy and Use. בוחרים באפשרות חיפוש וקטורי.
- בחלק העליון של הדף, לוחצים על הכרטיסייה Index endpoint.
- כל נקודות הקצה הקיימות של האינדקס מוצגות.
למידע נוסף, תוכלו לקרוא את מאמרי העזרה של IndexEndpoint.
ביטול הפריסה של אינדקס
כדי לבטל פריסה של אינדקס, מריצים את הקוד הבא:
gcloud
בדוגמה הבאה השתמשנו בפקודה gcloud ai index-endpoints undeploy-index.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- INDEX_ENDPOINT_ID: המזהה של נקודת הקצה של האינדקס.
- DEPLOYED_INDEX_ID: מחרוזת שהמשתמש ציין כדי לזהות באופן ייחודי את האינדקס שנפרס. הוא חייב להתחיל באות ויכול להכיל רק אותיות, מספרים או קווים תחתונים. הנחיות לגבי הפורמט מפורטות במאמר DeployedIndex.id.
- LOCATION: האזור שבו אתם משתמשים ב-Agent Platform.
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud ai index-endpoints undeploy-index INDEX_ENDPOINT_ID \ --deployed-index-id=DEPLOYED_INDEX_ID \ --region=LOCATION \ --project=PROJECT_ID
Windows (PowerShell)
gcloud ai index-endpoints undeploy-index INDEX_ENDPOINT_ID ` --deployed-index-id=DEPLOYED_INDEX_ID ` --region=LOCATION ` --project=PROJECT_ID
Windows (cmd.exe)
gcloud ai index-endpoints undeploy-index INDEX_ENDPOINT_ID ^ --deployed-index-id=DEPLOYED_INDEX_ID ^ --region=LOCATION ^ --project=PROJECT_ID
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- INDEX_ENDPOINT_ID: המזהה של נקודת הקצה של האינדקס.
- DEPLOYED_INDEX_ID: מחרוזת שהמשתמש ציין כדי לזהות באופן ייחודי את האינדקס שנפרס. הוא חייב להתחיל באות ויכול להכיל רק אותיות, מספרים או קווים תחתונים. הנחיות לגבי הפורמט מפורטות במאמר DeployedIndex.id.
- LOCATION: האזור שבו אתם משתמשים ב-Agent Platform.
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- PROJECT_NUMBER: מספר הפרויקט שנוצר באופן אוטומטי.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/indexEndpoints/INDEX_ENDPOINT_ID:undeployIndex
תוכן בקשת JSON:
{
"deployed_index_id": "DEPLOYED_INDEX_ID"
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/PROJECT_NUMBER/locations/LOCATION/indexEndpoints/INDEX_ENDPOINT_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.aiplatform.v1.UndeployIndexOperationMetadata",
"genericMetadata": {
"createTime": "2022-01-13T04:09:56.641107Z",
"updateTime": "2022-01-13T04:09:56.641107Z"
}
}
}
Python
במאמר התקנת Vertex AI SDK ל-Python מוסבר איך להתקין או לעדכן את Vertex AI SDK ל-Python. מידע נוסף מופיע ב מאמרי העזרה של ה-API מבוסס-Python.
המסוף
כדי לבטל פריסה של אינדקס, צריך לפעול לפי ההוראות שכאן.
- בקטע Agent Platform במסוף Google Cloud , נכנסים לחלק Deploy and Use. בוחרים באפשרות חיפוש וקטורי.
- תוצג רשימה של האינדקסים הפעילים.
- בוחרים את האינדקס שרוצים לבטל את הפריסה שלו. דף פרטי האינדקס נפתח.
- בקטע Deployed indexes, מזהים את נקודת הקצה של האינדקס שרוצים לבטל את הפריסה שלה.
- לוחצים על תפריט האפשרויות שנמצא באותה שורה של נקודת הקצה של האינדקס ובוחרים באפשרות Undeploy.
- נפתח מסך אישור. לוחצים על ביטול פריסה. הערה: ביטול הפריסה יכול להימשך עד 30 דקות.
מחיקת IndexEndpoint
לפני שמוחקים IndexEndpoint, צריך undeploy של כל האינדקסים שנפרסו בנקודת הקצה.
gcloud
בדוגמה הבאה משתמשים בפקודה gcloud ai index-endpoints delete.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- INDEX_ENDPOINT_ID: המזהה של נקודת הקצה של האינדקס.
- LOCATION: האזור שבו אתם משתמשים ב-Agent Platform.
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud ai index-endpoints delete INDEX_ENDPOINT_ID \ --region=LOCATION \ --project=PROJECT_ID
Windows (PowerShell)
gcloud ai index-endpoints delete INDEX_ENDPOINT_ID ` --region=LOCATION ` --project=PROJECT_ID
Windows (cmd.exe)
gcloud ai index-endpoints delete INDEX_ENDPOINT_ID ^ --region=LOCATION ^ --project=PROJECT_ID
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- INDEX_ENDPOINT_ID: המזהה של נקודת הקצה של האינדקס.
- LOCATION: האזור שבו אתם משתמשים ב-Agent Platform.
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- PROJECT_NUMBER: מספר הפרויקט שנוצר באופן אוטומטי.
ה-method של ה-HTTP וכתובת ה-URL:
DELETE https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/indexEndpoints/INDEX_ENDPOINT_ID
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/PROJECT_NUMBER/locations/LOCATION/indexEndpoints/INDEX_ENDPOINT_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteOperationMetadata",
"genericMetadata": {
"createTime": "2022-01-13T04:36:19.142203Z",
"updateTime": "2022-01-13T04:36:19.142203Z"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.protobuf.Empty"
}
}
Python
במאמר התקנת Vertex AI SDK ל-Python מוסבר איך להתקין או לעדכן את Vertex AI SDK ל-Python. מידע נוסף מופיע ב מאמרי העזרה של ה-API מבוסס-Python.
המסוף
כדי למחוק נקודת קצה של אינדקס, פועלים לפי ההוראות הבאות.
- בקטע Agent Platform במסוף Google Cloud , נכנסים לחלק Deploy and Use. בוחרים באפשרות חיפוש וקטורי.
- בחלק העליון של הדף, לוחצים על הכרטיסייה Index endpoints.
- כל נקודות הקצה הקיימות של האינדקס מוצגות.
- לוחצים על תפריט האפשרויות שנמצא באותה שורה של נקודת הקצה של האינדקס שרוצים למחוק, ובוחרים באפשרות Delete.
- נפתח מסך אישור. לוחצים על Delete. נקודת הקצה של האינדקס נמחקה.