음성 ID 이벤트 스키마 - Amazon Connect

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

음성 ID 이벤트 스키마

음성 ID는 워치리스트의 등록, 인증 또는 사기꾼 탐지 등 모든 거래에 대한 이벤트를 생성합니다. 이벤트는 다음 주소로 전송됩니다. EventBridge 기본 이벤트 버스입니다.

다음을 사용하여 감시 목록에서 음성 ID 인증 결과 및 사기꾼 탐지를 위한 분석 파이프라인을 만들 수 있습니다. EventBridge 음성 ID 이벤트를 모니터링할 수 있습니다. 이 항목에서 사용할 수 있는 스키마를 사용하여 다음을 구성할 수 있습니다. EventBridge 관련 있는 음성 ID 이벤트를 수신 대기하고 필터링한 다음 Amazon Kinesis Data Firehose Firehose를 통해 처리하여 선택한 데이터 웨어하우스에 저장하는 규칙.

예를 들어, 음성 ID 분석을 거의 실시간으로 추적하고 싶을 수 있습니다. 그러기 위해서는 모든 것을 꺼낼 수 있습니다.Evaluate-Session이벤트 및 받기authenticationResultfraudDetectionResult.

이벤트는 최선의 작업을 기반으로 발생됩니다.

이벤트의 공통 필드

  • version- 이벤트 데이터의 버전입니다.

  • id- 에서 생성한 이벤트의 고유한 식별자 EventBridge

  • detail-type- 이벤트 세부 정보에 대한 식별자입니다.

  • source- 이벤트의 원본입니다. 항상 aws.voiceid입니다.

  • account-AWS계정 ID입니다.

  • timestamp- 이벤트가 게시된 날짜와 시간

  • region- 더AWSAPI 호출이 이루어진 리전입니다.

  • resources- API 호출에서 사용한 리소스입니다.

  • detail- 이벤트에 대한 세부 정보입니다.

    • detail.sourceId- 음성 ID로 생성한 고유 ID로, 중복 제거에 사용할 수 있습니다.

    • detail.action- 호출되는 API와 유사합니다.

    • detail.status- 작업 상태 (성공 또는 실패) 를 지정합니다.

    • detail.errorInfo- Voice ID에서 지정된 작업 오류가 발생하면 입력됩니다.

다음은 발생한 이벤트에 대한 스키마입니다.

세션 작업 시작

스트림 시작 (설정 후), 스트림 종료 및 실패 시 이벤트를 내보냅니다.

{...commonfields "detail-type": "VoiceId Start Session Action", "detail": { "sourceId": String, "action": "START_SESSION", "status": String, "domainId": String, "session": { "sessionId": String, "sessionName": String, "authenticationConfiguration": { "acceptanceThreshold":Integer }, "fraudDetectionConfiguration": { "riskThreshold":Integer }, "streamingConfiguration": { "authenticationMinimumSpeechInSeconds": Integer }, "enrollmentAudioProgress": { "audioAggregationStatus": String, "audioAggregationStartedAt": "Timestamp", "audioAggregationEndedAt": "Timestamp" }, "authenticationAudioProgress": { "audioAggregationStartedAt": "Timestamp", "audioAggregationEndedAt": "Timestamp" }, "fraudDetectionAudioProgress": { "audioAggregationStartedAt": "Timestamp", "audioAggregationEndedAt": "Timestamp" }, "generatedSpeakerId": String }, "errorInfo": { "errorMessage": String, "errorType": String, "errorCode": Integer } } }

세션 업데이트 작업

내부 세션 업데이트가 성공하거나 실패할 때 이벤트를 발생시킵니다.

{...commonfields "detail-type": "VoiceId Update Session Action", "detail": { "sourceId": String, "action": "UPDATE_SESSION", "status": String, "domainId": String, "session": { "sessionId": String, "sessionName": String, "authenticationConfiguration": { "acceptanceThreshold": Integer }, "fraudDetectionConfiguration": { "riskThreshold": Integer }, "streamingConfiguration": { "authenticationMinimumSpeechInSeconds": Integer }, "generatedSpeakerId": String }, "errorInfo": { "errorMessage": String, "errorType": String, "errorCode": Integer } } }

세션 작업 평가

세션 평가가 성공하거나 실패할 때 이벤트를 발생시킵니다. 이유로는 사기꾼이나 음성_스푸핑이 있을 수 있습니다.

