프라우스터 등록 Job 위한 입력 및 출력 파일 스키마 - Amazon Connect

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

프라우스터 등록 Job 위한 입력 및 출력 파일 스키마

입력 파일 스키마

다음은 프라우드스터 등록 작업에 대한 입력 매니페스트 파일의 스키마입니다.

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

스키마의 모든 필드는 다음과 같습니다.필수.

다음은 입력 스키마의 각 속성에 대한 설명입니다.

  • Version: 스키마의 문서 버전입니다. 현재는 다음과 같습니다.1.0.

  • FraudsterRegistrationRequests: 작업의 일부로 처리해야 하는 사기꾼 등록 요청 목록입니다.

    • RequestId: 이 사기꾼 등록 요청의 식별자입니다. 이 값은 입력 파일 내에서 고유해야 합니다. 출력 파일의 항목을 매핑하고 식별하는 데 사용됩니다.

    • AudioSpecifications: 이 사기꾼을 등록하는 데 Voice ID가 사용할 수 있는 오디오 파일 목록입니다. Voice ID는 이러한 오디오 파일을 함께 사용하여 등록에 필요한 음성량을 수집합니다. 현재 등록 요청에 허용되는 최대 오디오 파일 수는10. 각 파일은 8kHz 샘플링 레이트와 PCM-16 인코딩의 오디오를 포함하는 최대 20MB의.wav 파일일 수 있습니다.

      • S3URI: 사기범을 등록하는 데 사용해야 하는.wav 형식의 오디오 파일의 Amazon S3 위치입니다.

      • ChannelId: 멀티 채널 오디오 파일에 사기범을 등록하는 데 사용할 오디오 채널입니다. Voice ID는 최대 2개 채널의 오디오 파일을 지원하므로 이 값은 다음 중 하나로 제한됩니다.0또는1.

출력 파일 스키마

다음은 프라우드스터 등록 작업에 대한 출력 매니페스트 파일의 스키마입니다.

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

다음은 출력 스키마의 각 속성에 대한 설명입니다.

  • Version: 출력 스키마의 버전입니다. 현재는 다음과 같습니다.1.0.

  • Errors: 등록 중 특정 시점에 실패한 사기꾼 등록 요청에 대한 오류 목록입니다.

    • RequestId: 이 요청과 관련된 요청 식별자입니다. 이는 과 동일합니다.RequestId이 요청의 입력 파일에 지정되어 있습니다.

    • ErrorCode: 오류 유형을 나타내는 HTTP 오류 코드입니다. 몇 가지 오류 시나리오 예가 아래에 설명되어 있습니다.

      참고

      전체 목록은 아닙니다.

      • 400 (잘못된 요청 예외):

        • 입력 JSON 파일의 형식이 잘못되어 파싱할 수 없습니다.

        • 제공된 오디오 파일에는 등록하기에 충분한 음성이 없습니다.

      • 402 (ServiceQuotaLimitExceededException):

        • 부정 한도가 초과되었습니다.

      • 500 (내부 장애):

        • 내부 서버 오류 (서비스 측에서 예상치 못한 오류).

    • ErrorMessage: 사기꾼 등록 실패의 원인을 설명하는 메시지입니다.

  • SuccessfulRegistrations: 성공한 등록 요청 목록입니다.

    • RequestId: 이 요청과 관련된 요청 식별자입니다. 이는 과 동일합니다.RequestId이 요청의 입력 파일에 지정되어 있습니다.

    • RegistrationStatus: 사기꾼 등록 성공 상태.

      • DUPLICATE_SKIPPED: 사기꾼이 중복된 것으로 확인되었고 등록을 건너뛰었습니다.

      • NEW_FRAUDSTER: 사기꾼이 시스템에 새로 등록되었습니다.

    • GeneratedFraudsterId: 등록된 사기꾼의 서비스 생성 식별자입니다. 경우에 따라RegistrationStatus입니다DUPLICATE_SKIPPED, 이것은 이미 도메인에 속해 있고 특정 사기꾼과 가장 가까운 사기꾼의 식별자입니다.

    • FraudsterSimilarityScore: 중복으로 인해 사기꾼 등록을 건너뛸 때 입력되는 선택적 필드입니다. 이는 특정 사기꾼과 도메인에 이미 존재하는 가장 유사한 사기꾼의 유사성을 나타냅니다.