פריסת שרת האפליקציות

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

אפשר להגדיר את הפריסה של השילוב הזה בכל פלטפורמת אירוח, אבל בהוראות האלה נשתמש ב-Cloud Run של Google.

הגדרות אישיות

כשפורסים את השירות, צריך להגדיר את משתני הסביבה הבאים. כשיוצרים את שרת האפליקציות בפעם הראשונה, חשוב להשאיר את המשתנים LP_CLIENT_ID ו-LP_CLIENT_SECRET ריקים. ‫LivePerson תספק את המשתנים האלה כשיוצרים אפליקציה של Conversational Cloud, ותצטרכו לעדכן אותם באותו זמן. בנוסף, תדלגו בהתחלה על APPLICATION_SERVER_URL ועל DF_PROXY_SERVER_URL. כל אחד משני המשתנים האלה יוגדר אחרי ששרתי האפליקציה וה-Proxy יופעלו ויחזירו את ערכי כתובות ה-URL הנדרשים.

• ‫LP_ACCOUNT_ID: מזהה החשבון ב-LivePerson.
• ‫LP_CLIENT_ID: מזהה הלקוח שלכם ב-LivePerson. המידע הזה יסופק על ידי LivePerson אחרי התקנת אפליקציית Conversational Cloud. (אפשר לדלג על המשתנה הזה כרגע, תעדכנו אותו אחרי שתספקו את המידע).
• ‫LP_CLIENT_SECRET: סוד הלקוח שלכם ב-LivePerson. הפרטים האלה יסופקו על ידי LivePerson אחרי התקנת אפליקציית Conversational Cloud. (אפשר לדלג על המשתנה הזה כרגע, ותעדכנו אותו אחרי שתקבלו את המידע).
• ‫LP_SENTINEL_DOMAIN: עוברים אל https://developers.liveperson.com/domain-api.html. מזינים את מספר החשבון ומחפשים את הדומיין sentinel.
• ‫LP_ACCOUNT_CONFIG_READONLY_DOMAIN: עוברים אל https://developers.liveperson.com/domain-api.html. מזינים את מספר החשבון ומחפשים את הדומיין של accountConfigReadOnly.
• ‫APPLICATION_SERVER_URL: כתובת ה-URL של שרת אפליקציית ממשק המשתמש. (אפשר לדלג על השלב הזה ולעדכן את הכתובת אחרי פריסת שרת האפליקציות, כשכתובת ה-URL שלו תהיה ידועה).
• ‫DF_PROXY_SERVER_URL: כתובת ה-URL של שרת ה-Proxy. (אפשר לדלג על השלב הזה ולעדכן את ההגדרה אחרי ששרת ה-proxy יופעל ותדעו מה כתובת ה-URL שלו).
• PROJECT_ID: מזהה הפרויקט ב-Google Cloud. אל תכללו את הקידומת projects/.

קובץ .env לדוגמה:

    LP_ACCOUNT_ID = 12345678
    LP_CLIENT_ID = abc-123-f0f0
    LP_SENTINEL_DOMAIN = va.sentinel.liveperson.net
    LP_ACCOUNT_CONFIG_READONLY_DOMAIN = z1.acr.liveperson.net
    LP_CLIENT_SECRET = abc123abc123abc123abc123
    APPLICATION_SERVER_URL = https://my-project.wm.r.appspot.com
    DF_PROXY_SERVER_URL = https://proxy-server-dot-my-project.wm.r.appspot.com
    PROJECT_ID = my-project

כלים לפריסה

צריך לפרוס את שרת האפליקציות של ממשק המשתמש בשירות אירוח של Google Cloud. מומלץ להשתמש ב-Google App Engine או ב-Cloud Run. השלבים שבהמשך מתייחסים ל-Cloud Run כדוגמה.

הגדרת ה-CLI של gcloud

תהליכי הפריסה שמתוארים במדריך הזה מתבססים על פקודות של ה-CLI של gcloud. כדי להגדיר את ה-CLI של gcloud באופן מקומי לפריסה הזו:

