您可以在 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_URLGenesys 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 服务的费用。