部署代理服务器

本指南概述了设置代理服务器所需的步骤。您将将代理服务器与应用服务器结合使用，以简化对 Dialogflow API 的身份验证。如需了解如何在客服人员工作区中呈现界面模块，请参阅 LivePerson 教程主页。您必须在同一目录中同时拥有应用服务器和代理服务器，然后才能在 LivePerson 中呈现模块。

虽然您可以在任何托管平台上设置此集成部署，但这些说明使用的是 Google 的 Cloud Run。

准备工作

在开始本教程之前，请确保您已部署应用服务器。

配置

在部署服务时，您必须定义以下环境变量。在首次创建应用服务器时，请务必将 LP_CLIENT_ID 和 LP_CLIENT_SECRET 变量留空。在您创建 Conversational Cloud 应用时，LivePerson 会提供这些变量，您需要在该时刻更新这些变量。您还将最初跳过 APPLICATION_SERVER_URL 和 DF_PROXY_SERVER_URL，在应用和代理服务器部署并返回所需值后再进行设置。

  • LP_ACCOUNT_ID：LivePerson 账号 ID。
  • LP_CLIENT_ID：您的 LivePerson 客户 ID。安装 Conversational Cloud 应用后，LivePerson 会提供此信息。（暂时跳过此变量，您可以在提供相关信息后更新此变量）。
  • LP_CLIENT_SECRET：您的 LivePerson 客户端密钥。安装 Conversational Cloud 应用后，LivePerson 会提供此 ID。（暂时跳过此变量，您可以在提供相关信息后再更新此变量）。
  • 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：界面应用服务器的网址。
  • 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 环境变量。

关闭代理服务器

如需关闭应用服务器，您需要删除 Cloud Run 服务。

在本地终端中，运行以下命令，然后选择之前选择的目标平台以列出有效的部署：

    gcloud beta run services list

接下来，运行以下命令：

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