高级 JSON 配置属性

您可以使用 JSON 配置文件来为个别租户定义特定属性，而不是配置在整个部署中适用的环境变量。

重要信息：多租户配置属性与 Voice Gateway 配置中的 Docker 环境变量相关。如果未在 JSON 配置文件中定义值，那么将按以下部分中所注，使用相关 Docker 环境变量的某些值。

在 V1.0.0.2 和更高版本中支持配置多租户。

• 示例 JSON 配置文件
• 必需租户属性
• 可选租户属性
• conversation 对象属性
• wva 对象属性
• stt 对象属性
  • stt 对象的 credentials 属性
  • Google Cloud Speech API 的 JSON 属性
• tts 对象属性
  • Google Text-to-Speech API 的属性
• reporting 对象属性
  • reporting 对象的 cdrCloudant 属性
  • reporting 对象的 convCloudant 属性
  • reporting 对象的 transcriptionCloudant 属性
• smsPipe 对象属性
• outboundCalls 对象的属性

示例 JSON 配置文件

例如，以下 JSON 将号码为 234-555-6789 的租户配置为发布报告事件的自助服务代理程序，并且配置 myhost.com 主机上未显示其详细信息的号码为 234-555-7890 的另一个租户。

要部署此配置，必须在 Voice Gateway 部署配置文件中将 JSON 配置文件的文件路径设置为 MULTI_TENANT_CONFIG_FILE 环境变量。

  {
    "tenants": [{
        "tenantURI": "2345556789",
            "description": "Voice Gateway Demo US",
            "whitelistFromUri": "8765554321",
            "putCallerOnHoldOnTransfer": "false",
            "conversation": {
                "url": "https://gateway.watsonplatform.net/conversation/api",
                "workspaceID": "a23de67h-e527-40d5-a867-5c0ce9e72d0d",
                "password": "InWtiUpYhF1Z",
                "username": "9h7f54cb-d9ed-46b3-8492-e9a9bf555021"
            },
            "stt": {
                "credentials": {
                    "url": "https://stream.watsonplatform.net/speech-to-text/api",
                    "username": "9h7f54cb-f28f-4a64-91e1-a0657e1dd3f4",
                    "password": "IAB5jfxls0Zt",
                },
                "config": {
                    "model": "en-US_NarrowbandModel",
                    "profanity_filter": true,
                    "smart_formatting": true
                },
                "broadbandConfig": {
                    "model": "en-US_BroadbandModel",
                    "profanity_filter": true,
                    "smart_formatting": true
                },
                "bandPreference": "broadband",
                "confidenceScoreThreshold": 0.2,
                "echoSuppression": true,
                "bargeInResume": true,
                "trackLatency": false
            },
            "tts": {
                "cacheTimeToLive": 336,
                "credentials": {
                    "url": "https://stream.watsonplatform.net/text-to-speech/api",
                    "username": "9h7f54cb-8b0f-4766-8b15-eaa8f7c3fae7",
                    "password": "HcmzFp1kec1P",
                },
                "config": {
                    "voice": "en-US_MichaelVoice"
                }
            },
            "reporting": {
                "url": "http://10.10.10.10:8080",
                "username": "john.smith",
                "password": "HcmzFp1kec1P",
                "cdrEventInd": "cdr",
                "convEventInd": "conv",
                "transcriptionEventInd": "transcription"
            },
            "smsPipe": {
                "url": "http://host:port/sms.gateway/smsPipe",
                "username": "tR3qNZ12-u53qmz93",
                "password": "Qz34x05e",
                "tenantPhoneNumber": "+18765554321"
            },
      "enableOutboundCalls": true,
      "outboundCalls": {
        "statusWebhook": "http://need.example.webhook.url.com/",
        "tenantURI": "same as tenant URI above?",
        "connectTimeout": 3,
        "readTimeout": 5,
        "maxRetyNo": 2        
      },
      "restAPI": {
        "username": "exampleusername",
        "password": "examplepassword"        
      }
    ,
    }
        {
            "tenantURI": "2345557890@example.com"
        }
    ]
}

1. 将租户配置添加到 Voice Gateway 配置，然后部署环境。有关更多信息，请参阅部署多租户 JSON 配置。

重要信息：多租户配置属性与 Voice Gateway 配置中的 Docker 环境变量相关。如果未在配置 JSON 文件中定义值，那么将按以下部分中所注，使用相关 Docker 环境变量的某些值。

返回到开头

必需租户属性

可选租户属性

可以单独为每个租户定义以下配置属性。这些属性是可选属性，但如果要对其进行定义，那么必须将其定义为 JSON 属性。不会使用相关 Docker 环境变量的值。

返回到开头

conversation 对象的属性

必须将要用于每个租户的 IBM Watson™ Assistant 服务定义为 JSON 属性。不会使用相关 Docker 环境变量的值。

与其他配置方法一样，不能在单个租户中同时定义 conversation 对象和 wva 对象。

要配置租户以通过服务编排引擎 (SOE) 来连接到 Watson Assistant，请改为在属性中配置 SOE。如果 SOE 配置为需要认证，请指定用于 HTTP 基本认证的用户名和密码。

返回到开头

wva 对象

注：在 2018 年 6 月 19 日之后，无法创建新的 Watson Virtual Agent 实例。此服务已在 2019 年 3 月 19 日从 IBM Cloud 目录中移除。

必须将要用于每个租户的 Watson Virtual Agent 聊天机器人定义为 JSON 属性。不会使用相关 Docker 环境变量的值。要通过服务编排引擎 (SOE) 来连接到 Virtual Agent，请在 conversation 对象上配置 SOE。

与其他配置方法一样，不能在单个租户中同时定义 conversation 对象和 wva 对象。

返回到开头

stt 对象的属性

stt 对象包含 Speech to Text Adapter 启用的 Speech to Text 服务或语音识别服务的配置。如果未定义 JSON 属性，那么将使用相关 Docker 环境变量的值。

可以定义以下属性来配置 Speech to Text 服务。

返回到开头

stt 对象的 credentials 属性

返回到开头

Speech to Text Adapter 属性

如果使用 Speech to Text Adapter 部署了 Voice Gateway，请改为定义以下属性：

返回到开头

tts 对象的属性

如果未定义 JSON 属性，那么将使用相关 Docker 环境变量的值。

返回到开头

Text to Speech Adapter 的属性

如果部署了 Text to Speech Adapter 与 Voice Gateway，请定义以下属性：

tts 对象的 credentials 属性

返回到开头

reporting 对象的属性

要在租户中启用报告，必须将报告服务器和事件类型定义为 JSON 属性。不会使用相关 Docker 环境变量的值。

返回到开头

reporting 对象的 cdrCloudant 属性

使用 cdrCloudant 属性来配置将呼叫详细记录 (CDR) 轮次事件发布到 IBM Cloudant 数据库。

返回到开头

reporting 对象的 convCloudant 属性

使用 convCloudant 属性来配置将 Watson Assistant 轮次事件发布到 IBM Cloudant 数据库。

返回到开头

reporting 对象的 transcriptionCloudant 属性

使用 transcriptionCloudant 属性来配置将转录事件发布到 IBM Cloudant 数据库。

返回到开头

smsPipe 对象属性

要在呼叫期间启用 SMS 消息传递集成，可以使用有关 SMS Gateway 实例的信息来配置租户。请参阅将 SMS Gateway 与 Voice Gateway 集成。

返回到开头

outboundCalls 对象的属性

要在租户中启用出站呼叫，必须定义出站呼叫 JSON 属性。

返回到开头