电话集成上下文变量

您可以使用上下文变量来管理与通过电话与助手进行交互的客户的对话流。

下表描述了在电话集成上下文中具有特殊含义的上下文变量。它们需要用于列出的目的，而没有其他用途。

对话或操作设置的上下文变量

对话或操作设置的语音上下文变量
名称	Type	描述	缺省
`final_utterance_timeout_count`	编号	电话集成等待从 Speech to Text 服务接收最终话语的时间 (以毫秒计)。如果电话集成在指定的时间限制内未收到最终话语，那么会发生超时，即使继续生成假设也是如此。发生超时时，电话集成会向 watsonx Assistant 发送包含单词 `vgwFinalUtteranceTimeout` 的文本更新，以指示未收到最终话语。	不适用
`post_response_timeout_count`	编号	向调用者回放响应后等待新话语的时间 (以毫秒为单位)。发生此超时时，电话集成通道会向助手发送包含单词 `vgwPostResponseTimeout` 的文本消息，并将上下文变量 `input.integrations.voice_telephony.post_response_timeout_occurred` 设置为 `true`。	7000
`turn_settings.timeout_count`	编号	等待来自 watsonx Assistant的响应的时间 (以毫秒计)。如果超过此时间，那么电话集成将再次尝试联系 watsonx Assistant。如果仍无法访问该服务，那么呼叫将失败。	不适用
`cdr_custom_data`	对象	要在电话呼叫结束时随 CDR 记录一起收集和存储的任何 JSON 键/值对。每次接收此对象时，都会将其与先前接收的任何 `cdr_custom_data` 上下文合并。	不适用

示例

{
  "generic": [
    {
      "response_type": "text",
      "text": "Hello"
    }
  ],
  "context": {
    "integrations": {
      "voice_telephony": {
        "post_response_timeout_count": 10000,
        "turn_settings": {
          "timeout_count": 5000
        },
        "cdr_custom_data": {
          "key1": "value1",
          "key2": "value2"
        }
      }
    }
  }
}

电话通道设置的上下文变量

电话通道设置的上下文变量
名称	Type	描述
`sip_call_id`	字符串	与 watsonx Assistant 会话关联的 SIP 呼叫标识。
`sip_custom_invite_headers`	对象	具有键或值对的 JSON 对象，用于定义从初始 SIP `INVITE` 请求拉取并传递到 watsonx Assistant 服务 (例如，`{"Custom-Header1": "123"}`) 的 SIP 头。
`private.sip_from_uri`	字符串	与 watsonx Assistant 服务关联的 SIP `From` URI。
`private.sip_request_uri`	字符串	已启动交谈会话的 SIP 请求 URI。
`private.sip_to_uri`	字符串	与对话会话关联的 SIP `To` URI。
`private.user_phone_number`	字符串	从中接收呼叫的电话号码。
`assistant_phone_number`	字符串	与接收电话的 watsonx Assistant 端关联的电话号码。

电话通道设置的输入参数

以下输入参数仅对当前对话轮次有效。

电话通道设置的输入参数
名称	Type	描述
`post_response_timeout_occurred`	布尔值	响应后超时是否已到期
`barge_in_occurred`	布尔值	是否发生了驳船
`final_utterance_timeout_occurred`	`true` 或 `false`	Final-utterance 超时是否已到期
`dtmf_collection_succeeded`	布尔值	DTMF 收集是成功还是失败。当 `true` 时，DTMF 收集成功，并返回期望的位数。当 `false` 时，DTMF 集合无法收集指定的位数。即使 `dtmf_collection_succeeded` 为 `false`，所有收集的数字也会传递到轮次请求的输入字符串中的对话框。
`is_dtmf`	布尔值	watsonx Assistant 的输入是否为双音多频信令 (DTMF)。
`speech_to_text_result`	对象	来自 JSON 格式的 Speech to Text 服务的最终响应，包括商机假设和任何替代方法的抄本和置信度分数。该格式与从 Speech to Text 服务接收到的格式完全匹配。 (有关更多信息，请参阅 Speech to Text API 文档。)
`sms_message`	字符串	从呼叫者接收到的 SMS 消息

示例

{
  "input": {
    "text": "agent ",
    "integrations": {
      "voice_telephony": {
        "speech_to_text_result": {
          "result_index": 0,
          "stopTimestamp": "2021-09-29T17:43:31.036Z",
          "transaction_ids": {
            "x-global-transaction-id": "43dd6ce0-139a-4d76-95aa-86e03fcfc434",
            "x-dp-watson-tran-id": "6e60695e-fed7-4efe-a376-0888b027d30f"
          },
          "results": [
            {
              "final": true,
              "alternatives": [
                {
                  "transcript": "agent ",
                  "confidence": 0.78
                }
              ]
            }
          ],
          "transactionID": "43dd6ce0-139a-4d76-95aa-86e03fcfc434",
          "startTimestamp": "2021-09-29T17:43:29.436Z"
        },
        "is_dtmf": false,
        "barge_in_occurred": false
      }
    }
  },
  "context": {
    "skills": {
      "main skill": {
        "user_defined": {},
        "system": {}
      }
    },
    "integrations": {
      "voice_telephony": {
        "private": {
          "sip_to_uri": "sip:watson-conversation@10.10.10.10",
          "sip_from_uri": "sip:10.10.10.11",
          "sip_request_uri": "sip:test@10.10.10.10:5064;transport=tcp"
        },
        "sip_call_id": "QjryZsuAS4",
        "assistant_phone_number": "18882346789"
      }
    }
  }
}