与 Genesys Bot Connector 集成
IBM Cloud
使用 Genesys Bot Connector 集成将助手与 Genesys 连接。
Genesys 机器人连接器支持 Genesys Architect 流设计人员将其消息传递和对话流与任何第三方虚拟助手集成。
准备工作
在开始将您的助手与Genesys Bot Connector集成之前,您必须满足以下要求:
- 新帐户或登录到现有 Genesys Cloud 帐户,可访问 Genesys Architect 和 Genesys Cloud 门户网站上的正确区域。
- Genesys Cloud 组织中的
Admin
角色。 有关 Genesys Cloud 角色和许可权的更多信息,请参阅 角色和许可权概述。
在 Genesys 中设置 Bot 连接器
-
转至“Genesys 管理”页面。
-
在 集成下,单击 集成。
-
在“集成”页面上,单击 + 集成。
-
搜索 Genesys Bot Connector,然后单击 安装。
-
在“详细信息”选项卡中,输入 Bot 连接器的名称和任何注释。
-
单击 复制集成标识,然后保存。 您需要 集成标识 来创建 watsonx Assistant Genesys Bot Connector 集成。
-
在“配置”选项卡的“属性”下,输入占位符 Bot Connector Handle Utterance URI。 您需要在创建 watsonx Assistant Genesys Bot Connector 集成后返回并更新此 URI。
-
在“凭证”选项卡中,使用 配置 创建一个凭证字段,其中 字段名称 为 x-watson-genesys-Verification-token,值 为您在 watsonx Assistant中设置的私钥。 您需要此 值 来创建 watsonx Assistant Genesys Bot 连接器集成。 复制并保留 token 和 value,以便在与 watsonx Assistant集成时可以将它们粘贴到 Verification Token 字段中。
单击“保存”后,无法再次看到这些凭证。
-
单击“确定”并保存。
使 Genesys Web 页面在 Web 浏览器选项卡中保持打开状态,以便您可以在设置过程中引用和填写字段。
将 watsonx Assistant 与 Genesys 集成
创建 Bot 连接器集成
-
通过单击左侧菜单中的集成图标 (
),转至 watsonx Assistant 集成 页面。
-
单击 Genesys Bot Connector 磁贴上的 添加。
-
请单击确认。
将 watsonx Assistant 连接到 Genesys
-
从 Genesys 站点,您需要 Genesys OAuth 凭证。
OAuth 凭证位于“集成> OAuth”下的“Genesys 管理”页面上。 您需要具有授权类型 客户机凭证 的凭证以及具有 BotConnector 许可权的角色。
复制并保留以下值,以便您可以将其粘贴到 Genesys Bot Connector 集成设置页面中。
- 客户机标识
- 客户机私钥
-
返回到 watsonx Assistant Genesys Bot Connector 集成设置页面,然后单击 下一步。
-
输入必填字段,然后单击下一步。
- 客户机标识
- 客户机私钥
- 验证令牌 (来自 Genesys Bot Connector 设置的令牌和值)
- 集成标识
- API URI (您所在地区的Genesys API服务器,例如:
https://api.regionxyz.mypurecloud.com
)
出于安全原因,在初始设置后将从视图中除去认证字段。
配置 Genesys Bot 连接器
-
复制在 Webhook URI 字段中生成的值。
-
转至您打开的“Genesys Bot 连接器配置”选项卡。 在“属性”下,将先前输入的占位符 Bot Connector Handle Utterance URI 替换为此 Webhook URI 值。
-
单击完成。
如果更改了认证所需的字段,那么必须再次填充并验证相关字段中的所有条目。
与助手交谈
要开始与助手聊天,请完成以下步骤:
- 打开 Genesys Architect,并创建 入站消息流。
- 在工具箱中,单击 Bot,然后单击 调用 Bot 连接器。
- 选择值:
- 机器人集成:
- 机器人名称: IBM watsonx Assistant 机器人连接器
- 机器人版本: 1.0
- 机器人集成:
- 输入要传递到 watsonx Assistant的会话变量。 有关更多信息,请参阅 通过会话变量共享上下文。
- Bot 连接器的输出为
Success
或Failure
。 根据输出 Intent of the Bot Connector,您应该在从 Bot Connector 退出时对 Genesys 流进行分支。 有关更多信息,请参阅 条件和输出分支。
通过会话变量进行上下文共享
从 Genesys Architect 流中的 Bot Connector 节点,可以指定可用于将信息传递到 watsonx Assistant的会话变量。 您可以同时指定“输入”和“输出”参数。 对于集成,这两个参数都将合并到 context
对象下的单个对象中。
在 watsonx Assistant context
中提供了输入和输出参数,并且每次轮次都共享信息。 例如,watsonx Assistant 中提供的 context
是:
{
"context": {
"integrations": {
"genesys_bot_connector": {
"user_id": "<SENT FROM GENESYS>",
"some_variable": "<SET_FROM_WATSON_ASSISTANT>"
}
}
}
}
对于输入参数,可以通过以下方式访问 watsonx Assistant 中的会话变量:
-
对话框:使用
$integrations.genesys_bot_connector.user_id
。 -
对于行动:使用
${system_integrations.genesys_bot_connector.user_id}
。
对于输出参数,您可以将会话变量分配给Genesys中的状态变量(例如,State.some_variable
,并在流程中稍后访问它们)。
可以从“对话”和“操作”技能中读取和设置变量。
通过 watsonx Assistant Bot 连接器设置插槽参数
watsonx Assistant Bot Connector 根据对话结束时的最后一个对话轮次设置以下输出参数。
参数 | 描述 |
---|---|
Intent |
watsonx Assistant 设置为对话技能识别的意向,作为成功意向的槽值。 |
调节和输出分支
从 Genesys Architect 中,您可以使用 Logical
函数根据从 watsonx Assistant共享回的上下文来分支流。 例如,watsonx Assistant 返回保存到 State.Intent
的 Intent
参数。
在架构设计师中,您可以添加 Switch
操作以分支到不同的方案。 例如,您可以配置案例 State.Intent == "connect_to_agent"
,然后进行分支。
结束 Genesys Bot Connector 流
当对话到达 Architect 中的 Bot Connector 节点时,Genesys 会在用户与 watsonx Assistant之间代理消息,并继续直至对话结束。 要将对话传递回 Genesys,需要使用 connect_to_agent
响应类型或 end_session
响应类型。
{
"output": {
"generic": [
{
"response_type": "text",
"values": [
{
"text": "You have ended the call."
}
]
},
{
"response_type": "end_session"
}
]
}
}
{
"output": {
"generic": [
{
"response_type": "text",
"values": [
{
"text": "Connecting you to an agent."
}
]
},
{
"response_type": "connect_to_agent"
}
]
}
}
用户定义的响应类型
user_defined
响应类型允许您将定制响应传递回 Genesys。 例如,这可用于将 Cards
和 Carousels
传递回没有 watsonx Assistant 等效响应类型的 Genesys。 将 Card
发送回 Genesys 的示例如下:
{
"output": {
"generic": [
{
"user_defined": {
"replyMessages": [
{
"type": "Structured",
"content": [
{
"contentType": "Card",
"card": {
"title": "Card title",
"description": "Card description",
"image": "http://www.samplesite.com/photo/1234.jpg",
"actions": [
{
"type": "Link",
"text": "Link display text",
"url": "http://www.samplesite.com"
},
{
"type": "Postback",
"text": "Postback display text",
"payload": "Postback text"
}
]
}
}
]
}
]
},
"response_type": "user_defined"
}
]
}
}
响应类型
在为 Genesys Bot Connector 通道部署助手时,支持并按预期显示这些 响应类型。
- connect_too_agent
- 结束会话
- 选项
- 文本
- 用户定义的