介紹

FreeSWITCH 電話(huà)機(jī)器人模塊，包含腳本解析引擎和話(huà)術(shù)編輯器2部分。

話(huà)術(shù)編輯器

話(huà)術(shù)編輯器是一個(gè)圖形化的應(yīng)用程序，通過(guò)圖形化編輯話(huà)術(shù)流程，生成JSON文件。支持ASR流接口，支持多種打斷方案，支持TTS，支持變量，支持真人錄音，支持TTS和錄音文件混合放音，支持正則表達(dá)式匹配，支持NLP接口，支持知識(shí)庫(kù)，支持限制流程重復(fù)執(zhí)行。

ASR支持

采用ASR流接口，可以實(shí)時(shí)得到識(shí)別結(jié)果進(jìn)行匹配，可實(shí)現(xiàn)搶話(huà)，快速打斷等高級(jí)功能。

TTS支持

支持變量，支持TTS和真人錄音混合放音，支持TTS音量、語(yǔ)速、語(yǔ)調(diào)、發(fā)音人等參數(shù)設(shè)置，支持不同通話(huà)使用不同發(fā)音人等高級(jí)功能。

NLP支持

支持NLP接口，用戶(hù)只需要專(zhuān)注于NLP接口實(shí)現(xiàn)，就可以實(shí)現(xiàn)高級(jí)的話(huà)術(shù)流程。

知識(shí)庫(kù)支持

知識(shí)庫(kù)和話(huà)術(shù)邏輯分離，讓話(huà)術(shù)邏輯條理清晰，可以在話(huà)術(shù)節(jié)點(diǎn)觸發(fā)知識(shí)庫(kù)放音，知識(shí)庫(kù)放音話(huà)可以返回節(jié)點(diǎn)播放一個(gè)返回音。知識(shí)庫(kù)放音的時(shí)候同樣可以進(jìn)行ASR識(shí)別。

限制流程重復(fù)次數(shù)

可以防止機(jī)器人重復(fù)播放一個(gè)聲音，或者流程進(jìn)入死循環(huán)。

腳本解析引擎

腳本解析引擎是FreeSWTICH的內(nèi)嵌模塊，用來(lái)解析和執(zhí)行話(huà)術(shù)編輯器生產(chǎn)的JSON文件。它非常高效和功能強(qiáng)大，沒(méi)ESL接口或者RESTAPI接口的額外開(kāi)銷(xiāo)，不需要查詢(xún)數(shù)據(jù)庫(kù)。

標(biāo)準(zhǔn)化

JSON腳本，可以手動(dòng)編輯，也可以第三方工具生成，使用標(biāo)準(zhǔn)格式，方便第三方編寫(xiě)話(huà)術(shù)編輯器。

高效

直接使用FreeSWITCH模塊方式，沒(méi)有協(xié)議對(duì)接開(kāi)銷(xiāo)，使用通道變量設(shè)置TTS變量，不需要查詢(xún)數(shù)據(jù)庫(kù)。

分布式

通過(guò)消息隊(duì)列推送對(duì)話(huà)流程，方便大規(guī)模群集。

ASRPROXY

ASR和TTS接口程序程序?qū)崿F(xiàn)阿里云和科大的ASR流接口對(duì)接。

使用指南

全局配置

配置TTS，ASR和NLP

TTS配置

機(jī)器人引擎程序會(huì)根據(jù)配置生成 http://127.0.0.1:9989/tts?config=&voice=&volume=0&speechrate=0&pitchrate=0&engine=&text=%E4%BD%A0%E5%A5%BD%E8%BF%99%E9%87%8C%E6%98%AF%E9%A1%B6%E9%A1%B6%E9%80%9A%E8%BD%AF%E4%BB%B6 這樣的路徑去播放聲音，voice和text使用utf8字符編碼，然后進(jìn)行url編碼。用戶(hù)可以直接實(shí)現(xiàn)TTS服務(wù)，也可以使用ASRPROXY提供的tts服務(wù)。

發(fā)音人列表：可以配置多個(gè)發(fā)音人，每個(gè)電話(huà)循環(huán)使用發(fā)音人，避免每個(gè)電話(huà)都是同樣的聲音。
默認(rèn)發(fā)音人：如果配置了默認(rèn)發(fā)音人，就不會(huì)使用循環(huán)使用發(fā)音人列表里面的發(fā)音人。
TTS接口：如果使用ASRPROXY，配置 http://127…0.0.1:0089/tts 這個(gè)地址
TTS配置：ASRPROXY可以配置多個(gè)不同的TTS服務(wù)和KEY，通過(guò)這個(gè)配置來(lái)控制使用具體的TTS服務(wù)。
錄音路徑：不是TTS文件的緩存錄音路徑，是真人錄音文件的存放目錄。

