您可以在 Genesys Cloud 中设置应用服务器,以便在网页上呈现 Agent Assist 建议。
目标
Genesys Cloud 集成涉及以下流程:
- 部署 后端服务器,以便界面模块调用 Dialogflow API、注册身份验证令牌,并设置 Cloud Pub/Sub 和 Memorystore for Redis。
- 部署 Genesys Cloud 应用服务器,以便在 Cloud Run 中呈现 Agent Assist 界面模块。
- 创建 OAuth 客户端。
- 完成环境变量。
- 在 Genesys Cloud 中设置互动 widget。
- 在 Genesys Cloud 中配置与交互 widget 的 Agent Assist 集成。
- 在 Genesys Cloud 中配置 Messenger。
- 使用 Genesys Cloud 网页聊天和消息传递工具测试集成。
准备工作
在开始 Genesys Cloud 集成之前,您必须完成以下操作:
- 如果您尚未配置 Google Cloud CLI,请进行安装。
- 按照 Google Cloud 说明创建服务账号并分配 Dialogflow API 客户端角色。
- 如需访问 Genesys Cloud 存储库,请发送电子邮件至 agent-assist-ui-modules-support@google.com。
- 部署 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 秒。这与 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.
- 将
CONVERSATION_PROFILE_NAME
替换为对话配置文件的名称,例如projects/your-project/locations/your-location/conversationProfiles/abc123
。 - 将
{FEATURES}
替换为以英文逗号分隔的 Agent Assist 功能列表,您希望应用包含这些功能。重要提示:仅包含在对话配置文件中配置的功能。Genesys Cloud 支持以下功能 - 如需向 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_REGION
:Genesys 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。
关闭应用服务器
- 删除 Cloud Run 服务。
- 在本地终端中,运行以下命令:
gcloud run services list
- 选择之前选择的目标平台以列出有效部署。
- 运行以下命令:
gcloud run services delete agent-assist-modules-application-server
价格免责声明
如果您使用 Genesys Cloud 集成,则需要支付底层 Cloud Run 服务的费用。