הגדרות אזור והגדרות מיקום

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

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

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

מגבלות

המגבלות הבאות חלות:

  • התמיכה באזורים שונים עשויה להשתנות בהתאם לשילובים השונים של הטלפוניה. כדאי לעיין במסמכי התיעוד של כל שילוב.

  • התמיכה בישויות מערכת משתנה בהתאם לשפה. לפרטים נוספים, ראו המגבלות של ישויות המערכת.

  • ב-APIs Explorer, שמופיע בהרבה מאמרי עזרה של REST, אפשר להשתמש רק באזור global לקריאות ל-API.

אזורים זמינים

ב-Dialogflow CX אפשר לבחור את האזורים הבאים למיקום של הנציג. סוכנים של מאגרי נתונים נתמכים גם באזורים שמפורטים בטבלה הבאה, אבל מזהי האזורים שמשמשים את מאגרי הנתונים שונים קצת מהאזורים של הסוכנים (כפי שמפורט). כל האזורים שמופיע בהם ערך בעמודה מזהה אזור מאגר נתונים נתמכים על ידי סוכני AI של מאגרי נתונים ב-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 (במספר אזורים) ¶

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

הגדרות המיקום

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

הגדרות המיקום משותפות לכל הפרויקט, ולכל מיקום ייחודי יש הגדרות מיקום משלו.

אחרי שקובעים את ההגדרות של מיקום ספציפי בפרויקט, נוצר משאב dialogflow.googleapis.com/LocationSettings שלא ניתן לשינוי, ואי אפשר לשנות את ההגדרות של המיקום הזה. אם אתם צריכים לשנות את ההגדרות האלה או למחוק את המשאב, אתם צריכים ליצור פרויקט חדש.

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

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

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

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

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

הגדרת אזור באמצעות ה-API

צריך לציין אזור בכל בקשות ה-API.

בקריאות ל-REST, צריך לבצע את שתי הפעולות הבאות:

  • צריך לציין את מזהה האזור בפרמטר של הנתיב של כתובת ה-URL location.

  • באזור global, משתמשים ב-dialogflow.googleapis.com בתור שם המארח. בכל שאר האזורים, צריך להשתמש ב-[region-id]-dialogflow.googleapis.com בתור שם המארח. במספר אזורים ב-us, אפשר גם להשתמש בנקודת קצה עם מספר אזורים בארה"ב.

לדוגמה:

  • 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.

שימוש בנקודת הקצה עם מספר אזורים בארה"ב

אם הסוכנים נמצאים במספר אזורים ב-us, אתם יכולים לשלוח בקשות API לנקודת הקצה במספר אזורים בארה"ב, dialogflow.us.rep.googleapis.com. נקודת קצה בכמה אזורים מסיימת את פרוטוקול TLS ומעבדת את הבקשות בתוך האזור, כך שנתוני הבקשה נשארים בארה"ב בזמן ההעברה. שימוש בנקודת הקצה הזו לא משנה את המיקום שבו נתוני הנציג מאוחסנים. למידע נוסף, קראו את הסקירה הכללית על נקודות קצה אזוריות ורב-אזוריות ל-API במדריך האבטחה של Google Cloud .

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

  1. מזינים dialogflow.us.rep.googleapis.com בשדה של שם המארח.

  2. מגדירים את הפרמטר של נתיב כתובת ה-URL‏ location לערך us.

לדוגמה:

  • dialogflow.us.rep.googleapis.com/v3/projects/{PROJECT_ID}/locations/us/agents/{AGENT_ID}

השתמשו בנקודת הקצה עם מספר אזורים בארה"ב רק למשאבים במיקום us. למשאבים במיקומים אחרים, כולל us-central1,‏ us-east1 ו-us-west1, צריך להשתמש בשם המארח של אותו מיקום.

כדי להשתמש בנקודת הקצה עם מספר אזורים בארה"ב באמצעות ספריות הלקוח, צריך להגדיר את האפשרות של נקודת הקצה ל-API של הלקוח ל-dialogflow.us.rep.googleapis.com. לדוגמה, ב-Python, מעבירים את client_options={"api_endpoint": "dialogflow.us.rep.googleapis.com"} כשיוצרים את הלקוח. אם אתם משתמשים ב-Terraform, הגדירו את השדה dialogflow_cx_custom_endpoint של ספק Google לערך https://dialogflow.us.rep.googleapis.com/v3/. ההגדרה הזו שולחת את כל הבקשות של הספק ל-Dialogflow CX לנקודת הקצה עם מספר האזורים בארה"ב, לכן צריך להשתמש בה רק למשאבים במיקום us.

לרשימה של נקודות קצה אזוריות ונקודות קצה במספר אזורים, קראו את המאמר נקודות קצה אזוריות ונקודות קצה במספר אזורים במדריך בנושא ענן וירטואלי פרטי (VPC).

רישום ביומן בענן

במדריך של Cloud Logging מוסבר איך לשלוט באזור שבו היומנים מאוחסנים.