בדף הזה מפורטים השלבים הנדרשים להגדרת Google Cloud פרויקט לשילוב טלפוניה.
בוחרים או יוצרים Google Cloud פרויקט
תעלות SIP מחוברות לפרויקט רק לצורך תקשורת, אבל ההשפעה שלהן לא מוגבלת לפרויקט ספציפי.
לדוגמה, יכול להיות שיש לכם שלושה פרויקטים שונים (פיתוח, בדיקה וייצור). אם משתמשים באותו SIP Trunk לכל התקשורת בין ה-SBC ל-GTP, רק הבקשה הראשונה ליצירת SIP Trunk תצליח, ושאר הבקשות ליצירת SIP Trunk באותו אזור או שם מארח ייכשלו.
מומלץ להשתמש בפרויקט אחר למטרה היחידה של ניהול SIP Trunks. כך צוות אחר יכול להיות אחראי על ה-Trunks, ובממשק המשתמש של Trunk הוא יכול ליצור קבוצות שונות של SBC לפיתוח, לבדיקה ולייצור.
כדי להשתמש בשירותים שמסופקים על ידי Google Cloud, אתם צריכים ליצור פרויקט. בפרויקט מאורגנים כל המשאבים שלכם ב- Google Cloud . כל פרויקט כולל קבוצה של שותפי עריכה, קבוצה של ממשקי API שמופעלים (וכן משאבים אחרים), כלי מעקב, פרטי חיוב ואמצעי בקרה לאימות ולגישה. אתם יכולים ליצור פרויקט אחד, או אם אתם רוצים לארגן את המשאבים שלכם ב- Google Cloud בהיררכיית משאבים, תוכלו ליצור כמה פרויקטים. כשיוצרים פרויקט, חשוב לשים לב למזהה הפרויקט. תצטרכו את המזהה הזה כדי לבצע קריאות ל-API. מידע נוסף על פרויקטים זמין במשאבי העזרה של מנהל המשאבים.
בדף לבחירת הפרויקט במסוף Google Cloud , בוחרים פרויקט ב- Google Cloud או יוצרים אותו.
תפקידים שנדרשים כדי לבחור או ליצור פרויקט
- Select a project: כדי לבחור פרויקט לא צריך תפקיד IAM ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
-
יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד Project Creator (יצירת פרויקטים) (
roles/resourcemanager.projectCreator), שכולל את ההרשאהresourcemanager.projects.create. איך מקצים תפקידים
הרשאות
- במסוף Google Cloud , עוברים אל IAM & Admin -> IAM.
- בוחרים חשבון שירות קיים או יוצרים חשבון שירות חדש, ומוודאים שמוקצה לו התפקיד
Dialogflow API Admin. התפקיד הזה נדרש לשילוב טלפוניה.
גישה ל-API של מספר הטלפון
כדי להשתמש ב-methods של API של מספרי טלפון, נדרשת גישה מיוחדת. למידע נוסף, אפשר לפנות לנציג Google.
הגדרת Dialogflow, פרופיל שיחה ומספר טלפון
בקטע הזה מוסבר איך ליצור פרופיל שיחה של AI בממשק שיחה עם מספר טלפון משויך של Google Telephony Platform (GTP).
- עוברים אל Colab Enterprise. אם מוצגת בקשה, מפעילים את ממשקי ה-API של Compute Engine, Dataform ו-Vertex.
- לוחצים על ייבוא מחברות ואז בוחרים באפשרות כתובת URL כמקור הנתונים. מזינים את כתובת ה-URL של המאגר ב-GitHub ולוחצים על IMPORT.
- בשדה
PROJECT_ID, מזינים את Google Cloud מזהה הפרויקט של הפרויקט שרוצים לשייך לשילוב. הפרויקטים הקיימים מופיעים בתפריט הנפתח בחלק העליון של הדף במסוף Cloud. - מזינים את האזור שבחרתם בשדה
REGION. כל האזורים של Dialogflow נתמכים. - אפשר להשאיר את השדה
JWTכמו שהוא, או להזין כאן את הערך שלJWT. אם לא מציינים כלום, המערכת משתמשת ב-SSO כברירת מחדל. - לוחצים על לחצן ההפעלה בקטע Project (פרויקט) בחלק העליון כדי להריץ את הקטע הזה של הקוד. כשמוצגת בקשה, מאשרים ל-notebook לגשת לפרטי הכניסה שלכם ל-Google.
- מרחיבים את הקטע הגדרת AI בממשק שיחה עבור SIP/SIPREC. בקטע Create a dummy Dialogflow ES agent... (יצירת סוכן פיקטיבי של Dialogflow ES), לוחצים על Show code (הצגת הקוד) ומריצים את הקוד בלי לבצע בו שינויים. ייווצר סוכן פיקטיבי של Dialogflow ES והרמה שלו תוגדר כ-Enterprise. כדי לגשת לנקודות הקצה של Dialogflow API, צריך ליצור סוכן פיקטיבי ב-Dialogflow ES. לכל Google Cloud פרויקט יכול להיות סוכן אחד של Dialogflow ES.
- מרחיבים את הקטע Script to create a (סקריפט ליצירת)
ConversationProfile... כדי להציג את הקוד.CONVERSATION_PROFILE_NAME: יכול להיות כל מחרוזת. אפשר להשתמש בערך ברירת המחדל או להזין ערך משלכם.SECURITY_SETTINGS: יכול להיות כל מחרוזת. אפשר להשתמש בערך ברירת המחדל או להזין ערך משלכם.-
PHONE_NUMBER_COUNTRY_CODE: מזינים את קידומת המדינה שרוצים לשייך למספר הטלפון ב-GTP. -
CX_AGENT_NAME: מזינים את השם של סוכן Dialogflow CX שרוצים לשייך אליו את פרופיל השיחה שנוצר.
- מריצים את הקוד. הפלט יכלול את שם ה-
ConversationProfileשנוצר, הגדרות האבטחה ומספר הטלפון של ה-GTP. - עוברים אל מסוף Dialogflow ES כדי לוודא שנוצר סוכן בשם
Dummy_ES_agent. לוחצים על הגדרות כדי לוודא שהסוכן משויך לפרויקטGoogle Cloud הנכון ושודרג למהדורת Essentials. - עוברים אל מסוף Agent Assist.
בתפריט הימני, לוחצים על פרופילים של שיחות כדי לוודא שנוצר פרופיל שיחה עם
CONVERSATION_PROFILE_NAMEשהזנתם. - עוברים אל מסוף התובנות של AI בממשק שיחה. מוודאים שכל תמלילי השיחות שמשויכים לסוכן Dialogflow CX יובאו.
(אופציונלי) בקשה להגדלת המכסה של משך השיחה ב-Dialogflow CX Phone Gateway
מינויים ל-Dialogflow ES Essentials ול-Dialogflow CX כוללים מכסות סטנדרטיות. אם אתם לא משתמשים ב-Dialogflow בכלל, אלא רק ב-Agent Assist, בתמלול או בהקלטת שיחות, המכסה שלכם כברירת מחדל זהה למכסה של Dialogflow ES Essentials.
במקרה הצורך, אפשר לבקש הגדלה של המכסה על סמך התנועה המשוערת. ברוב תרחישי השימוש, המכסה הרגילה מספיקה להגדרה ולבדיקה, אבל כדי להפעיל אפליקציות צריך להגדיל אותה. פרטים על מכסות והוראות לשליחת בקשה להגדלת מכסה זמינים בדף המכסות של Dialogflow.
(אופציונלי) הפעלת רישום ביומן ביקורת עבור Dialogflow API
אפשר גם להפעיל יומני ביקורת עבור Dialogflow API (dialogflow.googleapis.com) לפעולות Admin Read, Data Read ו-Data Write. כך תוכלו לראות את כל הקריאות ל-AI בממשק שיחה API ואת פרטי הכניסה ששימשו לאימות ולשימוש. המידע הזה יכול להיות שימושי לפתרון בעיות ולניפוי באגים.