語音代理

這裡有兩樣東西：決定代理行為的設定，以及代理說話時可用的語音與供應商清單。

操作	Route
列出設定	GET /agents/configs
讀取單一設定	GET /agents/configs/{documentId}
建立	POST /agents/configs
取代	PUT /agents/configs/{documentId}
刪除	DELETE /agents/configs/{documentId}
列出供應商	GET /voice/providers
列出語音	GET /voice/providers/{provider}/voices

設定

設定是一份文件。隨著代理能力增加，studio 會往裡面加欄位，因此遇到不認識的鍵請原樣傳遞，不要丟棄。

供應商與語音清單

可用的供應商因部署而異，並非固定值，取決於該環境設定了哪些 vendor key。請在執行時讀取清單，不要把供應商名稱寫死在程式碼裡。

{
  "data": [
    {
      "id": "voice_abc",
      "name": "Mali",
      "gender": "female",
      "language": "th-TH",
      "preview": true
    }
  ]
}

請遵循 preview

preview 會隨 vendor key 變動，因此每次請求都會重新判定。為 false 時請停用播放按鈕，不要改用其他語音替代——否則使用者聽到的並不是代理真正會用的聲音。