command_info.type : configure

通过应用一组可基于对话流的配置参数，动态重新配置 Speech to Text 服务。 例如，您可能希望在对话中的特定点选择特定定制标识或语法。

可以为 narrowband_recognize 和 broadband_recognize 设置的参数反映 Speech to Text WebSocket 接口提供的参数。 WebSocket API 发送两种类型的参数: 查询参数 (在电话集成连接到服务时发送) 和消息参数 (作为请求主体中 JSON 数据的一部分发送)。 例如，model 是查询参数，smart_formatting 是 WebSocket 消息参数。 有关参数的完整列表，请参阅 Speech to Text API 文档。

您可以为电话集成与 Speech to Text 服务的连接定义以下查询参数。 您为 narrowband 或 broadband 定义的任何其他参数都将作为 WebSocket 消息请求的一部分传递。

• model
• acoustic_customization_id
• version
• x-watson-learning-opt-out
• base_model_version
• language_customization_id

无法修改 Speech to Text 服务中的以下参数，因为它们具有电话集成所使用的固定值。

• action
• content-type
• interim_results
• continuous
• inactivity_timeout

使用 configure 命令从 watsonx Assistant 动态配置时，仅会更新根级别字段，例如 narrowband 或 broadband。 如果从命令中省略这些字段，那么原始配置设置将持久存储。 您可以使用 update_strategy 值 merge 和 merge_once 将配置参数与现有配置合并。

使用定制语言模型

设置电话集成后，可以将该集成配置为始终使用定制语言模型。

但是，您可能希望绝大部分时间使用标准语言模型，而指定的定制语言模型仅用于助手设计为帮助客户的特定主题。 例如，您可能希望使用一个专门针对医疗术语的自定义模型，用于仅帮助处理医疗账单的操作。 您可以对对话的特定分支应用定制语言模型。

有关更多信息，请参阅 创建定制语言模型。

要将定制语言模型应用于操作步骤，请使用 speech_to_text 响应类型。

{
  "generic": [
    {
      "response_type": "speech_to_text",
      "command_info": {
        "type": "configure",
        "parameters": {
          "narrowband_recognize": {
            "x-watson-learning-opt-out": true,
            "model": "en-US_NarrowbandModel",
            "profanity_filter": true,
            "smart_formatting": true,
            "language_customization_id": "81d3630-ba58-11e7-aa4b-41bcd3f6f24d",
            "acoustic_customization_id": "e4766090-ba51-11e7-be33-99bd3ac8fa93"
          }
        }
      }
    }
  ]
}

您还可以应用声学模型，您可以训练该模型来处理背景噪音、重音或其他与信号质量或噪音相关的问题。

使用定制语法

Speech to Text 服务支持语法的使用。 您可以使用语法将音频配置为仅与特定特征匹配。

• 定制语言模型用于扩展服务的基本词汇表。
• 语法用于限制服务可以从该词汇表中识别的词。

将语法与定制语言模型一起用于语音识别时，服务可以仅识别语法识别到的词、短语和字符串。 例如，您可能只想接受 yes 或 no 的回复。 为此，可以定义仅允许这些选项的语法。

有关更多信息，请参阅 将语法用于定制语言模型。

此示例显示如何在对话期间指定定制语法:

{
  "generic": [
    {
      "response_type": "speech_to_text",
      "command_info": {
        "type": "configure",
        "parameters": {
          "update_strategy": "merge_once",
          "narrowband_recognize": {
            "x-watson-learning-opt-out": true,
            "grammar_name": "names-abnf",
            "language_customization_id": "81d3630-ba58-11e7-aa4b-41bcd3f6f24d"
          }
        }
      }
    }
  ]
}

示例

以下示例说明如何使用 speech_to_text 响应类型将配置命令发送到 Speech to Text 服务。

{
  "generic": [
    {
      "response_type": "speech_to_text",
      "command_info": {
        "type": "configure",
        "parameters": {
          "narrowband_recognize": {
            "model": "es-ES_NarrowbandModel",
            "smart_formatting": true
          }
        }
      }
    }
  ]
}

{
  "generic": [
    {
      "response_type": "speech_to_text",
      "command_info": {
        "type": "configure",
        "parameters": {
          "update_strategy": "merge_once",
          "narrowband_recognize": {
            "language_customization_id": "ao45vohgFuxyOQRgztu-02I10ut7aJcM-AdInT-VWgj3V"
          }
        }
      }
    }
  ]
}

command_info.type : configure

通过应用一组可基于对话流的配置参数，动态重新配置 Text to Speech 服务。 例如，您可能希望在对话中的特定点选择特定声音。

