במדריך הזה מוסבר איך להגדיר שרת אפליקציות שבו אפשר להציג הצעות של 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 באופן מקומי לפריסה הזו:
- בדף התיעוד של ה-CLI של gcloud, בוחרים את מערכת ההפעלה ופועלים לפי הוראות ההתקנה.
- מריצים את
gcloud config get-value projectכדי לבדוק את הגדרות הפרויקט ב-Google Cloud Platform. - נכנסים להגדרות של הנציג ב-Dialogflow ובודקים את מזהה הפרויקט שמשויך לנציג. הפרויקט ב-Google Cloud Platform שמוגדר ב-CLI של gcloud צריך להתאים למזהה הפרויקט של הנציג.
- אם מזהי הפרויקטים לא תואמים, מריצים את הפקודה
gcloud config set project PROJECT-IDומחליפים אתPROJECT-IDבמזהה הפרויקט משלב 3.
הגדרה של חשבון שירות
כדי שהשילוב יפעל כמו שצריך, אתם צריכים ליצור חשבון שירות בפרויקט שלכם ב-Google Cloud Platform. לפרטים נוספים, קראו את המסמכים של Dialogflow.
כדי ליצור חשבון שירות ולהגדיר את השילוב:
- בוחרים את הפרויקט ב-Google Cloud Platform שמשויך למשאבים של Agent Assist.
- לוחצים על תפריט הניווט במסוף Google Cloud Platform, מעבירים את העכבר מעל IAM & admin ולוחצים על Service accounts.
- לוחצים על + CREATE SERVICE ACCOUNT, ממלאים את הפרטים ומקצים לו את התפקיד Dialogflow Client API.
הפעלת ממשקי ה-API הנדרשים
- עוברים לפרויקט הרצוי ב-Google Cloud Platform.
- לוחצים על תפריט הניווט במסוף Google Cloud Platform ובוחרים באפשרות Billing. מוודאים שהחיוב מופעל בפרויקט.
- מפעילים את Cloud Build ואת Cloud Run API בפרויקט.
- משכפלים את מאגר ה-Git הבא למכונה המקומית או לסביבת הפיתוח:
git clone [repository url]. - פותחים את תיקיית השורש של המאגר במכונה המקומית או בסביבת הפיתוח.
יצירת מאגר Docker ב-Artifact Registry
משתמשים בפקודה gcloud artifacts repositories create כדי ליצור מאגר Docker, שבו תשמרו את מצב המאגר:
gcloud artifacts repositories create REPOSITORY-NAME --repository-format=docker --location=LOCATION
מחליפים את מה שכתוב בשדות הבאים:
-
REPOSITORY-NAME: השם של המאגר ב-Docker. -
LOCATION: Google Cloud המיקום שבו רוצים ליצור את המאגר ב-Docker.
פריסה באמצעות CLI
במסוף המקומי, משנים את הספרייה הפעילה לספריית הבסיס של המאגר.
משתמשים בפקודה gcloud builds submit כדי לשמור את מצב המאגר ב-Google Cloud Artifact Registry:
gcloud builds submit --tag=LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-NAME/agent-assist-modules-application-server
מחליפים את מה שכתוב בשדות הבאים:
-
LOCATION: המיקום ב- Google Cloud שבו יצרתם את המאגר ב-Docker. -
PROJECT-ID: המזהה של Google Cloud הפרויקט שבו יצרתם את המאגר ב-Docker. -
REPOSITORY-NAME: השם של המאגר ב-Docker.
מפעילים את השילוב באמצעות הפקודה gcloud run deploy:
gcloud run deploy --image=LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-NAME/agent-assist-modules-application-server --service-account=SERVICE-ACCOUNT-EMAIL --memory=1Gi
מחליפים את מה שכתוב בשדות הבאים:
-
LOCATION: Google Cloud המיקום שבו יצרתם את המאגר ב-Docker. -
PROJECT-ID: המזהה של Google Cloud הפרויקט שבו יצרתם את המאגר ב-Docker. -
REPOSITORY-NAME: השם של המאגר ב-Docker. -
SERVICE-ACCOUNT-EMAIL: כתובת האימייל של הלקוח בחשבון השירות.
בזמן שהפקודה פועלת, מבצעים את השלבים הבאים:
- כשמתבקשים לבחור אזור, בוחרים אזור (לדוגמה,
us-central1). - כשמוצגת בקשה להזין שם שירות, מקישים על Enter כדי לאשר את ברירת המחדל.
- כשמופיעה בקשה לאפשר הפעלות לא מאומתות, לוחצים על
y.
מידע נוסף זמין במאמרי העזרה של Cloud Run. אפשר לראות רשימה של פריסות האינטגרציה הפעילות בקטע Cloud Run במסוף Google Cloud Platform.
משתני סביבה
פועלים לפי ההוראות של 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