部署代理服务器

本指南概述了设置代理服务器所需的步骤。您将结合使用代理服务器和应用服务器，以简化与 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 会提供此信息。 （暂时跳过此变量，您将在提供信息后更新它）。
  • 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