ASR配置

設(shè)置默認(rèn)ASR參數(shù)，如果流程節(jié)點(diǎn)單獨(dú)設(shè)置了ASR參數(shù)，就會(huì)覆蓋全局設(shè)置。

模式：【mode】0:不啟動(dòng)ASR識(shí)別 1：放音的同時(shí)開(kāi)啟ASR識(shí)別; 2：放音完成之后才開(kāi)啟ASR識(shí)別。
打斷：【interrupt】0：不打斷； 1：檢測(cè)到聲音打斷； 2：有識(shí)別結(jié)果打斷； 3：識(shí)別到一句話(huà)打斷。
地址：【asrproxy_addr】asr代理地址。
開(kāi)始：【vad_min_active_time_ms】說(shuō)話(huà)時(shí)間大于這個(gè)值才開(kāi)始提交ASR。
停止：【vad_max_end_silence_time_ms】靜音時(shí)間大于這個(gè)值認(rèn)為說(shuō)話(huà)停止。
等待：【wait_speech_timeout_ms】放音完成后等待用戶(hù)說(shuō)話(huà)的等待時(shí)間。
最大：【max_speech_time_ms】最大說(shuō)話(huà)時(shí)間，說(shuō)話(huà)時(shí)間超過(guò)這個(gè)值就停止ASR。
熱詞：【hot_word】ASR熱詞。
參數(shù)：【asr_params】ASR參數(shù)。

NLP配置

配置NLP接口地址和同義詞組。

外鏈圖片轉(zhuǎn)存失敗,源站可能有防盜鏈機(jī)制,建議將圖片保存下來(lái)直接上傳

接口地址：NLP接口地址。
同義詞組：把相同一樣的詞可以放到一個(gè)組里，配置流程的時(shí)候，可以直接選擇關(guān)鍵詞組。

知識(shí)庫(kù)

把常見(jiàn)問(wèn)題的回復(fù)預(yù)先定義好，可以通過(guò)關(guān)鍵詞或者NLP觸發(fā)知識(shí)庫(kù)放音

外鏈圖片轉(zhuǎn)存失敗,源站可能有防盜鏈機(jī)制,建議將圖片保存下來(lái)直接上傳 ]

分類(lèi)：可以設(shè)置很多不同的分類(lèi)方便和流程結(jié)點(diǎn)關(guān)聯(lián)
關(guān)鍵詞：支持正則表達(dá)式，識(shí)別到關(guān)鍵詞，就觸發(fā)機(jī)器人放音
放音：支持TTS和文件放音支持變量。
重復(fù)：可以防止多次重復(fù)觸發(fā)。

流程編輯

通過(guò)拖拉方式配置話(huà)術(shù)流程。

外鏈圖片轉(zhuǎn)存失敗,源站可能有防盜鏈機(jī)制,建議將圖片保存下來(lái)直接上傳

節(jié)點(diǎn)屬性

外鏈圖片轉(zhuǎn)存失敗,源站可能有防盜鏈機(jī)制,建議將圖片保存下來(lái)直接上傳

NLPID：NLP ID,配置了這個(gè)值才會(huì)把輸入事件提交給NLP接口處理
等待：等待時(shí)間，單位毫秒，支持一個(gè)時(shí)間范圍內(nèi)的隨機(jī)值比如1-10，動(dòng)作執(zhí)行完成后，等待時(shí)間內(nèi)沒(méi)輸入，就觸發(fā)等待超時(shí)(timeout)
重復(fù)：動(dòng)作最大重復(fù)執(zhí)行次數(shù)，可防止流程進(jìn)入死循環(huán)
知識(shí)庫(kù)：設(shè)置關(guān)聯(lián)的知識(shí)庫(kù)
返回音：播放完知識(shí)庫(kù)回答后面播放的聲音
文本濾：不接收哪些類(lèi)型的識(shí)別結(jié)果【F,E,S(前綴F：識(shí)別完成，前綴E：ASR錯(cuò)誤，前綴S：識(shí)別中)】,如果過(guò)濾條件第一個(gè)字母是’！’，就是只接收匹配的識(shí)別結(jié)果
放音：機(jī)器人播放的聲音文件
重放：重復(fù)進(jìn)入(知識(shí)庫(kù)返回，或者其他流程返回)機(jī)器人播放的聲音文件，如果不設(shè)置，會(huì)使用“放音”設(shè)置的參數(shù)
模式：【mode】0:不啟動(dòng)ASR識(shí)別 1：放音的同時(shí)開(kāi)啟ASR識(shí)別; 2：放音完成之后才開(kāi)啟ASR識(shí)別。
ASR參數(shù)可以覆蓋全局配置的默認(rèn)ASR設(shè)置