与 Genesys 音频连接器集成

准备工作

在开始将助手与 Genesys Audio Connector 集成之前，您必须具备以下先决条件：

请在 Genesys Cloud 门户上注册新账户，或使用具有 Genesys Architect 访问权限且所属区域正确的现有 Genesys Cloud 账户登录。
Genesys Cloud 组织中的 "Admin角色。

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

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

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

保存凭证，因为点击保存后就看不到了。您需要这些证书来设置 Genesys 音频连接器。

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

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

要设置 Genesys Audio Connector，请按照“在 Genesys Cloud 中配置和激活 Audio Connector ”主题中的步骤操作。

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

In the Genesys 管理员 page, go to 集成 > 证书 to add the credentials for the API 密钥 and 客户秘密 fields that you copied while 在助手中创建音频连接器集成.

呼叫流程

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

如需更多信息，请参阅 “呼叫音频连接器”操作。

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

转到 Genesys 管理页面。
在 Architect 下单击Architect，然后创建一个呼入呼叫流。
在工具箱中，单击 "机器人"，然后单击 "调用音频连接器"。
输入呼叫流的名称。
从 "集成 "下拉菜单中选择音频连接器集成。
您必须复制凭证部分存储的Bot Connector ID字段，并将其粘贴到Connector ID字段中。 <instance-id>/connect?version=<api-version>
输入您希望在 AI 助手构建器之间传递的会话变量。如需了解更多信息，请参阅 “通过会话变量共享上下文 ”。
单击流程图底部，创建终止操作。例如，Disconnect。
单击保存并发布。

呼叫路由

创建呼叫路由，将来电引导至 Genesys 呼叫流。

转到 Genesys 管理页面。
转到呼叫路由，创建呼叫路由。
输入呼叫路由名称。
选择分部。
从路由到下拉菜单中选择上一步配置的呼叫流。
在呼叫流程中，指定要转接呼叫的电话号码。
单击创建。

通过会话变量共享上下文

在 Genesys Architect 流程中的“音频连接器”节点中，您可以指定会话变量，用于向 AI 助手构建器传递信息。您可以指定输入和输出参数。在集成过程中，这两个参数都会合并到对象 context 下的一个单一对象中。

AI 助手中同时 context提供了输入和输出参数，且这些信息会在每个回合中共享。例如，AI 助手中 context 提供的功能是：

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

使用 ${system_integrations.genesys_audio_connector.user_id} 会话变量访问 AI 助手中的输入参数。

要设置输出参数，请使用类似于 ${system_integrations.genesys_audio_connector.some_variable} 的表达式，您可以在流程的后续步骤中访问该参数。

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

转到 AI 助手的 “操作”步骤，在该步骤中定义变量。
单击设置新变量并选择表达式。
输入以下表达式：

${system_integrations.genesys_audio_connector.<variable_name>} = "<variable_value>"

示例：

${system_integrations.genesys_audio_connector.some_variable} = "this is an output variable"

在本例中，变量名是 some_variable ，值设置为 "这是一个输出变量"。

结束 Genesys 音频连接器流程

接收到用户的音频对话后，Genesys Architect 中的音频连接器节点会帮助用户和助手交换信息，直到对话结束。要将音频对话发回 Genesys，必须使用 "end_session响应类型。

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

响应类型

将您的 AI 助手构建器与 Genesys Audio Connector 集成后，您可以在该助手中使用以下响应类型：

文本
选项
结束会话
语音到文本
文本到语音
开始活动
停止活动
双音多频
用户定义
connect_too_agent
图像
音频