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

אפשר להגדיר שרת אפליקציות לעיבוד הצעות של Agent Assist באינטרנט ב-Genesys Cloud.

מטרות

שילוב של Genesys Cloud כולל את התהליכים הבאים:

1. פורסים את שרת הקצה העורפי כדי שמודול ממשק המשתמש יוכל להפעיל את Dialogflow API, לרשום אסימון אימות ולהגדיר את Cloud Pub/Sub ואת Memorystore for Redis.
2. פורסים את שרת האפליקציות של Genesys Cloud כדי לעבד את מודול ממשק המשתמש של Agent Assist ב-Cloud Run.
3. יוצרים לקוח OAuth.
4. משלימים את משתני הסביבה.
5. מגדירים את ווידג'ט האינטראקציה ב-Genesys Cloud.
6. מגדירים את השילוב של Agent Assist עם הווידג'ט של האינטראקציה ב-Genesys Cloud.
7. הגדרת Messenger ב-Genesys Cloud.
8. כדי לבדוק את השילוב, משתמשים בכלי הצ'אט וההודעות באינטרנט של Genesys Cloud.

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

לפני שמתחילים בשילוב עם Genesys Cloud, צריך לבצע את הפעולות הבאות:

1. מתקינים את Google Cloud CLI, אם עוד לא הגדרתם אותו.
2. פועלים לפי Google Cloud ההוראות ליצירת חשבון שירות והקצאת התפקיד Dialogflow API Client.
3. פריסת קצה עורפי של מודולים של ממשק משתמש של Agent Assist. כשמבצעים פריסה של שרת הקצה העורפי, צריך לציין את משתנה הסביבה AUTH_OPTION כ-GenesysCloud, בהתאם להוראות הפריסה.

פריסת שרת אפליקציות של Genesys Cloud באמצעות CLI

1. משכפלים את מאגר ה-git למחשב המקומי או לסביבת הפיתוח באמצעות הקוד הבא:

   git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
   

2. בטרמינל המקומי, משתמשים בקוד הבא כדי לשנות את ספריית Active Directory לספריית הבסיס של המאגר שבו נמצא קובץ Docker, לפני שמריצים את ה-build של Google Cloud CLI.

   cd genesyscloud/frontend
   

3. כשמופיעה בקשה להזין שם שירות, מקישים על Enter כדי לאשר את ברירת המחדל.
4. מפעילים את השילוב באמצעות הפקודה הבאה. מחליפים את PROJECT-ID במזהה הפרויקט של הסוכן, את Google Cloud בכתובת האימייל של לקוח חשבון השירות, ומגדירים את UI_MODULE_SERVICE_ACCOUNT ל-Cloud Run.REGION

   gcloud run deploy $AA_MODULE_APPLICATION_SERVER 
   
   --source ./ 
   
   --service-account=$ui_module_service_account 
   
   --memory 1Gi --platform managed 
   
   --region us-central1 
   
   --allow-unauthenticated 
   
   

5. לוחצים על Enter כדי לאשר את שם השירות שמוגדר כברירת מחדל.

פרטים נוספים זמינים במאמרי העזרה בנושא Cloud Run. במסוף Google Cloud , אפשר לראות רשימה של פריסות האינטגרציה הפעילות בקטע Cloud Run.

יצירת לקוח OAuth

1. פועלים לפי ההוראות בתיעוד של Genesys Cloud כדי ליצור לקוח OAuth חדש.
2. מוודאים שסוג ההרשאה הוא Code Authorization / PKCE.
3. מוסיפים את כתובת ה-URL של האפליקציה לקטע Authorized redirect URIs (כתובות URI מורשות להפניה אוטומטית).
4. מעדכנים את משך הזמן של אסימון הלקוח של OAuth 2.0 ל-3,600 שניות. הערך הזה תואם למשך ברירת המחדל של טוקן JWT של שעה אחת לגישה ל-Dialogflow API. אם אתם צריכים משך זמן מותאם אישית, תצטרכו לעדכן את משך הזמן של טוקן ה-OAuth ושל טוקן ה-JWT בהתאם.

   {Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}
   

   מחליפים את {APPLICATION_SERVER_URL} בכתובת ה-URL של שרת אפליקציית ממשק המשתמש.