可以为 synthesize 设置的参数反映 Text to Speech WebSocket 接口提供的参数。 WebSocket API 发送两种类型的参数: 查询参数 (在电话集成连接到服务时发送) 和消息参数 (作为请求主体中 JSON 数据的一部分发送)。 有关参数的完整列表，请参阅 Text to Speech API 文档。

command_info.type : disable_barge_in

禁用语音打断，以便在回放音频时，当呼叫者说话时不会中断回放。

无参数。

command_info.type : enable_barge_in

启用语音闯入功能，这样来电者就可以通过说话中断播放。

无参数。

更改助手的声音

当对话中涉及到某些有必要的话题时，您可以改变助理的语音。 例如，您可能希望将带有英国口音的语音用于仅适用于英国客户的对话分支。

此示例显示如何在对话期间指定语音:

{
  "generic": [
    {
      "response_type": "text_to_speech",
      "command_info": {
        "type": "configure",
        "parameters": {
          "synthesize": {
            "voice": "en-GB_KateV3Voice"
          }
        }
      }
    }
  ]
}

在 voice 参数中，指定要使用的语音模型。 有关语音模式选项的更多信息，请参阅 支持的语言和语音。

您指定的模型必须是 Text to Speech 服务实例支持的模型，该服务实例已配置用于集成。

挂断后传输

缺省情况下，电话集成通过使用 SIP REFER 请求来传输呼叫。 根据 IVR 服务提供者，您可能需要配置呼叫转移以改为使用 SIP BYE 请求。 使用 transfer_method 属性来指定如何使用 refer 或 hangup 来传输调用。 当 transfer_method 设置为 hangup 而不是 refer 时，传输操作的行为将发生更改。 电话集成不发送 SIP REFER 请求，而是回放任何关联文本，然后通过发送 SIP BYE 请求来挂起呼叫。

挂断后，电话集成会将 url 属性中指定的传输目标传递到 BYE 消息中的呼叫锚点。 包含传输目标的头字段由 transfer_target_header 属性确定。 如果未指定 transfer_target_header 属性，那么电话集成将使用 Transfer-Target。

{
  "generic": [
    {
      "response_type": "connect_to_agent",
      "transfer_info": {
        "target": {
          "service_desk": {
            "sip": {
              "uri": "sip:user\\@domain.com",
              "transfer_method": "hangup",
              "transfer_target_header": "Transfer-Target"
            }
          }
        }
      },
      "agent_available": {
        "message": "Please hold on while I connect you with a live agent."
      },
      "agent_unavailable": {
        "message": "Sorry, I could not find an agent."
      },
      "message_to_human_agent": "The caller needs help resetting their password"
    }
  ]
}

失败时传输

要配置失败时的传输，请转至电话集成设置中的 高级 选项卡。 可以配置以下选项：

• 传输失败消息

• 在传输失败时断开连接调用

有关更多信息，请参阅 处理呼叫和传输失败。

在 SIP 信令中传递 watsonx Assistant 元数据

为支持在呼叫者与 watsonx Assistant之间装入会话历史记录，电话集成指定 User-to-User 头的值作为可用于 Web 聊天集成的键。 如果在 transfer_headers 列表中指定了 User-to-User，那么将在 X-Watson-Assistant-Session-History-Key 头中发送会话历史记录密钥。

SIP 头的值限制为 1024 字节。

此数据在 SIP REFER 消息中的显示方式还取决于 transfer_headers_send_method 的值。

此示例显示了作为头包含的数据:

REFER sip:b@atlanta.example.com SIP/2.0
Via: SIP/2.0/UDP agenta.atlanta.example.com;branch=z9hG4bK2293940223
To: <sip:b@atlanta.example.com>
From: <sip:a@atlanta.example.com>;tag=193402342
Call-ID: 898234234@agenta.atlanta.example.com
CSeq: 23 REFER
Max-Forwards: 7
Refer-To: sip:user@domain.com
X-Watson-Assistant-Token: 8f817472-8c57-4117-850d-fdf4fd23ba7
User-to-User: 637573746f6d2d757365722d746f2d75736572;encoding=hex
Contact: sip:a@atlanta.example.com
Content-Length: 0

如果指定了定制 User-to-User 头，那么将在 X-Watson-Assistant-Session-History-Key 头中设置会话历史记录密钥:

