部署應用程式伺服器

本指南將說明設定應用程式伺服器的必要步驟，您可以使用該伺服器在 LivePerson 中顯示 Agent Assist 建議。應用程式伺服器會與同一個目錄中的Proxy 伺服器搭配使用。如需在代理人工作區中算繪 UI 模組的操作說明，請參閱 LivePerson 主要教學課程頁面。您必須先建立應用程式伺服器和 Proxy 伺服器，才能在 LivePerson 中算繪模組。

雖然您可以在任何代管平台上設定這項整合部署作業，但下列操作說明是以 Google 的 Cloud Run 為例。

設定

部署服務時，您必須定義下列環境變數。 請務必在首次建立應用程式伺服器時，將 LP_CLIENT_ID 和 LP_CLIENT_SECRET 變數留空。建立 Conversational Cloud 應用程式時，LivePerson 會提供這些變數，您可以在當時更新變數。此外，系統一開始也會略過 APPLICATION_SERVER_URL 和 DF_PROXY_SERVER_URL。部署應用程式和 Proxy 伺服器並傳回必要網址值後，系統就會設定這兩個變數。

  • LP_ACCOUNT_ID：LivePerson 帳戶 ID。
  • LP_CLIENT_ID：您的 LivePerson 用戶端 ID。安裝 Conversational Cloud 應用程式後，LivePerson 就會提供這項資訊。(暫時略過這個變數，您會在提供資訊後更新)。
  • LP_CLIENT_SECRET：您的 LivePerson 用戶端密鑰。安裝 Conversational Cloud 應用程式後，LivePerson 會提供這項資訊。(目前請略過這個變數，您會在提供資訊後更新這個變數)。
  • 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：UI 應用程式伺服器的網址。(暫時略過，並在部署應用程式伺服器並得知其網址後再更新)。
  • DF_PROXY_SERVER_URL：Proxy 伺服器的網址。(暫時略過，並在部署 Proxy 伺服器並得知其網址後再更新)。
  • PROJECT_ID：您的 Google Cloud 專案 ID。請勿加入前置字元。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 為例。

設定 gcloud CLI

本教學課程中說明的部署程序會使用 gcloud CLI 指令。請按照下列步驟，在本機設定 gcloud CLI 以進行這項部署作業：

  1. 在 gcloud CLI 說明文件頁面中選取您的作業系統，然後按照安裝說明操作。
  2. 執行 gcloud config get-value project，檢查 Google Cloud Platform 專案設定。
  3. 前往 Dialogflow 代理程式的設定，並檢查與代理程式相關聯的專案 ID。在 gcloud CLI 中設定的 Google Cloud Platform 專案，應與代理程式的專案 ID 相符。
  4. 如果專案 ID 不相符，請執行 gcloud config set project PROJECT-ID，並將 PROJECT-ID 替換為步驟 3 中的專案 ID。

設定服務帳戶

您必須在 Google Cloud Platform 專案中建立服務帳戶，整合功能才能正常運作。詳情請參閱 Dialogflow 說明文件。

請按照下列步驟建立服務帳戶並設定整合：

  1. 選取與 Agent Assist 資源相關聯的 Google Cloud Platform 專案。
  2. 在 Google Cloud Platform 控制台中點選導覽選單，將滑鼠游標懸停在「IAM 與管理」上，然後點選「服務帳戶」。
  3. 點選「+ 建立服務帳戶」，填寫詳細資料，並指派「Dialogflow Client API」角色。

啟用必要的 API

  1. 前往所需的 Google Cloud Platform 專案。
  2. 在 Google Cloud Platform 主控台中，按一下導覽選單，然後選取「帳單」。請確認您已為專案啟用計費功能。
  3. 為這個專案啟用 Cloud Build 和 Cloud Run API。
  4. 將下列 Git 存放區複製到本機電腦或開發環境：git clone [repository url]。
  5. 在本機電腦或開發環境中，開啟存放區的根目錄。

使用 CLI 部署

在本機終端機中，將現用目錄變更為存放區的根目錄。

執行下列指令，將存放區的狀態儲存到 Google Cloud Platform Container Registry。將 PROJECT-ID 替換為您的 Google Cloud Platform 專案 ID。

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

使用下列指令將整合項目部署至正式環境。將 PROJECT-ID 替換為代理程式的 Google Cloud Platform 專案 ID，並將 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 說明文件。 您可以在 Google Cloud Platform Console 的「Cloud Run」下方，查看有效整合部署作業的清單。

環境變數

按照 Cloud Run 指示設定必要的環境變數。

服務部署完成後，CLI 會輸出應用程式部署的網址 (target_url)。請返回並使用這個值設定 APPLICATION_SERVER_URL 環境變數。

關閉應用程式伺服器

如要關閉應用程式伺服器，請刪除 Cloud Run 服務。

在本機終端機中執行下列指令，然後選取先前選擇的目標平台，列出有效部署作業：

    gcloud beta run services list

接著執行下列指令：

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