View a markdown version of this page

Skema file input dan output untuk Pekerjaan Pendaftaran Pembicara di Connect Customer Voice ID - Pelanggan Amazon Connect
Skema file masukanSkema file keluaran

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Skema file input dan output untuk Pekerjaan Pendaftaran Pembicara di Connect Customer Voice ID

catatan

Pemberitahuan akhir dukungan: Pada 20 Mei 2026, dukungan untuk ID Amazon Connect Customer Suara AWS akan berakhir. Setelah 20 Mei 2026, Anda tidak akan lagi dapat mengakses ID Suara di Amazon Connect Customer konsol, mengakses fitur ID Suara di situs web Connect Customer admin atau Panel Kontrol Kontak, atau mengakses sumber daya ID Suara. Untuk informasi selengkapnya, kunjungi Amazon Connect Customer Voice ID akhir dukungan.

Skema file masukan

Berikut ini adalah skema file manifes input untuk Pekerjaan Pendaftaran Pembicara:

{
  "Version": "string",
  "SpeakerEnrollmentRequests": [
      {
          "RequestId": "string",
          "SpeakerId": "string",
          "AudioSpecifications": [
              {
                  "S3Uri": "string",
                  "ChannelId": number 
              }
           ] 
      }
   ]
}
catatan

Semua bidang dalam skema diperlukan.

Berikut ini adalah deskripsi dari setiap atribut skema input.

  • Version: Versi dokumen skema input. Saat ini, ini seharusnya1.0.

  • SpeakerEnrollmentRequests: Daftar permintaan pendaftaran pembicara yang harus dipenuhi sebagai bagian dari pekerjaan.

    • RequestId: Pengidentifikasi untuk permintaan pendaftaran pembicara ini. Itu harus unik dalam file input. Ini digunakan untuk memetakan dan mengidentifikasi entri dalam file output.

    • SpeakerId: Pengidentifikasi pembicara yang disediakan klien yang perlu didaftarkan. Anda harus lulus CustomerSpeakerId di bidang ini. Saat GeneratedSpeakerId ini tidak didukung.

    • AudioSpecifications: Daftar file audio yang dapat digunakan Voice ID untuk mendaftarkan pembicara ini. Voice ID menggunakan file audio ini bersama-sama untuk mengumpulkan jumlah ucapan yang diperlukan untuk pendaftaran. Saat ini, jumlah maksimum file audio yang diizinkan untuk permintaan pendaftaran adalah 10. Setiap file dapat berupa file.wav hingga 20MB, berisi audio dengan laju sampel dan pengkodean 8kHz. PCM-16

      • S3URI: Lokasi Amazon S3 dari file audio dalam format.wav yang perlu digunakan untuk mendaftarkan pembicara.

      • ChannelId: Saluran audio yang akan digunakan untuk mendaftarkan speaker dalam file audio multi-saluran. Voice ID mendukung file audio hingga dua saluran, jadi nilai ini dibatasi untuk 0 atau 1.

Skema file keluaran

Berikut ini adalah skema file output yang dihasilkan untuk Pekerjaan Pendaftaran Pembicara:

{
  "Version": "string",
  "Errors": [
       {
          "RequestId": "string",
          "ErrorCode": number,
          "ErrorMessage": "string"
       }
   ],
   "SuccessfulEnrollments": [
       {
          "RequestId": "string",
          "GeneratedSpeakerId": "string",
          "CustomerSpeakerId": "string",
          "EnrollmentStatus": "DUPLICATE_SKIPPED" | "NEW_ENROLLMENT" | "ENROLLMENT_OVERWRITE"
       }
   ]   
}

Berikut ini adalah deskripsi dari setiap atribut skema keluaran.

  • Version: Versi dokumen skema keluaran. Saat ini, ini seharusnya1.0.

  • Errors: Daftar kesalahan untuk permintaan pendaftaran pembicara yang gagal di beberapa titik selama pendaftaran.

    • RequestId: Pengidentifikasi permintaan yang terkait dengan permintaan ini. Ini sama dengan yang RequestId ditentukan dalam file input untuk permintaan ini.

    • ErrorCode: Kode kesalahan HTTP yang mewakili jenis kesalahan. Beberapa contoh skenario kesalahan dijelaskan di bawah ini.

      catatan

      Ini bukan daftar lengkap.

      • 400 (Pengecualian Permintaan Buruk):

        • File JSON input cacat dan tidak dapat diurai.

        • File audio yang disediakan tidak memiliki cukup ucapan untuk pendaftaran.

        • Pemeriksaan verifikasi penipuan gagal untuk pembicara yang diberikan.

      • 402 (ServiceQuotaLimitExceededException):

        • Batas speaker terlampaui.

      • 409 (Pengecualian Konflik):

        • Tindakan yang bertentangan: Anda tidak dapat meminta pendaftaran untuk pembicara yang memilih keluar.

      • 500 (Kegagalan Internal):

        • Kesalahan Server Internal (Kesalahan tak terduga pada Service-side).

    • ErrorMessage: Pesan yang menjelaskan penyebab kegagalan pendaftaran.

  • SuccessfulEnrollments: Daftar permintaan pendaftaran yang berhasil.

    • RequestId: Pengidentifikasi permintaan yang terkait dengan permintaan ini. Ini sama dengan yang RequestId ditentukan dalam file input untuk permintaan ini.

    • CustomerSpeakerId: Pengidentifikasi yang disediakan klien untuk pembicara yang terdaftar.

    • GeneratedSpeakerId: Pengidentifikasi yang dihasilkan layanan untuk pembicara yang terdaftar.

    • EnrollmentStatus: Status pendaftaran pembicara yang berhasil

      • DUPLICATE_SKIPPED: Pembicara sudah terdaftar, dan pendaftaran dilewati.

      • NEW_ENROLLMENT: Pembicara baru terdaftar ke dalam sistem.

      • ENROLLMENT_OVERWRITE: Pembicara sudah terdaftar, tetapi enrolled/overwritten menggunakan kembali audio baru.