Esquema de archivos de entrada y salida para el trabajo de inscripción de interlocutores en Amazon Connect Voice ID - Amazon Connect
Esquema de archivo de entradaEsquema de archivo de salida

Esquema de archivos de entrada y salida para el trabajo de inscripción de interlocutores en Amazon Connect Voice ID

Esquema de archivo de entrada

A continuación, se presenta el esquema del archivo de manifiesto de entrada para el trabajo de inscripción de interlocutores:

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

Todos los campos del esquema son obligatorios.

A continuación, se describe cada atributo del esquema de entrada.

  • Version: versión del documento de esquema de entrada. En la actualidad tiene que ser 1.0.

  • SpeakerEnrollmentRequests: lista de solicitudes de inscripción de interlocutores que deben procesarse como parte del trabajo.

    • RequestId: un identificador para esta solicitud de inscripción de interlocutores. Debe ser único en el archivo de entrada. Se utiliza para asignar e identificar las entradas del archivo de salida.

    • SpeakerId: el identificador proporcionado por el cliente del interlocutor que debe inscribirse. Debe pasar CustomerSpeakerId en este campo. Actualmente, no se admite la API GeneratedSpeakerId.

    • AudioSpecifications: la lista de archivos de audio que Voice ID puede utilizar para inscribir a este interlocutor. Voice ID utiliza estos archivos de audio juntos para recopilar la cantidad de voz necesaria para la inscripción. Actualmente, la cantidad máxima de archivos de audio permitida para una solicitud de inscripción es de 10. Cada archivo puede ser un .wav de hasta 20 MB y contener audio con una frecuencia de muestreo de 8 kHz y codificación PCM-16.

      • S3URI: la ubicación de Amazon S3 del archivo de audio en formato .wav que debe usarse para inscribir al interlocutor.

      • ChannelId: el canal de audio que se utilizará para inscribir al interlocutor en un archivo de audio multicanal. Voice ID admite archivos de audio de hasta dos canales, por lo que este valor se limita a 0 o 1.

Esquema de archivo de salida

A continuación, se presenta el esquema del archivo de salida para el trabajo de inscripción de interlocutores:

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

A continuación, se describe cada atributo del esquema de salida.

  • Version: versión del documento de esquema de salida. En la actualidad tiene que ser 1.0.

  • Errors: la lista de errores de las solicitudes de inscripción de interlocutores que han generado error en algún momento durante la inscripción.

    • RequestId: el identificador de solicitud asociado a esta solicitud. Es el mismo que el RequestId especificado en el archivo de entrada de esta solicitud.

    • ErrorCode: el código de error HTTP que representa el tipo de error. A continuación, se describen algunos ejemplos de escenarios de error.

      nota

      No es una lista exhaustiva.

      • 400 (excepción de solicitud incorrecta):

        • El archivo JSON de entrada tiene un formato incorrecto y no se puede analizar.

        • Los archivos de audio proporcionados no tienen suficiente voz para la inscripción.

        • Las comprobaciones de verificación de fraude no se realizaron correctamente para el interlocutor en cuestión.

      • 402 (ServiceQuotaLimitExceededException):

        • Límite de interlocutores superado.

      • 409 (excepción de conflicto):

        • Acción conflictiva: no puede solicitar la inscripción de un interlocutor excluido.

      • 500 (error interno):

        • Error interno del servidor (error inesperado en el servicio).

    • ErrorMessage: un mensaje que describe la causa del error de inscripción.

  • SuccessfulEnrollments: la lista de solicitudes de inscripción que se han realizado correctamente.

    • RequestId: el identificador de solicitud asociado a esta solicitud. Es el mismo que el RequestId especificado en el archivo de entrada de esta solicitud.

    • CustomerSpeakerId: el identificador proporcionado por el cliente del interlocutor que se ha inscrito.

    • GeneratedSpeakerId: el identificador generado por el servicio para el interlocutor que se ha inscrito.

    • EnrollmentStatus: el estado de inscripción correcta del interlocutor.

      • DUPLICATE_SKIPPED: el interlocutor ya está inscrito y se ha omitido la inscripción.

      • NEW_ENROLLMENT: el interlocutor se ha inscrito recientemente en el sistema.

      • ENROLLMENT_OVERWRITE: el interlocutor ya está inscrito, pero se volvió a inscribir o sobrescribió con el nuevo audio.