5. מחליפים את CONVERSATION_PROFILE_NAME בשם פרופיל השיחה, למשל projects/your-project/locations/your-location/conversationProfiles/abc123.
6. מחליפים את {FEATURES} ברשימה מופרדת בפסיקים של התכונות של Agent Assist שרוצים לכלול באפליקציה. חשוב: צריך לכלול רק תכונות שהוגדרו בפרופיל השיחה. ‫Genesys Cloud תומך בתכונות הבאות
7. כדי להוסיף היקפי הרשאות ללקוח OAuth, עוברים לקטע היקפי הרשאות.
8. בוחרים את היקפי ההרשאות הבאים: alerting,‏ authorization,‏ conversations,‏ notifications,‏ messaging וorganization.

כתובת URL לדוגמה:

https://my-project.wm.run.app?conversationProfile=projects/my-project/conversationProfiles/abc123&features=CONVERSATION_SUMMARIZATION,AGENT_COACHING,PROACTIVE_GENERATIVE_KNOWLEDGE_ASSIST

כדי להבטיח חוויית כניסה חלקה, מומלץ להפעיל אימות בחלון קופץ למסגרות iframe מוטמעות.

השלמת משתני הסביבה

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

• ‫OAUTH_CLIENT_ID: מזהה הלקוח של OAuth ב-Genesys Cloud.
• ‫GENESYS_CLOUD_REGION: אזור Genesys Cloud. לדוגמה, usw2.pure.cloud ל-US West(אורגון). ערך ברירת המחדל הוא mypurecloud.com.
• ‫GENESYS_CLOUD_ENVIRONMENT: סביבת Genesys Cloud. ערך ברירת המחדל הוא prod.
• ‫PROXY_SERVER: כתובת ה-URL של מחבר הקצה העורפי של Agent Assist.
• ‫APPLICATION_SERVER_URL: כתובת ה-URL של שרת אפליקציית ממשק המשתמש.
• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
• ‫CONVERSATION_PROFILE: פרופיל השיחה שבו רוצים להשתמש. הערך הזה צריך להיות זהה לפרופיל בכתובת ה-URL להפניה אוטומטית של לקוח OAuth.
• ‫FEATURES: קבוע מופרד בפסיקים עבור תכונות של Agent Assist. הערך הזה צריך להיות זהה לתכונות בכתובת ה-URL להפניה אוטומטית של לקוח OAuth.
• ‫CHANNEL: בוחרים את סוג השילוב. הערך יכול להיות voice או chat.

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

OAUTH_CLIENT_ID={your-oauth-client-id}
GENESYS_CLOUD_REGION={your-pure-cloud-region}
GENESYS_CLOUD_ENVIRONMENT={your-pure-cloud-environment}
PROXY_SERVER={your-proxy-server-endpoint}
PROJECT_ID={your-gcp-project-id}
CONVERSATION_PROFILE={your-conversation-profile}
FEATURES=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION
CHANNEL={use-voice-or-chat}

כשיוצרים לקוח OAuth, ‏ Genesys Cloud מספק גם מזהה לקוח.

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

    gcloud run deploy $AA_MODULE_APPLICATION_SERVER 

    --source ./ 

    --service-account=$ui_module_service_account 

    --memory 1Gi --platform managed 

    --region us-central1 

    --allow-unauthenticated 

    --set-env-vars ^~^OAUTH_CLIENT_ID=$OAUTH_CLIENT_ID~GENESYS_CLOUD_REGION=$GENESYS_CLOUD_REGION~GENESYS_CLOUD_ENVIRONMENT=$GENESYS_CLOUD_ENVIRONMENT~CONVERSATION_PROFILE=$CONVERSATION_PROFILE~FEATURES=$FEATURES~PROJECT_ID=$PROJECT_ID~APPLICATION_SERVER_URL=''~PROXY_SERVER=$PROXY_SERVER~APPLICATION_SERVER_URL=$APPLICATION_SERVER_URL

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

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

1. מוחקים את שירות Cloud Run.
2. בטרמינל המקומי, מריצים את הפקודה הבאה:

   gcloud run services list
   

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

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

כתב ויתור בנושא מחירים

אם אתם משתמשים בשילוב עם Genesys Cloud, יש עלות שמשויכת לשירות הבסיסי Cloud Run.

המאמרים הבאים

• הגדרת שילוב עם Chat
• בדיקת השילוב של הצ'אט