部署应用服务器

本指南概述了设置应用服务器所需的步骤，您可以使用该服务器在 LivePerson 中呈现 Agent Assist 建议。应用服务器与同一目录中的代理服务器搭配使用。如需了解如何在客服人员工作区中呈现界面模块，请参阅 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：界面应用服务器的网址。（暂时跳过，在应用服务器部署完毕且您知道其网址后再更新）。
  • DF_PROXY_SERVER_URL：代理服务器的网址。（暂时跳过，在部署代理服务器并知道其网址后再进行更新。）
  • 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