此页面由 Cloud Translation API 翻译。

部署 Genesys Cloud 应用服务器

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

目标

Genesys Cloud 集成涉及以下流程：

为界面模块部署后端服务器，以调用 Dialogflow API、注册身份验证令牌，并设置 Cloud Pub/Sub 和 Memorystore for Redis。
在 Cloud Run 中部署 Genesys Cloud 应用服务器，以呈现 Agent Assist 界面模块。
创建 OAuth 客户端。
填写环境变量。
在 Genesys Cloud 中设置互动 widget。
在 Genesys Cloud 中配置 Agent Assist 与互动 widget 的集成。
在 Genesys Cloud 中配置 Messenger。
使用 Genesys Cloud 聊天和即时通讯工具测试集成。

准备工作

您必须先完成以下操作，然后才能开始 Genesys Cloud 集成：

如果您尚未配置 Google Cloud CLI，请安装该工具。
按照 Google Cloud 说明创建服务账号并分配 Dialogflow API 客户端角色。
请与 agent-assist-ui-modules-support@google.com 联系，以便访问 Genesys Cloud 代码库。
部署 Agent Assist 界面模块后端。在部署后端服务器时，请按照部署说明，将环境变量 AUTH_OPTION 指定为 GenesysCloud。

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

使用以下代码将 git 代码库克隆到本地机器或开发环境：

git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations

在本地终端中，使用以下代码将当前目录更改为 Docker 文件所在的代码库根目录，然后再运行 Google Cloud CLI build。
```
cd genesyscloud/frontend
```
当系统提示您输入服务名称时，请按 Enter 键接受默认名称。
使用以下命令部署集成。将 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 
```
点击 Enter 接受默认服务名称。

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

创建 OAuth 客户端

按照 Genesys Cloud 文档中的说明创建新的 OAuth 客户端（令牌隐式授予）。
确保授权类型为隐式授权（浏览器）。
将您的应用网址添加到已获授权的重定向 URI 部分。

将 Oauth 2.0 客户端令牌时长更新为 3600 秒。这与有效期为 1 小时的 Dialogflow API 访问权限 JWT 令牌相匹配。

{Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.

将 CONVERSATION_PROFILE_NAME 替换为对话个人资料的名称，例如 projects/your-project/locations/your-location/conversationProfiles/abc123。
将 FEATURES 替换为您希望应用包含的 Agent Assist 功能的逗号分隔列表。仅包含在对话配置文件中配置的功能。Genesys Cloud 支持以下功能

示例网址：

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_REGION：Genesys Cloud 区域。例如，usw2.pure.cloud 表示美国西部（俄勒冈州）。默认值为 mypurecloud.com。
GENESYS_CLOUD_ENVIRONMENT：Genesys 云环境。默认值为 prod。
PROXY_SERVER：Agent Assist 后端连接器的网址。
APPLICATION_SERVER_URL：界面应用服务器的网址。
PROJECT_ID：您的 Google Cloud 项目 ID。
CONVERSATION_PROFILE：要使用的对话配置文件。此值应与 OAuth 客户端重定向网址中的配置文件一致。
FEATURES：Agent Assist 功能的逗号分隔常量。这应与 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。

关闭应用服务器

删除 Cloud Run 服务。
在本地终端中，运行以下命令：
```
gcloud run services list
```
选择之前选择的目标平台以列出有效的部署。

运行以下命令：

gcloud run services delete agent-assist-modules-application-server