您可以设置应用服务器，以便在 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 中配置 Agent Assist 与互动 widget 的集成。
- 在 Genesys Cloud 中配置 Messenger。
- 使用 Genesys Cloud 网页聊天和消息传递工具测试集成。
准备工作
在开始 Genesys Cloud 集成之前，您必须完成以下操作：
- 安装 Google Cloud CLI（如果您尚未配置）。
- 按照 Google Cloud 说明创建服务账号并分配 Dialogflow API 客户端角色。
- 部署 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 客户端。
- 确保授权类型为代码授权 / PKCE 。
- 将您的应用网址添加到已获授权的重定向 URI 部分。
- 将 OAuth 2.0 客户端令牌时长更新为 3600 秒 。这与 Dialogflow API 访问的默认 1 小时 JWT 令牌时长相匹配。如果您需要自定义时长，请相应地更新 OAuth 和 JWT 令牌时长。
{Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES} - 将
CONVERSATION_PROFILE_NAME替换为 对话配置文件 的名称，例如projects/your-project/locations/your-location/conversationProfiles/abc123。 - 将
{FEATURES}替换为您希望应用包含的 Agent Assist 功能的英文逗号分隔列表。重要提示：仅包含在对话配置文件中配置的功能。Genesys Cloud 支持以下 功能 - 如需向 OAuth 客户端添加范围，请前往范围 部分。
- 选择以下范围：
alerting、authorization、conversations、notifications、messaging和organization。
示例网址：
https://my-project.wm.run.app?conversationProfile=projects/my-project/conversationProfiles/abc123&features=CONVERSATION_SUMMARIZATION,AGENT_COACHING,PROACTIVE_GENERATIVE_KNOWLEDGE_ASSIST
我们建议为嵌入式 iframe 启用弹出式身份验证，以确保顺畅的登录体验。
填写环境变量
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：Agent Assist 功能的以逗号分隔常量。这应与 OAuth 客户端的重定向网址中的功能相匹配。CHANNEL：选择集成类型，值可以是“voice”或“chat”。
示例 .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_ENVIRONMENT=$GENESYS_CLOUD_ENVIRONMENT~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 服务的费用。