IBM Cloud Docs
与 Genesys Bot Connector 集成

与 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 连接器

  1. 转至“Genesys 管理”页面。

  2. 集成下,单击 集成

  3. 在“集成”页面上,单击 + 集成

  4. 搜索 Genesys Bot Connector,然后单击 安装

  5. 在“详细信息”选项卡中,输入 Bot 连接器的名称和任何注释。

  6. 单击 复制集成标识,然后保存。 您需要 集成标识 来创建 watsonx Assistant Genesys Bot Connector 集成。

  7. 在“配置”选项卡的“属性”下,输入占位符 Bot Connector Handle Utterance URI。 您需要在创建 watsonx Assistant Genesys Bot Connector 集成后返回并更新此 URI。

  8. 在“凭证”选项卡中,使用 配置 创建一个凭证字段,其中 字段名称x-watson-genesys-Verification-token 为您在 watsonx Assistant中设置的私钥。 您需要此 来创建 watsonx Assistant Genesys Bot 连接器集成。 复制并保留 tokenvalue,以便在与 watsonx Assistant集成时可以将它们粘贴到 Verification Token 字段中。

    单击“保存”后,无法再次看到这些凭证。

  9. 单击“确定”并保存。

使 Genesys Web 页面在 Web 浏览器选项卡中保持打开状态,以便您可以在设置过程中引用和填写字段。

将 watsonx Assistant 与 Genesys 集成

创建 Bot 连接器集成

  1. 通过单击左侧菜单中的集成图标 (集成图标),转至 watsonx Assistant 集成 页面。

  2. 单击 Genesys Bot Connector 磁贴上的 添加

  3. 请单击确认

将 watsonx Assistant 连接到 Genesys

  1. 从 Genesys 站点,您需要 Genesys OAuth 凭证。

    OAuth 凭证位于“集成> OAuth”下的“Genesys 管理”页面上。 您需要具有授权类型 客户机凭证 的凭证以及具有 BotConnector 许可权的角色。

    复制并保留以下值,以便您可以将其粘贴到 Genesys Bot Connector 集成设置页面中。

    • 客户机标识
    • 客户机私钥
  2. 返回到 watsonx Assistant Genesys Bot Connector 集成设置页面,然后单击 下一步

  3. 输入必填字段,然后单击下一步

    • 客户机标识
    • 客户机私钥
    • 验证令牌 (来自 Genesys Bot Connector 设置的令牌和值)
    • 集成标识
    • API URI (您所在地区的Genesys API服务器,例如:https://api.regionxyz.mypurecloud.com

出于安全原因,在初始设置后将从视图中除去认证字段。

配置 Genesys Bot 连接器

  1. 复制在 Webhook URI 字段中生成的值。

  2. 转至您打开的“Genesys Bot 连接器配置”选项卡。 在“属性”下,将先前输入的占位符 Bot Connector Handle Utterance URI 替换为此 Webhook URI 值。

  3. 单击完成

如果更改了认证所需的字段,那么必须再次填充并验证相关字段中的所有条目。

与助手交谈

要开始与助手聊天,请完成以下步骤:

  1. 打开 Genesys Architect,并创建 入站消息流
  2. 在工具箱中,单击 Bot,然后单击 调用 Bot 连接器
  3. 选择值:
    • 机器人集成:
    • 机器人名称: IBM watsonx Assistant 机器人连接器
    • 机器人版本: 1.0
  4. 输入要传递到 watsonx Assistant的会话变量。 有关更多信息,请参阅 通过会话变量共享上下文
  5. Bot 连接器的输出为 SuccessFailure。 根据输出 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.IntentIntent 参数。

在架构设计师中,您可以添加 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。 例如,这可用于将 CardsCarousels 传递回没有 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
  • 结束会话
  • 选项
  • 文本
  • 用户定义的