借助 Conversational Agents (Dialogflow CX) 的 Google Chat 集成,您可以基于 Conversational Agents (Dialogflow CX) 技术,创建具有自然语言理解能力的 Google Chat 应用。
限制
- 此集成仅支持使用代理的默认语言进行文本输入。
设置 Google Chat
如需为代理设置 Google Chat 集成,您需要具备以下各项:
- 一个有权使用 Google Chat 的 Google Workspace 账号。
- 具有一个 Google Cloud 项目。
启用 Google Chat API
在使用 Google API 之前,您需要先在 Google Cloud 项目中启用它们。您可以在单个 Google Cloud 项目中启用一个或多个 API。
在 Google Cloud 控制台中,启用 Google Chat API 和 Dialogflow API。
确认您要启用 API 的 Cloud 项目正确无误,然后点击下一步。
确认您要启用的 API 正确无误,然后点击启用。
通过 Conversational Agents (Dialogflow CX) 进行设置
- 前往 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击左侧边栏菜单中的集成。
- 点击 Google Chat 上的连接。
- 填写以下必填信息:
- 名称:向与此应用创建的内容(例如,在消息、搜索中以及用“@”提及时)互动或使用相应内容的用户显示的名称。例如
Conversational Agents (Dialogflow CX) App
。 - 头像网址:向与应用互动的用户显示的头像图片。指定一个托管一张方形(宽高比为 1:1)PNG 图片的 HTTPS 网址。建议的最小尺寸:256 x 256 像素。例如
https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
。 - 说明:应用的说明。例如,
A helpful bot that responds to real human conversation
。
- 名称:向与此应用创建的内容(例如,在消息、搜索中以及用“@”提及时)互动或使用相应内容的用户显示的名称。例如
- 选择环境(如适用)。
- 输入电子邮件地址,以便向特定人员和群组提供此 Chat 应用(如适用)。
- 点击开始。
测试
如需测试已配置的应用,请在 Google Chat 聊天室中提及该应用或向其发送私信。例如,
- 打开 Google Chat。
- 点击发起新聊天。
- 在添加 1 人或更多人字段中,输入 Chat 应用的名称。
- 从搜索结果中选择 Chat 应用。系统随即会打开一条私信。
富响应消息
可使用履行中的自定义载荷支持富响应消息。如需了解消息格式,请参阅 Google Chat 消息 API。
短信
以下自定义载荷会提供 Google Chat 文本消息:
{ "text": "Hello, world" }
卡片消息
以下自定义载荷会提供 Google Chat 卡片消息:
{ 'cardsV2': [{ 'cardId': 'createCardMessage', 'card': { 'header': { 'title': 'A card message!', 'subtitle': 'Sent from Conversational Agents (Dialogflow CX)', 'imageUrl': 'https://developers.google.com/chat/images/chat-product-icon.png', 'imageType': 'CIRCLE' }, 'sections': [ { 'widgets': [ { 'buttonList': { 'buttons': [ { 'text': 'Read the docs!', 'onClick': { 'openLink': { 'url': 'https://developers.google.com/workspace/chat' } } } ] } } ] } ] } }] }
频道专用响应
配置完成后,当客服人员回复 Google Chat 消息时,系统会自动使用渠道 DF_CX_GOOGLE_CHAT
的渠道专用回复。