部署 Genesys Cloud 应用服务器

您可以在 Genesys Cloud 中设置应用服务器,以便在网页上呈现 Agent Assist 建议。

目标

Genesys Cloud 集成涉及以下流程:

  1. 部署 后端服务器,以便界面模块调用 Dialogflow API、注册身份验证令牌,并设置 Cloud Pub/Sub 和 Memorystore for Redis。
  2. 部署 Genesys Cloud 应用服务器,以便在 Cloud Run 中呈现 Agent Assist 界面模块。
  3. 创建 OAuth 客户端
  4. 完成环境变量
  5. 在 Genesys Cloud 中设置互动 widget
  6. 在 Genesys Cloud 中配置与交互 widget 的 Agent Assist 集成。
  7. 在 Genesys Cloud 中配置 Messenger
  8. 使用 Genesys Cloud 网页聊天和消息传递工具测试集成。

准备工作

在开始 Genesys Cloud 集成之前,您必须完成以下操作:

  1. 如果您尚未配置 Google Cloud CLI,请进行安装。
  2. 按照 Google Cloud 说明创建服务账号分配 Dialogflow API 客户端角色
  3. 如需访问 Genesys Cloud 存储库,请发送电子邮件至 agent-assist-ui-modules-support@google.com。
  4. 部署 Agent Assist 界面模块后端。部署后端服务器时,请按照部署说明将环境变量 AUTH_OPTION 指定为 GenesysCloud

使用 CLI 部署 Genesys Cloud 应用服务器

  1. 使用以下代码将 Git 代码库克隆到本地机器或开发环境:
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
    
  2. 在本地终端中,使用以下代码将有效目录更改为 Docker 文件所在的代码库根目录,然后再运行 Google Cloud CLI build 命令。
    cd genesyscloud/frontend
    
  3. 当系统提示您输入服务名称时,请按 Enter 接受默认名称。
  4. 使用以下命令部署集成。将 PROJECT-ID 替换为代理的 Google Cloud 项目 ID,将 UI_MODULE_SERVICE_ACCOUNT 替换为服务账号客户端电子邮件地址,并为 Cloud Run 设置 REGION
    gcloud run deploy $AA_MODULE_APPLICATION_SERVER 
    --source ./
    --service-account=$ui_module_service_account
    --memory 1Gi --platform managed
    --region us-central1
    --allow-unauthenticated
  5. 点击 Enter 以接受默认服务名称。

如需了解详情,请参阅 Cloud Run 文档。在 Google Cloud 控制台中,您可以在 Cloud Run 下查看有效集成部署的列表。

创建 OAuth 客户端

  1. 按照 Genesys Cloud 文档中的说明创建一个新的 OAuth 客户端(令牌隐式授予)。
  2. 确保授权类型为隐式授权(浏览器)
  3. 将应用网址添加到已获授权的重定向 URI 部分。
  4. 将 OAuth 2.0 客户端令牌时长更新为 3600 秒。这与 Dialogflow API 访问权限的 JWT 令牌的 1 小时期限相符。
    {Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.
    
  5. CONVERSATION_PROFILE_NAME 替换为对话配置文件的名称,例如 projects/your-project/locations/your-location/conversationProfiles/abc123
  6. {FEATURES} 替换为以英文逗号分隔的 Agent Assist 功能列表,您希望应用包含这些功能。重要提示:仅包含在对话配置文件中配置的功能。Genesys Cloud 支持以下功能
  7. 如需向 OAuth 客户端添加范围,请前往范围部分,然后选择您的标记。

。范围应包括提醒、授权、对话、通知和组织。

示例网址:

https://my-project.wm.run.app?conversationProfile=projects/my-project/conversationProfiles/abc123&features=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION

完成环境变量设置

Genesys Cloud 应用使用以下环境变量。如需设置环境变量,请按照 Cloud Run 说明操作。

  • OAUTH_CLIENT_ID:Genesys Cloud OAuth 客户端 ID。
  • GENESYS_CLOUD_REGIONGenesys Cloud 区域。例如,usw2.pure.cloud 表示美国西部(俄勒冈)。默认值为 mypurecloud.com
  • GENESYS_CLOUD_ENVIRONMENT:Genesys Cloud 环境。默认值为 prod
  • PROXY_SERVER:Agent Assist 后端连接器的网址。
  • APPLICATION_SERVER_URL:界面应用服务器的网址。
  • PROJECT_ID:您的 Google Cloud 项目 ID。
  • CONVERSATION_PROFILE:要使用的对话配置文件。此值应与 OAuth 客户端的重定向网址中的配置文件相匹配。
  • FEATURES:以英文逗号分隔的智能助理功能常量。这应与 OAuth 客户端的重定向网址中的功能相匹配。
  • CHANNEL:选择集成类型,值可以是“语音”或“聊天”。

.env 文件示例:

OAUTH_CLIENT_ID={your-oauth-client-id}
GENESYS_CLOUD_REGION={your-pure-cloud-region}
GENESYS_CLOUD_ENVIRONMENT={your-pure-cloud-environment}
PROXY_SERVER={your-proxy-server-endpoint}
PROJECT_ID={your-gcp-project-id}
CONVERSATION_PROFILE={your-conversation-profile}
FEATURES=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION
CHANNEL={use-voice-or-chat}

创建 OAuth 客户端时,Genesys Cloud 还会提供一个客户端 ID。

运行部署命令,并指定更新后的环境变量。

    gcloud run deploy $AA_MODULE_APPLICATION_SERVER 
--source ./
--service-account=$ui_module_service_account
--memory 1Gi --platform managed
--region us-central1
--allow-unauthenticated
--set-env-vars ^~^OAUTH_CLIENT_ID=$OAUTH_CLIENT_ID~GENESYS_CLOUD_REGION=$GENESYS_CLOUD_REGION~GENESYS_CLOUD_ENVIORNMENT=$GENESYS_CLOUD_ENVIORNMENT~CONVERSATION_PROFILE=$CONVERSATION_PROFILE~FEATURES=$FEATURES~PROJECT_ID=$PROJECT_ID~APPLICATION_SERVER_URL=''~PROXY_SERVER=$PROXY_SERVER~APPLICATION_SERVER_URL=$APPLICATION_SERVER_URL

Genesys Cloud 应用服务器必须部署到 Google Cloud 托管服务。使用 App Engine 或 Cloud Run。

关闭应用服务器

  1. 删除 Cloud Run 服务。
  2. 在本地终端中,运行以下命令:
    gcloud run services list
    
  3. 选择之前选择的目标平台以列出有效部署。
  4. 运行以下命令:
    gcloud run services delete agent-assist-modules-application-server
    

价格免责声明

如果您使用 Genesys Cloud 集成,则需要支付底层 Cloud Run 服务的费用。

后续步骤