1. בדף התיעוד של ה-CLI של gcloud, בוחרים את מערכת ההפעלה ופועלים לפי הוראות ההתקנה.
2. מריצים את הפקודה gcloud config get-value project כדי לבדוק את הגדרות הפרויקט ב-Google Cloud Platform.
3. נכנסים להגדרות של הנציג ב-Dialogflow ובודקים את מזהה הפרויקט שמשויך לנציג. מזהה הפרויקט ב-Google Cloud Platform שהוגדר ב-gcloud CLI צריך להיות זהה למזהה הפרויקט של הסוכן.
4. אם מזהי הפרויקטים לא זהים, מריצים את הפקודה gcloud config set project PROJECT-ID ומחליפים את PROJECT-ID במזהה הפרויקט משלב 3.

הגדרה של חשבון שירות

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

כדי ליצור חשבון שירות ולהגדיר את השילוב, פועלים לפי השלבים הבאים:

1. בוחרים את הפרויקט ב-Google Cloud Platform שמשויך למשאבים של Agent Assist.
2. לוחצים על תפריט הניווט במסוף Google Cloud Platform, מעבירים את העכבר מעל IAM & admin ולוחצים על Service accounts.
3. לוחצים על + CREATE SERVICE ACCOUNT (יצירת חשבון שירות), ממלאים את הפרטים ומקצים לו את התפקיד Dialogflow Client API.

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

1. עוברים לפרויקט הרצוי ב-Google Cloud Platform.
2. לוחצים על תפריט הניווט במסוף Google Cloud Platform ובוחרים באפשרות Billing. מוודאים שהחיוב מופעל בפרויקט.
3. מפעילים את Cloud Build ואת Cloud Run API בפרויקט הזה.
4. משכפלים את מאגר ה-git הבא למכונה המקומית או לסביבת הפיתוח: git clone [repository url].
5. פותחים את ספריית הבסיס (root) של המאגר במכונה המקומית או בסביבת הפיתוח.

פריסה באמצעות CLI

במסוף המקומי, משנים את הספרייה הפעילה לספריית הבסיס של המאגר.

מריצים את הפקודה הבאה כדי לשמור את מצב המאגר ב-Google Cloud Platform Container Registry. מחליפים את PROJECT-ID במזהה הפרויקט ב-Google Cloud Platform.

    gcloud builds submit --tag gcr.io/PROJECT-ID/agent-assist-modules-application-server

מפעילים את השילוב באמצעות הפקודה הבאה. מחליפים את PROJECT-ID במזהה הפרויקט ב-Google Cloud Platform של הסוכן ואת SERVICE-ACCOUNT-EMAIL בכתובת האימייל של הלקוח של חשבון השירות.

    gcloud run deploy --image gcr.io/PROJECT-ID/agent-assist-modules-application-server --service-account=SERVICE-ACCOUNT-EMAIL --memory 1Gi --platform managed

• כשמופיעה בקשה לבחירת אזור, בוחרים אזור (לדוגמה, us-central1).
• כשמתבקשים להזין שם שירות, מקישים על Enter כדי לאשר את ברירת המחדל.
• כשמופיעה בקשה לאפשר הפעלות לא מאומתות, מקישים על y.

מידע נוסף זמין במאמרי העזרה בנושא Cloud Run. אפשר לראות רשימה של פריסות האינטגרציה הפעילות בקטע Cloud Run ב-Google Cloud Platform Console.

משתני סביבה

פועלים לפי ההוראות של Cloud Run כדי להגדיר את משתני הסביבה הנדרשים.

אחרי פריסת השירות, CLI יציג את כתובת ה-URL שאליה נפרסה האפליקציה (target_url). צריך לחזור ולהגדיר את משתנה הסביבה APPLICATION_SERVER_URL באמצעות הערך הזה.

השבתה של שרת האפליקציות

כדי להשבית את שרת האפליקציות, צריך למחוק את שירות Cloud Run.

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

    gcloud beta run services list

לאחר מכן, מריצים את הפקודה הבאה:

   gcloud beta run services delete agent-assist-modules-application-server