{...commonfields "detail-type": "VoiceId Evaluate Session Action", "detail": { "sourceId": String, "action": "EVALUATE_SESSION", "status": String, "domainId": String, "session": { "sessionId": String, "sessionName": String, "generatedSpeakerId": String, "streamingStatus": String, "authenticationResult": { "authenticationResultId": String, "decision": String, "score": Integer, "audioAggregationStartedAt": "Timestamp", "audioAggregationEndedAt": "Timestamp", "configuration": { "acceptanceThreshold": Integer } }, "fraudDetectionResult": { "fraudDetectionResultId": String, "decision": String, "reasons": [String], "audioAggregationStartedAt": "Timestamp", "audioAggregationEndedAt": "Timestamp", "configuration": {"riskThreshold": Integer}, "riskDetails": {"knownFraudsterRisk": {"generatedFraudsterId": String, "riskScore": Integer}, "voiceSpoofingRisk": {"riskScore": Integer} } } }, "errorInfo": : { "errorMessage": String, "errorType": String, "errorCode": Integer } } }

발언자 작업

발언자 수신 거부, 발언자 삭제 또는 발언자 등록 성공 또는 실패에 대한 이벤트를 발생시킵니다.

{...commonfields "detail-type": "VoiceId Speaker Action", "detail": { "sourceId": String, "domainID": String, "action": String, "status": String, "generatedSpeakerId": String, "data": { "enrollmentSource": String, "enrollmentSourceId": String, "enrollmentStatus": String}, "errorInfo": { "errorMessage": String, "errorType": String, "errorCode": Integer } } }

속성입니다 작업

사기꾼 삭제 또는 사기꾼 등록 성공 또는 실패에 대한 이벤트를 생성합니다.

{...commonfields "detail-type": "VoiceId Fraudster Action", "detail": { "sourceId": String, "domainID": String, "action": String, "status": String, "generatedFraudsterId": String, "data": { "registrationSource": String, "registrationSourceId": String, "registrationStatus": String }, "errorInfo": { "errorMessage": String, "errorType": String, "errorCode": Integer } } }

EnrollBySession

등록 요청이 제출될 때 이 이벤트를 발생시킵니다. ASpeaker실제 등록이 성공하거나 실패할 때 이벤트가 발생합니다.

{...commonfields "detail-type": "VoiceId Session Speaker Enrollment Action", "detail": { "sourceId": String, "domainId": String, "action": "SESSION_ENROLLMENT_REQUEST", "status": String, "sessionId": String, "sessionName": String, "errorInfo": { "errorMessage": String, "errorType": String, "errorCode": Integer } } }

StartSpeakerEnrollmentJob

배치 등록 요청이 제출, 성공 또는 실패할 때 이 이벤트를 발생시킵니다. ASpeaker각 연사마다 해당 등록의 성공 또는 실패 여부를 나타내는 이벤트가 발생합니다.

{...commonfields "detail-type": "VoiceID Batch Speaker Enrollment Action", "detail": { "sourceId": String, "domainId": String, "action": "BATCH_ENROLLMENT_REQUEST", "status": String, "batchJobId": String, "data": { "dataAccessRoleArn": String, "enrollmentConfig": { "existingEnrollmentAction": String, "fraudDetectionConfig": { "fraudDetectionAction": String, "riskThreshold": Integer } }, "inputDataConfig": { "s3Uri": String }, "outputDataConfig": { "s3Uri": String, "kmsKeyId": String } }, "errorInfo": { "errorMessage": String, "errorType": String, "errorCode": Integer } } }

StartFraudsterRegistrationJob

배치 등록 요청이 제출, 성공 또는 실패할 때 이 이벤트를 발생시킵니다. AFraudster각 개별 사기꾼에 대해 해당 등록의 성공 또는 실패 여부를 나타내는 이벤트가 발생합니다.

{...commonfields "detail-type": "VoiceId Batch Fraudster Registration Action", "detail": { "sourceId": String, "domainId": String, "action": "BATCH_REGISTRATION_REQUEST", "status": String, "batchJobId": String, "data": { "dataAccessRoleArn": String, "registrationConfig": { "duplicateRegistrationAction": String, "fraudsterSimilarityThreshold": Integer } "inputDataConfig": { "s3Uri": String }, "outputDataConfig": { "s3Uri": String, "kmsKeyId": String } }, "errorInfo": { "errorMessage": String, "errorType": String, "errorCode": Integer } } }