הגדרה וניקוי של Dialogflow ES

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

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

לפני שתקראו את המדריך הזה:

1. היסודות של Dialogflow ES
2. מהדורות

מידע על מסוף Google Cloud

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

יצירת פרויקט

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

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

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

בדף לבחירת הפרויקט במסוף Google Cloud , בוחרים פרויקט ב- Google Cloud או יוצרים אותו.

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

• בחירת פרויקט: כדי לבחור פרויקט לא נדרש תפקיד IAM ספציפי – אתם יכולים לבחור כל פרויקט שקיבלתם בו תפקיד.
• יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד "יצירת פרויקטים" (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים?

כניסה לדף לבחירת הפרויקט

אזהרה: אם פרויקט נמחק, אי אפשר לשחזר את הנציגים שמקושרים לפרויקט.

הפעלת החיוב

הערה: אם אתם משתמשים במהדורת Dialogflow שזמינה בחינם, אתם יכולים לדלג על השלב הזה.

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

מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud .

הפעלת ה-API

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

צריך להפעיל את Dialogflow API בפרויקט. רוצים לדעת איך מפעילים או משביתים שירותים?

מפעילים את Dialogflow API, אם הוא עדיין לא מופעל.

התפקידים שנדרשים כדי להפעיל ממשקי API

כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

להפעלת ה-API

הפעלה של יומני ביקורת

הערה: אפשר לדלג על השלב הזה אם לא מדובר בנציגים בסביבת ייצור.

מפעילים את יומני הביקורת של Data Access ל-Dialogflow API בפרויקט. כך תוכלו לעקוב אחרי שינויים בזמן התכנון בסוכני Dialogflow שמקושרים לפרויקט הזה.

התקנה והפעלה של Google Cloud CLI

הערה: אפשר לדלג על השלב הזה אם לא משתמשים ב-API.

אם אתם מתכוונים להשתמש ב-Dialogflow API, אתם צריכים להתקין ולהפעיל את Google Cloud CLI. ה-CLI של gcloud הוא קבוצת כלים שבעזרתם אפשר לנהל את המשאבים והאפליקציות שמתארחים ב- Google Cloud.

אתם יכולים להיעזר בהוראות שבקישורים האלה:

התקינו את ה-CLI של Google Cloud. אחר כך, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:

gcloud init

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

הגדרת אימות ובקרת גישה

הערה: אפשר לדלג על השלב הזה אם לא משתמשים ב-API.

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

אימות באמצעות חשבונות משתמשים

חשבונות משתמשים הם אפשרות האימות הכי טובה כשאתם לומדים את Dialogflow API ולפיתוח מקומי. אתם יכולים להשתמש בחשבון המשתמש שלכם כדי לאמת הפעלות של שורת פקודה ב-REST או קריאות לספריית לקוח.

אימות של חשבון משתמש בשורת הפקודה של REST

הערה: אם אתם משתמשים ב-Cloud Shell, אתם מחוברים אוטומטית ל-gcloud, כך שאין צורך להריץ את gcloud auth login.

כדי לאמת קריאות של שורת פקודה ל-REST, משתמשים ב-CLI של gcloud. הפקודה gcloud auth login מחברת אתכם ל-gcloud באמצעות חשבון המשתמש שלכם, וצריך להריץ אותה לפני שקוראים ל-API. הפקודה gcloud auth print-access-token משמשת לאימות קריאות ל-REST בכל הדוגמאות של שורת הפקודה ל-REST במסמכי התיעוד האלה.

כדי ליצור פרטי כניסה של משתמשים לסביבה המקומית:

gcloud auth login

אימות של חשבון משתמש בספריית לקוח

כדי לבצע אימות לקריאות של ספריית הלקוח, משתמשים ב-CLI של gcloud. הפקודה gcloud auth application-default login מחברת אתכם ל-gcloud בשביל Application Default Credentials באמצעות חשבון המשתמש שלכם. צריך לעשות את זה לפני ששולחים קריאה ל-API. כדי להגדיר את הפרויקט לחיוב ולמכסות שקשורות לקריאות ל-API, צריך להשתמש בפקודה gcloud auth application-default set-quota-project. בדרך כלל, זהו אותו פרויקט שבו משתמש הנציג, ואתם מספקים את מזהה הפרויקט שיצרתם בשלבים שלמעלה.

כדי שספריות הלקוח ישתמשו ב-Application Default Credentials, אסור להגדיר את משתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS.

כדי ליצור Application Default Credentials בסביבה המקומית:

gcloud auth application-default login
gcloud auth application-default set-quota-project PROJECT_ID

אימות באמצעות חשבונות שירות

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

• סקירה כללית על חשבונות שירות
• המלצות לחשבונות שירות
• יצירה וניהול של חשבונות שירות

בקרת גישה באמצעות תפקידים

כשחשבון משתמש (חשבון משתמש, חשבון שירות וכו') קורא ל-API, צריך לתת לחשבון הזה את ההרשאות המתאימות שנדרשות על ידי Google Cloud . כדי לתת הרשאות, צריך להקצות תפקידים לחשבון משתמש. מידע נוסף זמין בסקירה הכללית של התפקידים.

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

התקנה של ספריית הלקוח של Dialogflow

הערה: אפשר לדלג על השלב הזה אם לא משתמשים ב-API.

יש שלוש אפשרויות לשלוח קריאה ל-API: ספריות לקוח שנתמכות על ידי Google,‏ REST ו-gRPC.

יש ספריות לקוח לכמה שפות פופולריות. במאמר ספריות לקוח תוכלו לקרוא הוראות להתקנה בשפה הרצויה.

הסרת המשאבים

אחרי שמגדירים את Dialogflow CX ומתנסים בו, יכול להיות שתרצו למחוק את המשאבים שיצרתם:

• אתם יכולים למחוק את הסוכן.
• יכול להיות שתרצו להשבית את הפרויקט.
• אם הפעלתם את gcloud auth login, פרטי הכניסה מאוחסנים בספריית המשתמש במחשב. כדי למחוק את פרטי הכניסה האלה, אפשר להפעיל את הפונקציה:

  gcloud auth revoke

• אם הפעלתם את gcloud auth application-default login, פרטי הכניסה מאוחסנים בספריית המשתמש במחשב. כדי למחוק את פרטי הכניסה האלה, אפשר להפעיל את הפונקציה:

  gcloud auth application-default revoke