Esquema de arquivos de entrada e saída para o trabalho de registro de fraudadores no Amazon Connect Voice ID - Amazon Connect
Esquema de arquivos de entradaEsquema de arquivos de saída

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Esquema de arquivos de entrada e saída para o trabalho de registro de fraudadores no Amazon Connect Voice ID

Esquema de arquivos de entrada

Veja abaixo o esquema do arquivo do manifesto de entrada para trabalhos de registro de fraudadores:

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

Todos os campos no esquema são obrigatórios.

Veja a seguir uma descrição de cada atributo do esquema de entrada.

  • Version: a versão do documento do esquema. No momento, deve ser 1.0.

  • FraudsterRegistrationRequests: lista de solicitações de registro de fraudadores a serem atendidas como parte do trabalho.

    • RequestId: um identificador para essa solicitação de registro de fraudador. Ele deve ser exclusiva dentro do arquivo de entrada. É usado para mapear e identificar entradas no arquivo de saída.

    • AudioSpecifications: a lista de arquivos de áudio que o Voice ID pode usar para registrar esse fraudador. O Voice ID usa esses arquivos de áudio juntos para coletar a quantidade necessária de fala para a inscrição. Atualmente, o número máximo de arquivos de áudio permitidos para uma solicitação de registro é dez. Cada arquivo pode ser um arquivo.wav de até 20 MB, contendo áudio com taxa de KHz amostragem 8 e codificação PCM-16.

      • S3URI: a localização no Amazon S3 do arquivo de áudio no formato.wav que precisa ser usado para registrar o fraudador.

      • ChannelId: o canal de áudio a ser usado para registrar o fraudador em um arquivo de áudio multicanal. O Voice ID comporta arquivos de áudio com até dois canais; portanto, esse valor é restrito a 0 ou 1.

Esquema de arquivos de saída

Veja abaixo o esquema do arquivo do manifesto de saída para trabalhos de registro de fraudadores:

{
 "Version": "string",
   "Errors": [
       {
          "RequestId": "string",
          "ErrorCode": number,
          "ErrorMessage": "string"
       }
   ],
   "SuccessfulRegistrations": [
       {
          "RequestId": "string", 
          "GeneratedFraudsterId": "string", 
          "RegistrationStatus": "DUPLICATE_SKIPPED" | "NEW_REGISTRATION",
          "FraudsterSimilarityScore": number
       }
   ]   
}

Veja a seguir uma descrição de cada atributo do esquema de entrada.

  • Version: a versão do documento do esquema de saída. No momento, deve ser 1.0.

  • Errors: a lista de erros nas solicitações de registro de fraudador que foram malsucedidas em algum momento durante o registro.

    • RequestId: o identificador da solicitação associado a essa solicitação. É o mesmo RequestId especificado no arquivo de entrada para essa solicitação.

    • ErrorCode: o código de erro HTTP que representa o tipo de erro. Alguns exemplos de cenários de erro são descritos abaixo.

      nota

      Esta não é uma lista completa.

      • 400 (exceção de solicitação inválida):

        • O arquivo JSON de entrada está malformado e não pode ser analisado.

        • Os arquivos de áudio fornecidos não têm voz suficiente para registro.

      • 402 (ServiceQuotaLimitExceededException):

        • Limite de fraudadores excedido.

      • 500 (erro interno):

        • Erro interno do servidor (erro inesperado do lado do serviço).

    • ErrorMessage: uma mensagem descrevendo a causa da falha no registro de fraudador.

  • SuccessfulRegistrations: a lista de solicitações de registro que foram bem-sucedidas.

    • RequestId: o identificador da solicitação associado a essa solicitação. É o mesmo RequestId especificado no arquivo de entrada para essa solicitação.

    • RegistrationStatus: o status do registro bem-sucedido de fraudador.

      • DUPLICATE_SKIPPED: o fraudador foi identificado como duplicado e o registro foi ignorado.

      • NEW_FRAUDSTER: o fraudador foi recém-inscrito no sistema.

    • GeneratedFraudsterId: o identificador gerado pelo serviço para o fraudador que foi registrado. Caso RegistrationStatus seja DUPLICATE_SKIPPED, esse é o identificador do fraudador que já está no domínio que mais se aproxima do fraudador em questão.

    • FraudsterSimilarityScore: um campo opcional que é preenchido quando o registro do fraudador é ignorado por ser uma duplicata. Isso representa a similaridade do fraudador em questão com o fraudador mais próximo que já existe no domínio.