Esquema de arquivos de entrada e saída para o trabalho de inscrição de palestrante 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 inscrição de palestrante no Amazon Connect Voice ID

nota

Aviso de fim do suporte: em 20 de maio de 2026, a AWS encerrará o suporte para o Amazon Connect Voice ID. Depois de 20 de maio de 2026, você não poderá mais acessar o Voice ID no console do Amazon Connect, acessar os recursos do Voice ID no site de administração do Amazon Connect, no Painel de controle de contatos nem acessar os recursos do Voice ID. Para acessar mais informações, acesse Fim do suporte do Amazon Connect Voice ID.

Esquema de arquivos de entrada

Veja abaixo o esquema do arquivo de manifesto de entrada para o trabalho de inscrição de locutor:

{
  "Version": "string",
  "SpeakerEnrollmentRequests": [
      {
          "RequestId": "string",
          "SpeakerId": "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 de entrada. No momento, deve ser 1.0.

  • SpeakerEnrollmentRequests: lista de solicitações de inscrição de locutores a serem atendidas como parte do trabalho.

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

    • SpeakerId: o identificador fornecido pelo cliente para o locutor que precisa ser inscrito. Você deve passar o CustomerSpeakerId nesse campo. Atualmente, o GeneratedSpeakerId não é compatível.

    • AudioSpecifications: a lista de arquivos de áudio que o Voice ID pode usar para inscrever esse locutor. 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 10. Cada arquivo pode ser um arquivo.wav de até 20 MB, contendo áudio com taxa de amostragem de 8 kHz e codificação PCM-16.

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

      • ChannelId: o canal de áudio a ser usado para inscrever o locutor 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 de saída para o trabalho de inscrição de locutor:

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

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 inscrição de locutores que apresentaram falha em algum momento durante a inscrição.

    • 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 a inscrição.

        • As verificações de fraude falharam para o locutor em questão.

      • 402 (exceção de limite de serviço excedido):

        • Limite de locutores excedido.

      • 409 (exceção de conflito):

        • Ação conflitante: você não pode solicitar a inscrição de um locutor que optou por não participar.

      • 500 (erro interno):

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

    • ErrorMessage: uma mensagem descrevendo a causa da falha na inscrição.

  • SuccessfulEnrollments: a lista de solicitações de inscrição 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.

    • CustomerSpeakerId: o identificador fornecido pelo cliente para o locutor que foi inscrito.

    • GeneratedSpeakerId: o identificador gerado pelo serviço para o locutor que foi inscrito.

    • EnrollmentStatus: o status da inscrição bem-sucedida de locutores.

      • DUPLICATE_SKIPPED: o locutor já está inscrito e a inscrição foi ignorada.

      • NEW_ENROLLMENT: o locutor foi recém-inscrito no sistema.

      • ENROLLMENT_OVERWRITE: o locutor já está inscrito, mas foi reinscrito/sobrescrito usando o novo áudio.