音声エージェント

ここには 2 つのものがあります。エージェントの振る舞いを決める設定と、エージェントが話すために使える音声とプロバイダーの一覧です。

操作	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 のときは再生ボタンを無効にしてください。別の音声で代替すると、エージェントが実際には使わない声を聞かせることになります。