语音智能体

这里有两样东西：决定智能体行为的配置，以及智能体说话可用的语音与供应商清单。

操作	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 时请禁用播放按钮，不要改用其他语音代替——否则用户听到的并不是智能体真正会用的声音。