您可以在 Genesys Cloud 中設定應用程式伺服器,在網頁上顯示 Agent Assist 建議。
目標
整合 Genesys Cloud 需經過下列程序:
- 部署 UI 模組的後端伺服器,呼叫 Dialogflow API、註冊驗證權杖,並設定 Cloud Pub/Sub 和 Memorystore for Redis。
- 在 Cloud Run 中部署 Genesys Cloud 應用程式伺服器,以便算繪 Agent Assist UI 模組。
- 建立 OAuth 用戶端。
- 完成環境變數。
- 在 Genesys Cloud 中設定互動小工具。
- 在 Genesys Cloud 中,透過互動小工具設定 Agent Assist 整合服務。
- 在 Genesys Cloud 中設定 Messenger。
- 使用 Genesys Cloud 網頁即時通訊和訊息工具測試整合。
事前準備
開始整合 Genesys Cloud 前,請先完成下列動作:
- 如果尚未設定,請安裝 Google Cloud CLI。
- 按照 Google Cloud 操作說明建立服務帳戶,並指派 Dialogflow API 用戶端角色。
- 如要存取 Genesys Cloud 存放區,請傳送電子郵件至 agent-assist-ui-modules-support@google.com。
- 部署 Agent Assist 使用者介面模組後端。部署後端伺服器時,請按照部署說明,將環境變數
AUTH_OPTION
指定為GenesysCloud
。
使用 CLI 部署 Genesys Cloud 應用程式伺服器
- 使用下列程式碼,將 Git 存放區複製到本機電腦或開發環境:
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
- 在本機終端機中,使用下列程式碼將現用目錄變更為 Docker 檔案所在的存放區根目錄,然後執行 Google Cloud CLI 建構作業。
cd genesyscloud/frontend
- 系統提示輸入服務名稱時,請按下 Enter 鍵接受預設名稱。
- 使用下列指令部署整合功能。將
PROJECT-ID
替換為代理程式的 Google Cloud 專案 ID,將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
- 按一下「Enter」接受預設服務名稱。
詳情請參閱 Cloud Run 說明文件。在 Google Cloud 控制台中,您可以查看「Cloud Run」下方的有效整合部署作業清單。
建立 OAuth 用戶端
- 請按照 Genesys Cloud 說明文件中的操作說明,建立新的 OAuth 用戶端 (權杖隱含授權)。
- 確認授權類型為「隱含授權 (瀏覽器)」。
- 將應用程式網址新增至「Authorized redirect URIs」(已授權的重新導向 URI) 部分。
- 將 Oauth 2.0 用戶端權杖的有效時間更新為 3600 秒。這與 Dialogflow API 存取權的 JWT 權杖相符 (效期為 1 小時)。
{Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.
- 將
CONVERSATION_PROFILE_NAME
替換為對話設定檔的名稱,例如projects/your-project/locations/your-location/conversationProfiles/abc123
。 - 將
{FEATURES}
替換為以半形逗號分隔的 Agent Assist 功能清單,其中包含您希望應用程式提供的功能。重要事項:請只加入在對話設定檔中設定的功能。Genesys Cloud 支援下列功能 - 如要將範圍新增至 OAuth 用戶端,請前往「範圍」部分,然後選取標記。
範圍應包含警報、授權、對話、通知和機構。
網址範例:
https://my-project.wm.run.app?conversationProfile=projects/my-project/conversationProfiles/abc123&features=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION
完成環境變數
Genesys Cloud 應用程式會使用下列環境變數。如要設定環境變數,請按照 Cloud Run 操作說明的指示操作。
OAUTH_CLIENT_ID
:Genesys Cloud OAuth 用戶端 ID。GENESYS_CLOUD_REGION
:Genesys Cloud 區域。例如:美國西部(奧勒岡) 的代碼為usw2.pure.cloud
。預設值為mypurecloud.com
。GENESYS_CLOUD_ENVIRONMENT
:Genesys Cloud 環境。預設值為prod
。PROXY_SERVER
:Agent Assist 後端連接器的網址。APPLICATION_SERVER_URL
:UI 應用程式伺服器的網址。PROJECT_ID
:您的 Google Cloud 專案 ID。CONVERSATION_PROFILE
:要使用的對話設定檔。這應與 OAuth 用戶端重新導向網址中的設定檔相符。FEATURES
:以半形逗號分隔的常數,代表 Agent Assist 功能。這應與 OAuth 用戶端的重新導向網址中的功能相符。CHANNEL
:選擇整合類型,值可以是「語音」或「即時通訊」。
.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 也會提供用戶端 ID。
使用更新後的環境變數執行部署指令。
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_ENVIORNMENT=$GENESYS_CLOUD_ENVIORNMENT~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。
關閉應用程式伺服器
- 刪除 Cloud Run 服務。
- 在本機終端機中執行下列指令:
gcloud run services list
- 選取先前選擇的目標平台,列出有效部署作業。
- 請執行下列指令:
gcloud run services delete agent-assist-modules-application-server
價格免責事項
如果您使用 Genesys Cloud 整合服務,則須支付基礎 Cloud Run 服務的相關費用。