与 Genesys 音频连接器集成

IBM Cloud

您可以将 Genesys Audio Connector 与助手集成，以在助手与 Genesys Cloud 之间流式传输对话音频。

准备工作

在开始将助手与 Genesys Audio Connector 集成之前，必须满足以下先决条件:

新帐户或登录到现有 Genesys Cloud 帐户，可访问 Genesys Architect 和 Genesys Cloud 门户网站上的正确区域。
Genesys Cloud 组织中的 Admin 角色。

有关 Genesys Cloud 角色和权限的更多信息，请参阅角色和权限概述。

在助手中创建音频连接器集成

点击左侧菜单中的集成图标，进入集成页面。

存储凭证，因为单击保存后无法看到这些凭证。您需要这些凭证才能设置 Genesys 音频连接器。

单击电话磁贴上的添加。
单击 Genesys Audio Connector 磁贴。
在凭证部分中，将自动生成的凭证复制并存储在以下字段中:
- API 密钥
- 客户机私钥
- Genesys 音频连接 URI
- 机器人连接器标识
单击保存并退出。

设置音频连接器以集成助手

要设置 Genesys Audio Connector，请完成 Genesys Cloud 文档中在 Genesys 云中配置并激活音频连接器主题中的步骤。

在 Genesys 管理页面，转到“集成”>“配置”，添加在助手中创建音频连接器集成时复制的 Genesys 音频连接 URI 值。

在 Genesys 管理员 页面中，转到集成 > 证书添加您在在助手中创建音频连接器集成时复制的 API 密钥 和 客户秘密 字段的凭据。

呼叫流

使用 Genesys 中的 调用音频连接器 操作来激活助手中的音频连接器集成。

有关更多信息，请参阅 "呼叫音频连接器" 操作。

从凭证部分获取 Genesys 音频连接 URI 后，请执行以下操作：

转至“Genesys 管理”页面。
在“架构设计师”下，单击 架构设计师，然后创建 入站呼叫流程。
在“工具箱”中，单击 Bot，然后单击 呼叫音频连接器。
为您的呼叫流程输入一个名称。
从集成下拉菜单中选择音频连接器集成。
您必须复制凭证部分的存储的 Bot 连接器标识 字段，并将其粘贴到 连接器标识 字段中。<instance-id>/connect?version=<api-version>
输入要传递到 watsonx Assistant的会话变量。有关更多信息，请参阅通过会话变量共享上下文。
单击流程图底部以创建终止操作。例如，Disconnect。
点击 “保存并发布”。

呼叫路由

创建呼叫路由以将入局呼叫定向到 Genesys 呼叫流程。

转至“Genesys 管理”页面。
转至 呼叫路由 以创建呼叫路由。
输入呼叫路由的名称。
选择大区。
从 路由到 下拉菜单中选择在上一步中配置的调用流。
在呼叫流程中，分配要将呼叫路由到的电话号码。
单击创建。

通过会话变量进行上下文共享

从 Genesys Architect 流中的 Audio Connector 节点，可以指定可用于将信息传递到 watsonx Assistant的会话变量。您可以同时指定“输入”和“输出”参数。在整合过程中，这两个参数被合并到 context 对象下的一个对象中。

在 watsonx Assistant context 中提供了输入和输出参数，并且将在每次轮次上共享信息。例如，watsonx Assistant 中提供的 context 就是这样：

{
  "context": {
    "integrations": {
      "genesys_audio_connector": {
        "user_id": "<SENT FROM GENESYS>",
        "some_variable": "<SET_FROM_WATSON_ASSISTANT>"
      }
    }
  }
}

使用 ${system_integrations.genesys_audio_connector.user_id}会话变量访问 "watsonx Assistant中的输入参数。

要设置输出参数，可使用 ${system_integrations{system_integrations.genesys_audio_connector.some_variable} 等表达式，稍后可在流程中访问。

执行以下步骤设置输出变量：

转到要定义变量的操作步骤。
单击设置新变量并选择表达式。
输入以下表达式：${system_integrations.genesys_audio_connector.<variable_name>} = "<variable_value>"

示例：
```
${system_integrations.genesys_audio_connector.some_variable} = "this is an output variable"
```
在这个例子中，变量名为 some_variable，值为 this is an output variable。

结束 Genesys 音频连接器流

在从用户接收音频对话后，Genesys Architect 中的 Audio Connector 节点可促进用户与助手之间的消息交换，直到对话结束。要将音频对话发回 Genesys，必须使用 end_session 响应类型。

{
  "generic": [
    {
      "response_type": "text",
      "values": [
        {
          "text": "You have ended the call."
        }
      ]
    },
    {
      "response_type": "end_session"
    }
  ]
}

响应类型

将 watsonx Assistant 与 Genesys Audio Connector 集成后，可以在助手中使用以下响应类型:

文本
选项
end_session
演讲稿
text_to_speech
start_activities
stop_activities
dtmf
用户定义
connect_too_agent
图像
音频