部署应用服务器

本指南概述了设置应用服务器所需的步骤，您可以使用该服务器在 LivePerson 中呈现 Agent Assist 建议。应用 服务器与同一 目录中的代理服务器一起使用。如需了解如何在代理 工作区中呈现界面模块，请参阅 LivePerson 主教程页面。您必须同时拥有应用服务器和代理服务器，才能在 LivePerson 中呈现模块。

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

配置

部署服务时，您必须定义以下环境变量。 请务必在首次创建应用服务器时将 LP_CLIENT_ID 和 LP_CLIENT_SECRET 变量留空。LivePerson 会在您创建 Conversational Cloud 应用时提供这些变量，您届时将更新这些变量。您最初还会跳过 APPLICATION_SERVER_URL 和 DF_PROXY_SERVER_URL。在应用服务器和代理服务器部署完毕并返回所需的网址值后，系统会设置这两个变量。

  • LP_ACCOUNT_ID：LivePerson 账号 ID。
  • LP_CLIENT_ID：您的 LivePerson 客户端 ID。安装 Conversational Cloud 应用后，LivePerson 会提供此 ID。（暂时跳过此 变量，您将在收到信息后更新它）。
  • 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：界面应用服务器的网址。（暂时跳过，并在应用服务器部署完毕且您知道其网址后进行更新）。
  • 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