顶顶通呼叫中心中间件(mod_cti基于FreeSWITCH)-配置文件

配置文件

本文档讲解顶顶通呼叫中心中间件相关的几个配置文件。

cti.conf.xml

mod_cti的配置文件,路径是 {conf_dir}/autoload_configs/cti.conf.xml，获取${conf_dir}路径的方法是执行fs控制台命令global_getvar conf_dir ,或者shell执行 fs_cli -x "global_getvar conf_dir",cti.conf.xml修改了需要重启fs才能生效。

<configuration name="cti.conf" description="dingdingtong cti module by www.ddrj.com">
  <global>
    <!-- auth_key:授权文件路径 默认路径fs的conf目录:${conf_dir}/license.json -->
	<param name="auth_key" value="license.json"/>
    <!-- domain:配置一个名字，用于群集时区分多台FreeSWTICH -->
    <param name="domain" value="test"/>
    <!-- json_config_filename：JSON配置文件文字，默认路径fs的conf目录:${conf_dir}/cti.json -->
    <param name="json_config_filename" value="cti.json"/>
    <!-- say_dir 数字、字母声音目录默认 ${sound_prefix}/cn/link, 获取方法 global_getvar sound_prefix -->
    <param name="say_dir" value="cn/link"/>
    <!-- wait_redis_ready 载入cti模块时等待redis连接成功 -->
    <param name="wait_redis_ready" value="true"/>
    <!-- httpfile_cache_thread tts声音缓存线程个数, 这个配置要和tts的并发一样。预先TTS时，最多同时多少个线程调用TTS -->
    <param name="httpfile_cache_thread" value="2"/>
    <!-- 噪音人声识别模型目录 -->
    <param name="sad_model_dir" value="sadmodel"/>
  </global>

  <http_cli>
  	<!-- callback用的回调地址，不适用callback接口不要配置这个 -->
	  <param name="http_server_domain" value="mydomain.com"/>
	  <!-- http_server_ip：http_cli接口绑定的IP，如果要外网访问http_cli接口要改成0.0.0.0-->
	  <param name="http_server_ip" value="127.0.0.1"/>
	  <!-- http_server_port：http_cli接口绑定端口 -->
	  <param name="http_server_port" value="88"/>
	  <!-- http_api_cli_key：http_cli接口的KEY -->
	  <param name="http_api_cli_key" value=""/>	  
 </http_cli>

  <robot>
  	<!-- robot_flow_path 话术目录 默认${conf_dir}/robot -->
	  <param name="robot_flow_path" value=""/>
 </robot>
 
  <autodialer>
  	<!-- calls_per_second：队列外呼和定时外呼一秒最大发起呼叫的次数 -->
	  <param name="calls_per_second" value="300"/>
 </autodialer>
	
</configuration>

cti.json

