Schema di file di input e output per il Fraudster Registration Job in Amazon Connect Voice ID - Amazon Connect
Schema del file di inputSchema del file di output

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Schema di file di input e output per il Fraudster Registration Job in Amazon Connect Voice ID

Schema del file di input

Di seguito è riportato lo schema del file manifesto di input per i processi di registrazione dei truffatori:

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

Tutti i campi dello schema sono obbligatori.

Di seguito è riportata una descrizione di ogni attributo dello schema di input.

  • Version: versione del documento dello schema. Al momento, è 1.0.

  • FraudsterRegistrationRequests: elenco delle richieste di registrazione dei truffatori da gestire nell'ambito del processo.

    • RequestId: identificatore per la richiesta di registrazione del truffatore. Il nome deve essere univoco all'interno del file di input. Viene usato per mappare e identificare le voci nel file di output.

    • AudioSpecifications: elenco dei file audio che Voice ID può usare per registrare il truffatore. Voice ID usa questi file audio insieme per raccogliere la quantità di parlato necessaria per la registrazione. Attualmente, il numero massimo di file audio consentito per una richiesta di registrazione è 10. Ogni file può essere un file.wav fino a 20 MB, contenente audio con 8 frequenze di KHz campionamento e codifica -16. PCM

      • S3URI: posizione in Amazon S3 del file audio in formato WAV da usare per registrare il truffatore.

      • ChannelId: canale audio da usare per registrare il truffatore in un file audio multicanale. Voice ID supporta i file audio con un massimo di due canali, quindi questo valore è limitato a 0 o 1.

Schema del file di output

Di seguito è riportato lo schema del file manifesto di output per i processi di registrazione dei truffatori:

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

Di seguito è riportata una descrizione di ogni attributo dello schema di output.

  • Version: versione del documento dello schema di output. Al momento, è 1.0.

  • Errors: elenco degli errori relativi alle richieste di registrazione del truffatore che non sono andate a buon fine.

    • RequestId: identificatore associato alla richiesta. Corrisponde all'attributo RequestId specificato nel file di input per la richiesta.

    • ErrorCode: Il codice di HTTP errore che rappresenta il tipo di errore. Di seguito sono descritti alcuni scenari di errore di esempio.

      Nota

      Questo elenco non è esaustivo.

      • 400 (eccezione di richiesta non valida):

        • Il JSON file di input non è valido e non può essere analizzato.

        • I file audio forniti non contengono abbastanza parlato per la registrazione.

      • 402 (): ServiceQuotaLimitExceededException

        • Limite di truffatori superato.

      • 500 (errore interno):

        • Errore interno del server (errore imprevisto sul lato del servizio).

    • ErrorMessage: messaggio che descrive la causa dell'errore di registrazione del truffatore.

  • SuccessfulRegistrations: elenco delle richieste di registrazione che hanno avuto esito positivo.

    • RequestId: identificatore associato alla richiesta. Corrisponde all'attributo RequestId specificato nel file di input per la richiesta.

    • RegistrationStatus: stato dell'avvenuta registrazione del truffatore.

      • DUPLICATE_SKIPPED: il truffatore è stato identificato come duplicato e la registrazione è stata ignorata.

      • NEW_FRAUDSTER: il truffatore è stato appena registrato nel sistema.

    • GeneratedFraudsterId: identificatore generato dal servizio per il truffatore registrato. Se RegistrationStatus è DUPLICATE_SKIPPED, si tratta dell'identificatore del truffatore già presente nel dominio che corrisponde maggiormente al truffatore in questione.

    • FraudsterSimilarityScore: campo facoltativo che viene popolato quando la registrazione del truffatore viene ignorata in quanto si tratta di un duplicato. Indica il livello di somiglianza tra il truffatore in questione e il truffatore più simile già esistente nel dominio.