部署 Proxy 伺服器

本指南將概述設定 Proxy 伺服器所需的步驟。您會搭配應用程式伺服器使用 Proxy 伺服器，簡化 Dialogflow API 的驗證程序。如需在代理程式工作區中算繪 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 應用程式伺服器的網址。
  • JWT_SECRET：用來簽署驗證權杖的「密碼」片語。您可以使用任何詞組，但隨機長密鑰最安全。如需最佳做法，請參閱 https://fusionauth.io/learn/expert-advice/tokens/building-a-secure-jwt/#keys。

.env 範例檔案：

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

部署

使用者介面應用程式伺服器必須部署至 Google Cloud 託管服務。 建議使用 Google App Engine 或 Cloud Run。下列步驟以 Cloud Run 為例。

使用 CLI 部署

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

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

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

使用下列指令將整合項目部署至正式環境。將 PROJECT-ID 替換為代理程式的 Google Cloud Platform 專案 ID，並將 SERVICE-ACCOUNT-EMAIL 替換為服務帳戶用戶端電子郵件地址。

    gcloud run deploy --image gcr.io/PROJECT-ID/agent-assist-modules-proxy-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)。請返回並使用這個值，為應用程式伺服器設定 DF_PROXY_SERVER_URL 環境變數。

關閉 Proxy 伺服器

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

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

    gcloud beta run services list

接著執行下列指令：

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