כשיוצרים נציג, צריך לציין אזור בתור המיקום שלו. הבקשות שנשלחות לנציג מטופלות על ידי שירותי Google באזור הזה, ו-Dialogflow CX שומר את הנתונים במנוחה פיזית באזור או במיקום הגיאוגרפי. כדי לקבל את הביצועים הטובים ביותר, כדאי לבחור אזור שקרוב לשירותים ולמשתמשי הקצה שלכם.
אחרי שיוצרים נציג, אי אפשר לשנות את המיקום שלו. כדי לשנות את המיקום של הנציג, צריך לייצא ולשחזר לנציג חדש עם מיקום אחר.
לכל מיקום יש הגדרות משויכות שחלות על כל הפרויקט. ברוב המקרים אין צורך לערוך את הגדרות המיקום האלה, והגדרות ברירת המחדל יפעלו היטב. אם המערכת שלכם דורשת מפתחות הצפנה בניהול הלקוח (בדרך כלל נדרש על ידי ישויות ממשלתיות או תעשיות בפיקוח), קראו מידע נוסף על הגדרות מיקום.
מגבלות
המגבלות הבאות חלות:
התמיכה באזורים שונים עשויה להשתנות בהתאם לשילובים השונים של הטלפוניה. כדאי לעיין במסמכי התיעוד של כל שילוב.
התמיכה בישויות מערכת משתנה בהתאם לשפה. לפרטים נוספים, ראו מגבלות של ישויות מערכת.
ב-APIs Explorer, שמופיע בהרבה מאמרי עזרה של REST, אפשר להשתמש רק באזור
globalלקריאות ל-API.
אזורים זמינים
ב-Dialogflow CX אפשר להגדיר את מיקום הנציג באזורים הבאים. סוכנים של מאגרי נתונים נתמכים גם באזורים שמפורטים בטבלה הבאה, אבל מזהי האזורים שמשמשים את מאגרי הנתונים שונים קצת מהאזורים של הסוכנים (כפי שמפורט). כל האזורים עם ערך בעמודה Data store region ID נתמכים על ידי סוכני מאגר נתונים ב-Vertex AI Agents.
| קבוצת מדינות | מיקום גיאוגרפי | מזהה אזור של הסוכן | מזהה האזור של מאגר הנתונים |
|---|---|---|---|
| אמריקה | איווה | us-central1 |
us (במספר אזורים) |
| אמריקה | מונטריאול | northamerica-northeast1 |
global (במספר אזורים) |
| אמריקה | דרום קרוליינה | us-east1 |
us (במספר אזורים) |
| אמריקה | אורגון | us-west1 |
us (במספר אזורים) |
| אמריקה | מספר אזורים בארצות הברית | us * |
us (במספר אזורים) |
| אירופה | בלגיה | europe-west1 |
eu (במספר אזורים) |
| אירופה | לונדון | europe-west2 |
eu (במספר אזורים) |
| אירופה | פרנקפורט | europe-west3 |
eu (במספר אזורים) |
| אירופה | הולנד | europe-west4 |
eu (במספר אזורים) |
| אירופה | ציריך | europe-west6 |
eu (במספר אזורים) |
| אסיה ואזור האוקיינוס השקט | סידני | australia-southeast1 |
global (במספר אזורים) |
| אסיה ואזור האוקיינוס השקט | טוקיו | asia-northeast1 |
global (במספר אזורים) |
| אסיה ואזור האוקיינוס השקט | מומבאי | asia-south1 |
global (במספר אזורים) |
| אסיה ואזור האוקיינוס השקט | סינגפור | asia-southeast1 |
global (במספר אזורים) |
| אסיה ואזור האוקיינוס השקט | ג'קארטה | asia-southeast2 |
global (במספר אזורים) |
| עולמי | מספר אזורים גלובליים (שירות גלובלי, נתונים במנוחה בארצות הברית) | global (מועדף) או ללא אזור (ברירת מחדל) ¶ |
global (במספר אזורים) ¶ |
| סמל | תיאור |
|---|---|
| * | במודלים של Gemini 2.x, Vertex AI לא תומך במיקומים us או eu שכוללים מספר אזורים. לכן, השימוש בתכונות מבוססות-AI גנרטיבי של Dialogflow CX במרחבים הרב-אזוריים us או eu מסתמך על נקודות הקצה הקיימות באזור יחיד בארה"ב או באיחוד האירופי, בהתאמה. במודלים של Gemini 3 ואילך (כמו gemini-3.1-flash-lite), המיקומים us ו-eu שכוללים מספר אזורים נתמכים ומשמשים לאזורים בארה"ב ובאירופה. מידע נוסף זמין במאמר מכסות ליצירת תוכן. |
| ¶ | יכול להיות שזמן האחזור של שיחות לאזור global יהיה ארוך יותר כשמתקשרים מחוץ לארה"ב. אם אפשר, עדיף לבחור אזור ספציפי יותר שקרוב יותר לשירותים ולמשתמשי הקצה שלכם. |
במאמרים אזורים ב-Google Cloud ומיקום גיאוגרפי ואזורים ב-Google Cloud תוכלו לקרוא מידע נוסף על האזורים שבהם משתמשים ב-Google Cloud.
הגדרות מיקום
אם המערכת שלכם דורשת מפתחות הצפנה בניהול הלקוח (בדרך כלל נדרש על ידי ישויות ממשלתיות או תעשיות מפוקחות), אתם יכולים להשתמש בהגדרות המיקום כדי להגדיר את התכונה הזו.
הגדרות המיקום משותפות לכל הפרויקט, ולכל מיקום ייחודי יש הגדרות מיקום משלו.
אחרי שקובעים את ההגדרות של מיקום ספציפי בפרויקט, נוצר משאב dialogflow.googleapis.com/LocationSettings שאי אפשר לשנות, ואי אפשר לשנות את ההגדרות של המיקום הזה. אם אתם צריכים לשנות את ההגדרות האלה או למחוק את המשאב, אתם צריכים ליצור פרויקט חדש.
אם אתם צריכים לאפשר למפתחים בארגון להגדיר נציגים רק במיקומים ספציפיים, אתם יכולים להגדיר מדיניות ארגונית שכוללת אילוץ על מיקומי המשאבים.
אם יוצרים נציג בלי לערוך את הגדרות המיקום, הגדרות ברירת המחדל ייקבעו לאותו מיקום, ואי אפשר לשנות אותן בפרויקט. בנוסף, אחרי שיוצרים נציג, אי אפשר לשנות את המיקום שלו. כדי לשנות את המיקום של הנציג, צריך לייצא ולשחזר לנציג חדש עם מיקום אחר.
אלה הגדרות המיקום שזמינות:
- הצפנה: ההגדרה הזו קובעת אם להשתמש במפתחות הצפנה בניהול Google או במפתחות הצפנה בניהול הלקוח כדי להגן על הנתונים. ברירת המחדל היא בניהול Google. כדי לשנות את ההגדרה הזו, צריך לבקש גישה לתכונה מפתחות הצפנה בניהול הלקוח (על ידי פנייה לנציג Google).
יש שתי דרכים לקבוע את הגדרות המיקום:
- לוחצים על הגדרות מיקום בממשק לבחירת נציגים.
- לוחצים על הכפתור Edit לצד התפריט הנפתח Location כשיוצרים נציג.
הגדרת אזור באמצעות ה-API
צריך לציין אזור בכל בקשות ה-API.
בקריאות ל-REST, צריך לבצע את שתי הפעולות הבאות:
צריך לציין את מזהה האזור בפרמטר של הנתיב של כתובת ה-URL
location.באזור
global, משתמשים ב-dialogflow.googleapis.comבתור שם המארח. בכל שאר האזורים, משתמשים ב-[region-id]-dialogflow.googleapis.comבתור שם המארח.
לדוגמה:
dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/global/agents/{AGENT_ID}us-central1-dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/us-central1/agents/{AGENT_ID}
בספריות לקוח, עיינו במסמכי התיעוד של ספריית הלקוח כדי למצוא אפשרות להגדרת אזור.
דוגמאות מופיעות במדריך למתחילים בנושא API.
Cloud Logging
במדריך של Cloud Logging מוסבר איך לשלוט באזור שבו היומנים מאוחסנים.