cti.json是cti模块动态生效的配置，路径是${conf_dir}/cti.json,获取${conf_dir}路径的方法是执行fs控制台命令global_getvar conf_dir ,或者shell执行 fs_cli -x "global_getvar conf_dir",cti.json修改了会自动生效。修改后fs_cli控制台会输出一个 “[NOTICE] mod_cti.c:4117 dd_config_refresh succeed JSON configuration file updated”日志，如果修改后的json文件格式错误会输出“[WARNING] mod_cti.c:4114 dd_config_refresh failed JSON configuration file format error”这个日志,可以用json文件格式化工具( http://tools.jb51.net/code/jsonformat )，看看文件格式那里错了。

/*修改后，可以用 http://tools.jb51.net/code/jsonformat 这个工具检查JOSN是否存在错误。*/
{
    "redis": {
        //"master-name": "mymaster",    //如果使用哨兵模式，才需要配置。sentinel配置的master-name
        //"addrs": [ "192.168.1.10:6379", "192.168.1.10:6379" ],  //多个sentinel地址，如果配置了addrs,会忽略ip和port配置。
        "ip": "127.0.0.1", //redisIP
        "port": 6379, //redis端口
        "password": "", //redis密码
        "db":0, //使用哪个db
        "pinglog":false //是否输出ping日志
    },
    "api":
    {
        "key":"", // 密码必须包含数字字母特殊符号，http接口调用key参数，防止非法调用,这个配置的优先级高于cti.conf.xml配置项http_api_cli_key
        "acl":"",//那些IP可以调用httpA接口，防止非法调用,不设置就使用cti.conf.xml的配置。acl格式支持ip/掩码这样的格式，例如 192.168.1.1/32,192.168.0.0/24。这个配置的优先级高于cti.conf.xml配置项http_api_cli_acl
        "log":false //是否打开http接口调用日志
    },
    "gui": {

        /*分机注册信息推送到redis,:disable去除生效*/
        "registration:disable": {
            "hash": "registrations", //记录到hash表
            "channel": "", //推送到channel
            "list": "" //记录到list
        },
        /*通道信息推送到redis，:disable去除生效*/
        "channel:disable": {
            "hash": "channels",
            "channel": "",
            "list": ""
        },
        /*网关信息推送到redis，:disable去除生效*/
        "gateway:disable": {
            "hash": "gateways",
            "channel": "",
            "list": ""
        },
        /*分机呼叫信息推送到redis，:disable去除生效*/
        "call:disable": {
            /*呼叫信息需要记录的变量*/
            "fields": [ "Caller-Destination-Number", "Caller-Caller-ID-Number", "Caller-Callee-ID-Number", "Caller-Profile-Created-Time", "Caller-Profile-Created-Time", "Caller-Channel-Answered-Time", "Caller-Channel-Hangup-Time", "Caller-Channel-Progress-Time", "Caller-Channel-Progress-Media-Time", "Answer-State", "variable_signal_bond" ],
            "hash": "calls",
            "remove_hangup":false,//通话结束是否从hash表删除记录。
            "channel": "",
            "list": "",
        },
        "disable_monitor":false, //是否禁用记录注册信息和通道信息，禁用后上面的推送配置全部无效。
        "kill_block": false, //自动挂断挂起的通道
        "multi_reg": false, //是否允许多点注册，开启多点注册的方法，请看允许多点注册的文档
        "dialplan_cacheable": 60000, //拨号方案缓存时间，单位毫秒,测试环境可以改成0，不缓存。生产环境建议设置60000以上。
        "allow_xml_config": false, //REDIS找不到配置时是否继续使用XML配置
        "monitor_log":false,//输出通道监视日志
        "monitor_thread":4,//把分机和通道信息记录到redis，开启多少个处理线程。
        "log": false //gui接口是是否输出调试日志
    },
    "cdr": {
        /*是否忽略通话记录*/
        //1 no_progress 没回铃音(180或者183)的都忽略
        //2 no_answer 没接通(200)的都忽略，也包含1
        "ignore_cdr":0,

         /*去除这几个可能包含号码的字段，channel account destination_number caller_id_number callee_id_number*/
        "hidenumber":false,
        /*details:生产环境的时候设置为flase,details信息很长*/
        "details": false,
        /*cti_progress_time，cti_progress_media_time，cti_bridged_time，cti_transferred_time，created_time，hungup_time，answered_time 这些时间字段是否带上毫秒的（0000-00-00 00:00:00.000）这样的格式。*/
        "enable_msec":true,

        /*fields需要记录到cdr表的自定义变量，number:开始的表示使用数字格式。如果变量名和数据库字段名字不一样，可以”字段名:变量名”这样。*/
        "fields": [ "rtp_last_audio_codec_string", "number:billsec", "number:duration", "record_filename", "call_source", "source_name", "source_number", "dial_number:cti_dial_number", "originator", "bridge_uuid", "organization"],
        /*如果需要把cdr信息推送到到redis的list或者channels，list配置redis list的名字,channels配置redis cahnnels的名字*/
        "redis": {
            "channel": "",
            "list": ""
        },
        /*如果需要把cdr记录到数据库,需要配置table, 机器人交互记录，也使用这个配置*/
        "database": {
            /*dbtype 数据库类型 比如mysql ,sqlserver*/
            "dbtype": "mysql",
            /*mysql例子：127.0.0.1,3306@dbname sqlserevr例子：tcp:127.0.0.1,1433@dbname*/
            "connectionstring": "127.0.0.1,3306@cti",
            "username": "root",
            "password": "",
            /*mariadb5默认是utf8,mariadb10要改成utf8mb3,大模型对话返回的文字可能包含emjoi,需要设置成utf8mb4*/
            //"characterset":"utf8mb3",
            /*cdr表名*/
            "table": "cdr",
            /*是否启用CDR实时模式，实时模式创建通道的时候插入记录，通话状态变化更新记录，非实时模式通话挂断才记录到CDR*/
            "real": false,
            /*自动提交，如果需要使用事务批量提交，请设置false,批量提交会锁表，稳定性有待测试*/
            "autocommit": true,
            /*fs挂了自动恢复通话记录，需要打开了通道变量信息记录到hash才有效*/
            "recover":true

        },

        /*cdr记录写入到数据库推送通知[推送内容为表名和UUID]，:disable去了，才使用这个配置*/
        "notify:disable": {
            "redis": {
                "channel": "", //推送到redis的channel
                "list": "" //记录到redis的list
            },
            "http": {
                "url": "http://127.0.0.1/notify" //推送到url接口
            }
        },
        /*cdr入库通知(notify)包含的通道变量*/
        "notify_fields:disable": [  ],

        "log": false //是否输出cdr调试日志
    },
    "scheduledialer": {
        "log": false //是否输出定时外呼调试日志
    },
    "queuedialer": {
        "http": {
            "usecurl": false, //默认使用顶顶通实现的http库，修改成true,使用curl库执行http请求
            "connecttimeout": 3000, //连接超时 
            "responsetimeout": 10000 //等待响应超时 
        },
        "idle_cpu": 10, //空闲CPU低于这个值，就暂停呼叫
        "loadavg": 1.5, //如果最近1分钟的系统负载大于1.5就暂停呼叫,
        "log": false //是否输出队列外呼调试日志
    },

    "robot": {
        /*机器人对话的执行流程记录*/
        "record": {
            /*input_start_time是否包含毫秒*/
            "enable_msec": true,
            /*NLP_INPUT_DESTORY时从哪个变量获取完整的通话录音路径*/
            "record_filename_variable":"",
            /*是否记录response_args*/
            "record_response_args":false,
             /*通知包含的通道变量*/
            "notify_fields:disable": [ "caller_id_name", "destination_number", "call_source", "source_name", "cti_dial_number" ],
            /*机器人交互记录是否推送到redis的channel和list*/
            "redis": {
                "channel": "",
                "list": "",
            },
            "database": {
                /*机器人的交换记录插入数据库的那个表*/
                "table": "conversation",
            },
            "log": false //是否把推送redis的JSON和SQL记录到日志。
        },
        /*机器人对话交互的统计数据*/
        "statistic":
        {
            /*是否推送到redis的channel和list*/
            "redis": {
                "channel": "",
                "list": ""
            },
            "database": {
                /*插入数据库的那个表*/
                "table":"classify"
            },
            /*是否记录notify_field设置的变量到数据库*/
            "record_notify_variables":true,
            "log": false //是否输出到redis的JSON和SQL到日志。
        },
        "nlp": {
            "debug": false //是否输出机器人引擎调试日志，比如要输出正则表达式匹配过程，可以设置为true
        },
        "largemodel": {
            "usecurl": true,
            "connecttimeout": 3000,
            "responsetimeout": 10000,
            "temperature ":null,//采样温度，控制模型生成文本的多样性。temperature越高，生成的文本更多样，反之，生成的文本更确定。取值范围： [0, 2)。由于temperature与top_p均可以控制生成文本的多样性，因此建议您只设置其中一个值。
            "top_p":null,//核采样的概率阈值，控制模型生成文本的多样性。top_p越高，生成的文本更多样。反之，生成的文本更确定。取值范围：（0,1.0] 。由于temperature与top_p均可以控制生成文本的多样性，因此建议您只设置其中一个值。
            "presence_penalty ":null,//控制模型生成文本时的内容重复度。取值范围：[-2.0, 2.0]。正数会减少重复度，负数会增加重复度。
            "enable_search ":false,//模型在生成文本时是否使用互联网搜索结果进行参考。
        },
        "httpflow": {
            "usecurl": false, //默认使用顶顶通实现的http库，修改成true,使用curl库执行http请求
            "retries": 2, //http请求失败时重试次数
            "connecttimeout": 3000, //连接超时 
            "responsetimeout": 10000 //等待响应超时 
        },
        "event_after_hangup":true  // 挂断之后是否继续处理事件，如果不开启 用户说话之后没等ASR识别完成就挂机，会丢失识别结果，开启后会有complete事件参数HANGUP(F说话内容)。
    },

    "acd": {
        "state_write_redis": false, /*是否把状态写入redis*/
        /*排队模块推送记录到http接口配置，:disable去了，才使用这个配置*/
        "notify:disable": {
            "variables": [ "caller_id_name", "destination_number" ],
            "redis": {
                "channel": "", //推送到redis的channel
                "list": "" //记录到redis的list
            },
            "http:disable": {
                "url": "http://127.0.0.1/popup" //推送到url接口
            },
            "log": false
        }
    },

    /*sounds_dir redis保存的声音文件同步到本地的目录默认/fs/share/freeswitch/sounds/cti*/
    "sounds_dir": "cti",
    "sounds_table_prefix": "", //声音记录表名前缀

    "fail2ban": {
        "password_minimum":6,      //默认密码最小6位
        "password_strength": 3,    //0:没要求 1:必须包含数字、小写字母、大写字母、特殊符号中的1种以上，2:必须包含2种以上 3(默认值):必须包含3种以上，4:必须4种都包含。

        /*注册失败后cti封堵策略*/
        "register_failure":[
            {
                "findtime":60,   //分析最近多少秒的失败记录
                "maxretry":3,    //鉴权最大失败次数，超过就封堵这个IP或者账户
                "banmode":1,     //封堵方式 0: 根据IP封堵，1:分机和IP都一样才封堵，可以避免只要一个分机错了密码，就直接把这个IP封堵了。
                "bantime":180     //封堵时间单位秒，默认180秒
            }
        ],

        "filename": "cti_fail2ban.log", //认证失败和非法呼叫日志
        "destination_number_max_len": 0, //被叫号码最大长度
        "deny_prefix": [], //禁止呼入前缀
        "allow_prefix": [], //允许呼入前缀，不配置时允许任意号码
        "logfilter": {
            //"sofia.c": [ "IP (.*) Rejected by acl \"(.*)\"","IP/Port (.*) \\d+ Rejected by acls and (.*) flag is set" ] //acl拒绝写入fail2ban,日志关闭了debug,info,notice 才可以开启这个
        }
    }

}

asrproxy.json

asrproxy.json是asr和tts的配置文件，路径在 asrproxy程序安装目录。 新加ASR配置会自动生效(1分钟之内),已经存在的修改type,engine,appid,key,secret 不会生效，如果要修改这几个参数只能新添加一个ASR配置或者重启asrproxy程序，其他参数修改后自动生效。

/*asrproxy启动不了，一般都是JSON格式不对，可以用 http://tools.jb51.net/code/jsonformat 这个工具检查JOSN是否存在错误。*/
{
    "key":"asrproxy.license",  //授权文件路径

    "log":{
        "console_level":0, //输出控制台日志等级0-5(0:DEBUG, 1:INFO, 2:NOTICE, 3:WARNING, 4:CRIT, 5:CONSOLE)
        "file_level":0,    //输出到文件日志等级0-5(0:DEBUG, 1:INFO, 2:NOTICE, 3:WARNING, 4:CRIT, 5:CONSOLE)
        "file_maxsize":100, //文件大于多少M就自动创建新的日志文件。
        "file_number":10 //最大保留日志文件个数
    },

    "asr":{

        "listen_ip":"127.0.0.1",
        "listen_port":9988,
        "storage":"record", //asr录音目录，调用asr时，设置了asr_params.recordfilename才会录音。
        "acl":"*", //哪些IP可以访问，配置*任意IP都可以访问，多个IP用逗号隔开，如果不配置acl，通过127.0.0.1不需要配置在ACL里面也可以访问。

        "interface": {

            /*FunASR*/
            /*
            "paraformer_realtime_16K": { 
                    "type": "funasr", 
                    "engine": "2pass", 
                    "quantize": true, 
                    "enable_itn": true, 
                    "itn-dir": "/ddt/asrproxy/funasr/fst_itn_zh", 
                    "vad-dir": "/ddt/asrproxy/funasr/speech_fsmn_vad_zh-cn-16k-common-onnx", 
                    "vad-quant": true, 
                    "punc-dir": "/ddt/asrproxy/funasr/punc_ct-transformer_zh-cn-common-vad_realtime-vocab272727-onnx", 
                    "model-dir": "/ddt/asrproxy/funasr/speech_paraformer-large_asr_nat-zh-cn-16k-common-vocab8404-onnx", 
                    "online-model-dir": "/ddt/asrproxy/funasr/speech_paraformer-large_asr_nat-zh-cn-16k-common-vocab8404-online-onnx", 
                    "lm-dir": "", 
                    "hotword": "", 
                    "chunk-size": 800
            },
            */

            /*阿里云私有云asr配置例子*/
            /*
            "aliyun_test": {
                "count": 0,
                "fault_threshold": 0,
                "fault_try_interval": 600,
                "type": "aliyun",
                "engine": "transcriber", //transcriber:流接口，recognizer:一句话接口 
                "appid": "default",
                "key": "default",
                "token": "default",
                "url": "ws://ip:8101/ws/v1",
                "secret": "default",
                "enable_intermediate_result": true,
                "enable_punctuation_prediction": false,
                "enable_inverse_text_normalization": false,
                "enable_semantic_sentence_detection": false
            },
            */

            /*阿里云实时语音识别配置例子 ，参数说明看https://help.aliyun.com/zh/isi/developer-reference/api-reference */
            /*
            "aliyun_01": {
                "count": 0, //最大多少并发
                "fault_threshold": 0, //连续错误多少次停用
                "fault_try_interval": 600, //停用多久后，从新尝试用这个KEY
                "type": "aliyun", //识别引擎，通过配置指定调用的ASR类型
                "engine": "transcriber", //transcriber:流接口，recognizer:一句话接口 
                "appid": "", //项目ID，详细看开通说明 https://help.aliyun.com/document_detail/71936.html
                "key": "", //AccessKey ID 详细看 https://help.aliyun.com/document_detail/324194.html 
                "secret": "", //AccessKey Secret 详细看 https://help.aliyun.com/document_detail/69835.htm?spm=a2c4g.11186623.0.0.2f773f87BMksCK#section-iqi-ojp-tqk 
                "enable_intermediate_result": true, //设置是否返回中间识别结果
                "enable_punctuation_prediction": false, //设置是否在后处理中添加标点
                "enable_inverse_text_normalization": false, //设置是否在后处理中执行数字转换
                "enable_semantic_sentence_detection": false, //设置是否使用语义断句。
                "customization_id": "", //设置定制模型
                "vocabulary_id": "", //设置泛热词
                "enable_ignore_sentencetimeout": true, //是否忽略实时识别中的单句识别超时, 默认是False
                "disfluency": true, //是否对识别文本进行顺滑(去除语气词,重复说等), 默认是False
                "speech_noise_threshold": 0.1, //噪音参数阈值，参数范围:[-1,1]取值越趋于-1:噪音被判定为语音的概率越大,取值越趋于+1:语音被判定为噪音的概率越大,该参数属高级参数, 调整需慎重并重点测试
                "enable_sdk_log": false
            },
            */

            /*阿里云一句话识别配置例子 ，参数说明看 https://help.aliyun.com/zh/isi/developer-reference/restful-api-2 */
            /*
            "aliyun_02": {
                "count": 0,
                "fault_threshold": 0,
                "fault_try_interval": 600,
                "type": "aliyun",
                "engine": "recognizer", //transcriber:流接口，recognizer:一句话接口 
                "appid": "",
                "key": "",
                "secret": "",
                "enable_intermediate_result": true,
                "enable_punctuation_prediction": false,
                "enable_inverse_text_normalization": false,
                "enable_voice_detection": true //设置是否启动自定义静音检测
            },
            */




            /*阿里云国际站 开通说明 https://www.alibabacloud.com/help/zh/isi/getting-started/start-here 接口文档看 https://www.alibabacloud.com/help/zh/isi/developer-reference/api-reference */
            /*
            "aliyun_international": {
                "count": 0, //最大多少并发
                "fault_threshold": 0, //连续错误多少次停用
                "fault_try_interval": 600, //停用多久后，从新尝试用这个KEY
                "type": "aliyun", //识别引擎，通过配置指定调用的ASR类型
                "engine": "transcriber", //transcriber:流接口，recognizer:一句话接口 
                "appid": "", //项目APPKEY，详细看开通说明 https://www.alibabacloud.com/help/zh/isi/getting-started/manage-projects
                "key": "", //AccessKey ID 看secret的说明
                "secret": "", //AccessKey Secret  需要给予智能语音交换的权限  详细看 https://www.alibabacloud.com/help/zh/isi/activate-intelligent-speech-interaction-1
                "url":"wss://nls-gateway-ap-southeast-1.aliyuncs.com/ws/v1", // 接口地址详细看 https://www.alibabacloud.com/help/zh/isi/developer-reference/api-reference
                "tokenurl":"http://nlsmeta.ap-southeast-1.aliyuncs.com",  // tokenurl、regionid、version 这3个参数 国际站才需要配置 具体看 https://www.alibabacloud.com/help/zh/isi/getting-started/use-http-or-https-to-obtain-an-access-token
                "regionid":"ap-southeast-1",
                "version":"2019-02-28",
                "enable_intermediate_result": true, //设置是否返回中间识别结果
                "enable_punctuation_prediction": false, //设置是否在后处理中添加标点
                "enable_inverse_text_normalization": false, //设置是否在后处理中执行数字转换
                "enable_semantic_sentence_detection": false, //设置是否使用语义断句。
                "customization_id": "", //设置定制模型
                "vocabulary_id": "", //设置泛热词
                "enable_ignore_sentencetimeout": true, //是否忽略实时识别中的单句识别超时, 默认是False
                "disfluency": true, //是否对识别文本进行顺滑(去除语气词,重复说等), 默认是False
                "speech_noise_threshold": 0.1, //噪音参数阈值，参数范围:[-1,1]取值越趋于-1:噪音被判定为语音的概率越大,取值越趋于+1:语音被判定为噪音的概率越大,该参数属高级参数, 调整需慎重并重点测试
                "enable_sdk_log": false
            },
            */

            //讯飞语音听写接口，开通地址 https://www.xfyun.cn/services/voicedictation ，如果需要启用抢话功能，需要开通 "动态修正"
            /*
            "xfyun_0": {
                "count": 0,
                "fault_threshold": 0,
                "fault_try_interval": 600,
                "connect_timeout":3000,   //建立ws连接最大等待时间
                "accent" : "mandarin",   //方言，这几个参数的说明看接口文档 https://www.xfyun.cn/doc/asr/voicedictation/API.htm
                "domain" : "iat",	//应用领域
                "language" : "zh_cn", //语种
                "dwa" : "wpgs", //动态修正
                "pd" : "", //领域个性化参数
                "rlang" : "zh-cn", //繁体简体
                "ptt" : 1, //是否开启标点符号添加
                "nunum" : 1, //将返回结果的数字格式规则为阿拉伯数字格式
                "type": "xfyun",		//xfyun 标识这个配置试用讯飞云ASR引擎
                "appid": "",			//APPID
                "key": "", //APIKey
                "secret": "" //APISecret
            },
            */


            /*
             //讯飞大模型识别接口，地址 https://www.xfyun.cn/doc/spark/spark_zh_iat.html
            "xfyun_bigmodel": {
                "count": 0,
                "fault_threshold": 0,
                "fault_try_interval": 600,
                "connect_timeout": 3000, //建立ws连接最大等待时间
                "accent": "mandarin", //方言，这几个参数的说明看接口文档 https://www.xfyun.cn/doc/asr/voicedictation/API.htm
                "domain": "slm", //大模型识别，必须配置为 slm
                "language": "zh_cn", //中文、中文方言、英文设置为zh_cn, 其他国家语种设置为mul_cn，支持语种请看 https://www.xfyun.cn/doc/spark/spark_mul_cn_iat.html#%E4%B8%83%E3%80%81%E8%AF%AD%E7%A7%8D%E5%88%97%E8%A1%A8
                "dwa": "wpgs", //动态修正 仅中文支持
                "type": "xfyun", //xfyun 标识这个配置试用讯飞云ASR引擎
                "appid": "", //APPID
                "key": "", //APIKey
                "secret": "" //APISecret
            },
            */

            /*
            "xfyun_1": {
                "count": 0,
                "fault_threshold": 0,
                "fault_try_interval": 600,
                "type": "xfyun",
                "url": "ws://ip:1078/iat", //私有云地址，公有云默认地址ws://iat-api.xfyun.cn/v2/iat，可以不配置。
                "appid": "",				
                "key": "",	
                "secret": ""	
            },
            */

	    /*
            "mrcp": {
                "count": 0,
                "fault_threshold": 0,
                "fault_try_interval": 600,
                "type": "mrcp",
                "engine": "uni2",
                "grammar": "",
                "appid": "",
                "key": "",
                "secret": ""
            },
            */

            //实时语音识别(websocket)https://cloud.tencent.com/document/product/1093/48982
            /*
            "tencent": {
                "count": 0,
                "fault_threshold": 0,
                "fault_try_interval": 600,
                "type": "tencent",
                "engine": "8k_zh",  //对应文档 engine_model_type 参数说明
                "needvad":"1",
                "filter_dirty":"0",
                "filter_modal":"0",
                "filter_punc":"0",
                "convert_num_mode":"1",
                "noise_threshold":"0",
                "hotword_id":"",
                "customization_id":"",
                "emotion_recognition":"0",
                "appid": "",  
                "key": "",   //SecretID
                "secret": "" //SecretKey 
            },
            */
   
            //获取取帐号名、帐号ID、用户名、用户ID、项目名称、项目ID 方法看这里 https://support.huaweicloud.com/api-iam/iam_17_0002.html 
            //区域 列表 https://developer.huaweicloud.com/endpoint?IAM
            //可用终端节点 https://support.huaweicloud.com/api-sis/sis_03_0004.html 写这个说明的时以下节点可用
            //华北-北京一 cn-north-1， 华北-北京四 cn-north-4， 华东-上海一 cn-east-3
            //账户信息 请看 https://support.huaweicloud.com/api-sis/sis_03_0058.html Token认证的描述
            /*
            "huawei": {
                "type": "huawei",
                "projectname": "", //项目名字实际含义是项目节点 我的凭证处获取，如果没有项目先创建项目
                "projectid": "", //项目ID 我的凭证处获取
                "add_punc": true, //表示是否在识别结果中添加标点
                "digit_norm": true, //表示是否将语音中的数字识别为阿拉伯数字
                "interim_results": true, //是否输出中间结果
                "vocabulary_id": "", //热词表id 创建方法看 https://support.huaweicloud.com/api-sis/sis_03_0071.html
                "engine": "short-audio", //short-audio:一句话接口  https://support.huaweicloud.com/api-sis/sis_03_0095.html
                "key": "", //Access Key Id 我的凭证(访问密钥)处创建
                "secret": "" //Secret Access Key 创建访问密钥时下载获取
            },
            */

            /* 多方ASR */
            /*
            "duofang": {
                "type": "duofang",
                "appid": "",
                "key": "",
                "secret": "",
                "im":true,      //中间结果是否返回
                "itn":true,    //是否开启文本规整
                "pct":true      //是否添加标点
            },
            */

            //思必驰语音识别 接口文档 https://help.talkinggenie.com/#/websocket_asr_vad
            /*
            "aispeech": {
                "type": "talkinggenie",
                "appid": "", //PID 产品ID
                "key": "", //PublicKey 说明文档 https://help.talkinggenie.com/#/api
                "secret": "" //SecretKey
            },
            */



            //百炼Paraformer https://help.aliyun.com/zh/model-studio/developer-reference/websocket-for-paraformer-real-time-service
            /*
            "dashscope":
            {
                "engine":"paraformer-realtime-8k-v2", //模型名称："paraformer-realtime-v2"，支持的模型请参考API详情
                "vocabulary_id":"",//热词ID
                "disfluency_removal_enabled":false, //过滤语气词，默认关闭。
                "language_hints":"",  //指定识别语音中语言的代码列表。zh,yue,en,ja,ko 如果不填写则模型会自动识别语种。
                "semantic_punctuation_enabled":false, //是否开启语义断句，服务默认开启语义断句，如果关闭则使用VAD (Voice Activity Detection)断句。
                "inverse_text_normalization_enabled":true, //是否开启ITN（逆文本，Inverse Text Normalization），开启后（设置为True）中文数字会转换为阿拉伯数字。
                "type": "dashscope",
                "key":"",  //获取APIKEY 请看 https://help.aliyun.com/zh/model-studio/developer-reference/get-api-key
            },
            */


             //AppID/Token 请看https://www.volcengine.com/docs/6561/196768#q1%EF%BC%9A%E5%93%AA%E9%87%8C%E5%8F%AF%E4%BB%A5%E8%8E%B7%E5%8F%96%E5%88%B0%E4%BB%A5%E4%B8%8B%E5%8F%82%E6%95%B0appid%EF%BC%8Ccluster%EF%BC%8Ctoken%EF%BC%8Cauthorization-type%EF%BC%8Csecret-key-%EF%BC%9F
            //火山引擎ASR https://www.volcengine.com/docs/6561/196768
            //一句话识别和流识别主要是计费方式不一样,一句话最大说话时间是60秒，流识别和大模型识别没限制。
            "Bytedance": {
                "count": 0,
                "fault_threshold": 0,
                "fault_try_interval": 600,
                //大模型(双向流式模式):bigmodel 大模型(流式输入模式):bigmodel_nostream 大模型(双向流式模式（优化版本）):bigmodel_async  接口文档 https://www.volcengine.com/docs/6561/1354869
                //一句话:volcengine_input_common 流识别:volcengine_streaming_common  非普通话识别: 设置为火山引擎后台的"Cluster ID" 接口文档  https://www.volcengine.com/docs/6561/80816
                "engine":"bigmodel_async",
                "language":"",//指定可识别的语言 只有bigmodel_nostream支持
                "enable_nonstream":true,//开启二遍识别,只有bigmodel_async支持
                "enable_itn":true,  //启用itn。文本规范化 (ITN) 是自动语音识别 (ASR) 后处理管道的一部分。 ITN 的任务是将 ASR 模型的原始语音输出转换为书面形式，以提高文本的可读性。
                "enable_punc":true, //启用标点
                "enable_ddc":false, //启用顺滑。*语义顺滑**‌是一种技术，旨在提高自动语音识别（ASR）结果的文本可读性和流畅性。这项技术通过删除或修改ASR结果中的不流畅部分，如停顿词、语气词、语义重复词等，使得文本更加易于阅读和理解。
                "boosting_table_name":"", //热词词表名称
                "boosting_table_id":"", //热词词表id，大模型识别才有这个配置
                "type": "bytedance",
                "appid": "",
                "token": ""
            },


             
             /*
            "asr配置名字：新加ASR配置会自动生效(1分钟之内)": {
                "说明": "已经存在的修改type,engine,appid,key,secret 不会生效，如果要修改这几个参数只能新添加一个ASR配置或者重启asrproxy程序，其他参数修改后自动生效"
            }
            */
        },
        "groups":{
            //默认使用的ASR
            "default":{ 
                "mode":0,  //0:顺序使用，当使用数量等于count的时候切换下一个  1:循环使用
                "enable": //启用的那些ASR配置
                [
                    "改成要使用的ASR配置"
                ]
            },
            

            //自定义组，可以话术中指定使用那组ASR配置。
            "custom":{
                "mode":0,
                "enable":[
     
                ]
            }
        }
    },
    "tts":{
        "disable_caching":false,//是否禁用缓存
        "storage": "tts", //tts缓存目录
        "append_silence": 20, //tts后的声音文件前后追加静音
        "trim_threshold_volume": 50, //tts后的声音文件前后小于多少音量认为是静音去除
        "listen_ip":"127.0.0.1",
        "listen_port": 9989,
        "bgtts_thread_count":10,

        "interface":{

            //阿里云智能语音平台 不支持复刻 不支持流式合成  [如果需要websocekt流式合成，需要阿里云平台开通流式合成权限]  接口文档 https://help.aliyun.com/zh/isi/developer-reference/speech-synthesis-1
            //接口文档 https://help.aliyun.com/zh/isi/developer-reference/streaming-text-tts-wss 和 https://help.aliyun.com/zh/isi/developer-reference/restful-api-3
            //发音人列表 https://help.aliyun.com/zh/isi/developer-reference/overview-of-speech-synthesis#5186fe1abb7ag
             /*
            "aliyun":{
                "count": 0, //最大多少并发
                "fault_threshold": 0, //连续错误多少次停用
                "fault_try_interval": 600, //停用多久后，从新尝试用这个KEY
                "connect_timeout": 3000, //建立ws连接最大等待时间
                "response_timeout": 60000, //等待tts返回的最大时间
                "type":"aliyun",
                "appid":"",  //项目appkey。详细看开通说明 https://www.alibabacloud.com/help/zh/isi/getting-started/manage-projects
                "key":"", //AccessKey ID 看secret的说明
                "secret":"" //AccessKey Secret 需要给予智能语音交换的权限  详细看 https://www.alibabacloud.com/help/zh/isi/activate-intelligent-speech-interaction-1  
            },
            */


            //实时语音合成-sambert 不支持复刻 不支持流式合成  说明 https://help.aliyun.com/zh/model-studio/text-to-speech 
            //接口文档 https://help.aliyun.com/zh/model-studio/sambert-websocket-api
            //音色列表 https://help.aliyun.com/zh/model-studio/sambert-websocket-api#2326ff6f85gpd
            /*
            "dashscope-sambert":
            {
                "engine":"sambert", 
                "type": "dashscope",
                "key":"",  //获取APIKEY 请看 https://help.aliyun.com/zh/model-studio/developer-reference/get-api-key
            },
            */


            //实时语音合成-CosyVoice 支持复刻 支持流式合成  说明:https://help.aliyun.com/zh/model-studio/text-to-speech
            //音色列表:https://help.aliyun.com/zh/model-studio/cosyvoice-voice-list
            //接口文档:https://help.aliyun.com/zh/model-studio/cosyvoice-websocket-api
            //复刻说明:https://help.aliyun.com/zh/model-studio/cosyvoice-clone-api
            "dashscope-cosyvoice":
            {
                "engine":"cosyvoice-v3-plus",  //支持 cosyvoice-v3-plus、cosyvoice-v3-flash、cosyvoice-v2、cosyvoice-v1
                "language_hints":"zh",
                "instruction":"",
                "type": "dashscope",
                "key":"", //获取APIKEY 请看 https://help.aliyun.com/zh/model-studio/developer-reference/get-api-key
            },


            //通义千问实时语音合成 支持复刻 支持流式合成  说明:https://help.aliyun.com/zh/model-studio/qwen-tts-realtime
            //音色列表 https://help.aliyun.com/zh/model-studio/qwen-tts-realtime#422789c49bqqx
            //复刻说明:https://help.aliyun.com/zh/model-studio/qwen-tts-voice-cloning
            /*
            "dashscope-qwen3-tts":
            {
                "engine":"qwen3-tts-flash-realtime-2025-11-27", //请使用qwen3-tts-flash-realtime系列模型，不支持qwen-tts-realtime，复刻使用 qwen3-tts-vc-realtime-2025-11-27
                "language_type":"Chinese",
                "type": "dashscope",
                "key":"", //获取APIKEY 请看 https://help.aliyun.com/zh/model-studio/developer-reference/get-api-key
            },
            */





            /*阿里云国际站 开通说明 https://www.alibabacloud.com/help/zh/isi/getting-started/start-here 接口文档 https://www.alibabacloud.com/help/zh/isi/developer-reference/overview-of-speech-synthesis */
            /*
            "aliyun_international": {
                "count": 0, //最大多少并发
                "fault_threshold": 0, //连续错误多少次停用
                "fault_try_interval": 600, //停用多久后，从新尝试用这个KEY
                "type": "aliyun", //TTS引擎，通过配置指定调用的TTS类型
                "appid": "", //项目APPKEY，详细看开通说明 https://www.alibabacloud.com/help/zh/isi/getting-started/manage-projects
                "key": "", //AccessKey ID 看secret的说明
                "secret": "", //AccessKey Secret 需要给予智能语音交换的权限  详细看 https://www.alibabacloud.com/help/zh/isi/activate-intelligent-speech-interaction-1  
                "url":"http://nls-gateway-ap-southeast-1.aliyuncs.com/stream/v1/tts", // 接口地址详细看 https://www.alibabacloud.com/help/zh/isi/developer-reference/restful-api-3
                "tokenurl":"http://nlsmeta.ap-southeast-1.aliyuncs.com",  // tokenurl、regionid、version 这3个参数 国际站才需要配置 具体看 https://www.alibabacloud.com/help/zh/isi/getting-started/use-http-or-https-to-obtain-an-access-token
                "regionid":"ap-southeast-1",
                "version":"2019-02-28"
            },
            */
            /*
            豆包大模型TTS配置
            接口文档：https://www.volcengine.com/docs/6561/1329505
            音色列表 ：https://www.volcengine.com/docs/6561/1257544
            */
            /*
            "bytedance_largemodel":{

                "count": 0, //最大多少并发
                "fault_threshold": 0, //连续错误多少次停用
                "fault_try_interval": 600, //停用多久后，从新尝试用这个KEY
                "connect_timeout": 3000, //建立ws连接最大等待时间
                "response_timeout": 60000, //等待tts返回的最大时间
                "engine":"largemodel",//豆包大模型TTS
                /*
                resource_id:表示调用服务的资源信息 ID
                    豆包语音合成模型1.0：
                    seed-tts-1.0 或者 volc.service_type.10029（字符版）
                    seed-tts-1.0-concurr 或者 volc.service_type.10048（并发版）
                豆包语音合成模型2.0:
                    seed-tts-2.0 (字符版)
                声音复刻：
                    seed-icl-1.0（声音复刻1.0字符版）
                    seed-icl-1.0-concurr（声音复刻1.0并发版）
                    seed-icl-2.0 (声音复刻2.0字符版)
                注意：
                    "豆包语音合成模型1.0"的资源信息ID仅适用于"豆包语音合成模型1.0"的音色
                    "豆包语音合成模型2.0"的资源信息ID仅适用于"豆包语音合成模型2.0"的音色
                */
                "resource_id":"seed-tts-1.0",

  
                //model:模型版本，传seed-tts-1.1较默认版本音质有提升，并且延时更优，不传为默认效果。
                //注：若使用1.1模型效果，在复刻场景中会放大训练音频prompt特质，因此对prompt的要求更高，使用高质量的训练音频，可以获得更优的音质效果。
                "model":"seed-tts-1.1",

                //disable_markdown_filter:是否开启markdown解析过滤，
                //为true时，解析并过滤markdown语法，例如，**你好**，会读为“你好”，
                //为false时，不解析不过滤，例如，**你好**，会读为“星星‘你好’星星”
                "disable_markdown_filter":true,

                //disable_emoji_filter:开启emoji表情在文本中不过滤显示，默认为false，建议搭配时间戳参数一起使用。
                "disable_emoji_filter":false,

                //enable_latex_tn:是否可以播报latex公式，需将disable_markdown_filter设为true
                "enable_latex_tn":false,

                //max_length_to_filter_parenthesis:是否过滤括号内的部分，0为不过滤，100为过滤
                "max_length_to_filter_parenthesis":100,
              
                //请看文档：https://www.volcengine.com/docs/6561/1329505
                "explicit_language":"zh-cn",
                "context_language":"",

                //use_cache:需要开启缓存时传true,text_type不用指定会自动设置。
                "use_cache":true,


                //use_segment_cache需要开启分句文本的缓存传true，双向流式场景首包耗时比使用use_cache 低。
                "use_segment_cache":true,

                /*
                context_texts:语音合成的辅助信息，用于模型对话式合成，能更好的体现语音情感；
                可以探索，比如常见示例有以下几种：
                    语速调整
                        比如：context_texts: ["你可以说慢一点吗？"]
                    情绪/语气调整
                        比如：context_texts=["你可以用特别特别痛心的语气说话吗?"]
                        比如：context_texts=["嗯，你的语气再欢乐一点"]
                    音量调整
                        比如：context_texts=["你嗓门再小点。"]
                    音感调整
                        比如：context_texts=["你能用骄傲的语气来说话吗？"]
                注意：
                    该字段仅适用于"豆包语音合成模型2.0"的音色
                    当前字符串列表只第一个值有效
                    该字段文本不参与计费
                */
                "context_texts":"",

                /*
                use_tag_parser:是否开启cot解析能力。cot能力可以辅助当前语音合成，对语速、情感等进行调整。
                注意：
                    音色支持范围：仅限声音复刻2.0复刻的音色
                    文本长度：单句的text字符长度最好小于64（cot标签也计算在内）
                    cot能力生效的范围是单句
                示例：
                支持单组和多组cot标签：<cot text=急促难耐>工作占据了生活的绝大部分</cot>，只有去做自己认为伟大的工作，才能获得满足感。<cot text=语速缓慢>不管生活再苦再累，都绝不放弃寻找</cot>。
                */
                “use_tag_parser”:false,

                "type": "bytedance",

                /*
                AppID/Token 请看 https://www.volcengine.com/docs/6561/196768#q1%EF%BC%9A%E5%93%AA%E9%87%8C%E5%8F%AF%E4%BB%A5%E8%8E%B7%E5%8F%96%E5%88%B0%E4%BB%A5%E4%B8%8B%E5%8F%82%E6%95%B0appid%EF%BC%8Ccluster%EF%BC%8Ctoken%EF%BC%8Cauthorization-type%EF%BC%8Csecret-key-%EF%BC%9F
                */
                "appid": "",
                "token": ""

             },
             */


            /*
            豆包小模型TTS配置
            接口文档：https://www.volcengine.com/docs/6561/79821
            音色列表 ：https://www.volcengine.com/docs/6561/97465
            */
            /*
            "bytedance":{
                "count": 0, //最大多少并发
                "fault_threshold": 0, //连续错误多少次停用
                "fault_try_interval": 600, //停用多久后，从新尝试用这个KEY
                "connect_timeout": 3000, //建立ws连接最大等待时间
                "response_timeout": 60000, //等待tts返回的最大时间
                "type": "bytedance",
                /*
                AppID/Token 请看 https://www.volcengine.com/docs/6561/196768#q1%EF%BC%9A%E5%93%AA%E9%87%8C%E5%8F%AF%E4%BB%A5%E8%8E%B7%E5%8F%96%E5%88%B0%E4%BB%A5%E4%B8%8B%E5%8F%82%E6%95%B0appid%EF%BC%8Ccluster%EF%BC%8Ctoken%EF%BC%8Cauthorization-type%EF%BC%8Csecret-key-%EF%BC%9F
                */
                "appid": "",
                "token": ""
            },
            */



             /*
            "baidu":{
                "connect_timeout":3000,
                "response_timeout":60000,
                "count":0,
                "fault_threshold":0,
                "fault_try_interval":600,
                "type":"baidu",
                "appid":"",
                "key":"",
                "secret":""
            },
            */

            //讯飞语音合成接口，开通地址 https://console.xfyun.cn/services/tts
            /*
            "xfyun": {
                "count": 0,
                "fault_threshold": 0,
                "fault_try_interval": 600,
                "rdn": "0", //合成音频数字发音方式,参数说明 https://www.xfyun.cn/doc/tts/online_tts/API.html
                "reg": "0", //设置英文发音方式：
                "connect_timeout": 3000, //建立ws连接最大等待时间
                "response_timeout": 60000, //等待tts返回的最大时间
                "type": "xfyun", //xfyun 标识这个配置试用讯飞云ASR引擎
                "appid": "", //APPID
                "key": "", //APIKey
                "secret": "" //APISecret
            },
            */


            //华为语音合成 https://support.huaweicloud.com/api-sis/sis_03_0111.html
            /*
            "huawei": {
                "connect_timeout": 3000,
                "response_timeout": 60000,
                "type": "huawei",
                "projectname": "", //项目名字实际含义是项目节点 我的凭证处获取，如果没有项目先创建项目
                "projectid": "", //项目ID 我的凭证处获取
                "key": "", //Access Key Id 我的凭证(访问密钥)处创建
                "secret": "" //Secret Access Key 创建访问密钥时下载获取
            },
            */

            //思必驰语音识别 接口文档 https://help.talkinggenie.com/#/websocket_asr_vad
            /*
            "aispeech": {
                "type": "talkinggenie",
                "appid": "", //PID 产品ID
                "key": "", //PublicKey 说明文档 https://help.talkinggenie.com/#/api
                "secret": "" //SecretKey
            },
            */



            //AppID/Token 请看https://www.volcengine.com/docs/6561/196768#q1%EF%BC%9A%E5%93%AA%E9%87%8C%E5%8F%AF%E4%BB%A5%E8%8E%B7%E5%8F%96%E5%88%B0%E4%BB%A5%E4%B8%8B%E5%8F%82%E6%95%B0appid%EF%BC%8Ccluster%EF%BC%8Ctoken%EF%BC%8Cauthorization-type%EF%BC%8Csecret-key-%EF%BC%9F
            //普通语音识别发音人https://www.volcengine.com/docs/6561/97465
            //大模型语音识别发音人https://www.volcengine.com/docs/6561/1257544
            //如果需要指定情感和语种方法，把发音人设置为 发音人.情感.语种 比如 BV700_streaming.customer_service.en
            //支持以下参数explicit_language、context_language、disable_markdown_filter、enable_latex_tn、split_sentence、pure_english_opt，参数的类型和用法请看火山官方文档 https://www.volcengine.com/docs/6561/79823
            /*
            "Bytedance": {
                "count": 0,
                "fault_threshold": 0,
                "fault_try_interval": 600,
                "engine":"largemodel", //大模型语音合成设置为largemodel，普通合成设置为空。
                "type": "bytedance",
                "appid": "",
                "token": ""

            }
            */

            /*
            "mrcp": {
                "count": 0,
                "fault_threshold": 0,
                "fault_try_interval": 600,
                "type": "mrcp",
                "engine": "uni2",
                "appid": "",
                "key": "",
                "secret": ""
            },
            */

            //飞桨TTS模型
            /*
            "paddlespeech": {
                "type": "paddlespeech",
                "front_conf":"paddlespeech_tts/front.conf",
                "am_model":"paddlespeech_tts/weights/fastspeech2_csmsc.onnx",
                "voc_model":"paddlespeech_tts/weights/mb_melgan_csmsc.onnx",
                "thread_num":1
            }
            */

        },
        "groups":{
            "default":{
                "mode":1,
                "enable":[
                    "改成要使用的TTS配置名"
                ]
            },

            //自定义组，可以话术中指定使用那组TTS配置。
            "custom":{
                "mode":0,
                "enable":[
                ]
            }
        }
    }
}