REFER sip:b@atlanta.example.com SIP/2.0
Via: SIP/2.0/UDP agenta.atlanta.example.com;branch=z9hG4bK2293940223
To: <sip:b@atlanta.example.com>
From: <sip:a@atlanta.example.com>;tag=193402342
Call-ID: 898234234@agenta.atlanta.example.com
CSeq: 93809823 REFER
Max-Forwards: 70
Refer-To: sip:user@domain.com
User-to-User: 637573746f6d2d757365722d746f2d75736572;encoding=hex
X-Watson-Assistant-Session-History-Key: dev::latest::212033::0a64c30d-c558-4055-85ad-ef75ad6cc29d::978f1fd7-4e24-47d8-adb0-24a8a6eff69e::b5ffd6c2-902f-4658-b586-e3fc170a6cf3::7ad616a350cc48078f17e3ee3df551de
Contact: sip:a@atlanta.example.com
Content-Length: 0

此示例显示了作为查询参数 (由 SIP RFC 3261定义) 传递到 Refer-To 头的元数据。

REFER sip:b@atlanta.example.com SIP/2.0
Via: SIP/2.0/UDP agenta.atlanta.example.com;branch=z9hG4bK2293940223
To: <sip:b@atlanta.example.com>
From: <sip:a@atlanta.example.com>;tag=193402342
Call-ID: 898234234@agenta.atlanta.example.com
CSeq: 23 REFER
Max-Forwards: 70
Refer-To: sip:user@domain.com?User-to-User=637573746f6d2d757365722d746f2d75736572%3Bencoding%3Dhex
Contact: sip:a@atlanta.example.com
Content-Length: 0

如果指定了定制 User-to-User 头，那么会在 X-Watson-Assistant-Session-History-Key 头中设置会话历史记录密钥。

REFER sip:b@atlanta.example.com SIP/2.0
Via: SIP/2.0/UDP agenta.atlanta.example.com;branch=z9hG4bK2293940223
To: <sip:b@atlanta.example.com>
From: <sip:a@atlanta.example.com>;tag=193402342
Call-ID: 898234234@agenta.atlanta.example.com
CSeq: 93809823 REFER
Max-Forwards: 70
Refer-To: sip:user@domain.com?User-to-User=637573746f6d2d757365722d746f2d75736572%3Bencoding%3Dhex&X-Watson-Assistant-Session-History-Key=dev::latest::893499::dff9c274-adc4-4f63-93de-781166760bf8::978f1fd7-4e24-47d8-adb0-24a8a6eff69e::b5ffd6c2-902f-4658-b586-e3fc170a6cf3::7ad616a350cc48078f17e3ee3df551de
Contact: sip:a@atlanta.example.com
Content-Length: 0

对于 Twilio Flex，User-to-User 头使用 encoding=ascii。

command_info.type : collect

指示电话集成收集用户的双音多频信令 (DTMF) 输入。 此命令支持以下参数:

command_info.type : disable_barge_in

禁用 DTMF 干扰，这样当来电者按键时，电话集成的播放就不会中断。 如果启用了 disable_barge_in，那么将忽略回放期间按下的键。

该命令没有参数。

command_info.type : enable_barge_in

启用 DTMF 打断，以便呼叫者可以通过按键中断电话集成中的回放。

该命令没有参数。

command_info.type : send

通过电话集成发送 DTMF 信号。

此命令支持以下参数:

示例

此示例显示了带有 collect 命令的 dtmf 响应类型，用于收集 DTMF 输入。

{
  "generic": [
    {
      "response_type": "dtmf",
      "command_info": {
        "type": "collect",
        "parameters": {
          "termination_key": "#",
          "count": 16,
          "ignore_speech": true
        }
      },
      "channels": [
        {
          "channel": "voice_telephony"
        }
      ]
    }
  ]
}

此示例显示了带有 send 命令的 dtmf 响应类型，用于发送 DTMF 信号。

{
  "generic": [
    {
      "response_type": "dtmf",
      "command_info": {
        "type": "send",
        "parameters": {
          "digits": [
            {
              "code": "9",
              "volume": -8
            },
            {
              "code": "11"
            }
          ],
          "send_interval": 100
        }
      },
      "channels": [
        {
          "channel": "voice_telephony"
        }
      ]
    }
  ]
}

合并和删除定制 CDR 数据

每次由操作定义 cdr_custom_data 对象时，都会将新数据与任何先前存在的数据合并。 为先前定义的属性指定的新值将覆盖先前的值，并且将添加任何新属性; 否则，先前定义的数据将保持不变。

要除去先前定义的属性，必须将其显式设置为空值，如以下示例中所示:

  "context": {
    "integrations": {
      "voice_telephony": {
        "cdr_custom_data": {
          "key1": ""
        }
      }
    }
  }