Memahami pemberitahuan

Analisis suara secara otomatis mengirimkan peristiwa ke target saat penelusuran speaker atau tugas analisis nada suara dimulai, saat dijalankan, dan saat selesai. Anda menggunakan target notifikasi untuk menerima peristiwa tersebut. Sebaiknya gunakan beberapa target notifikasi jika alur kerja atau aplikasi Anda membutuhkan ketersediaan tinggi.

Selain itu, Anda harus menggunakan IAM peran dengan kebijakan yang diperlukan untuk mengakses target notifikasi Anda. Untuk informasi selengkapnya, lihat Menggunakan peran akses sumber daya analitik panggilan.

catatan

Untuk Amazon SQS dan AmazonSNS, kami tidak mendukung first-in-first-out antrian. Akibatnya, pesan mungkin rusak. Sebaiknya periksa stempel waktu untuk memesan pesan sesuai kebutuhan, dan menyimpan pesan di penyimpanan data seperti Amazon DynamoDB. Anda juga dapat menggunakan Dapatkan APIs dijelaskan Polling untuk hasil tugas untuk menerima hasil terbaru.

Tabel berikut mencantumkan peristiwa dan jenis detailnya yang sesuai.

Acara pemberitahuan	Jenis detail
Metadata analitik suara	VoiceAnalyticsStatus
Pencarian speaker	SpeakerSearchStatus
Analisis nada suara	VoiceToneAnalysisStatus

Acara pencarian pembicara

Acara pencarian pembicara memiliki jenis SpeakerSearchStatus detail.

Konektor SDK Suara Amazon Chime mengirim acara pencarian pembicara berikut:

• Kecocokan identifikasi

• Generasi penyematan suara

Acara dapat memiliki status berikut:

• IdentificationSuccessful— Berhasil mengidentifikasi setidaknya satu ID profil suara yang cocok dengan skor kepercayaan tinggi di domain profil suara yang diberikan.

• IdentificationFailureGagal melakukan identifikasi. Penyebab: penelepon tidak berbicara setidaknya 10 detik, kualitas audio buruk.

• IdentificationNoMatchesFound— Tidak dapat menemukan kecocokan kepercayaan tinggi di domain profil suara yang diberikan. Penelepon mungkin baru, atau suara mereka mungkin telah berubah.

• VoiceprintGenerationSuccessful— Sistem menghasilkan penyematan suara menggunakan 20 detik audio non-senyap.

• VoiceprintGenerationFailure— Sistem gagal menghasilkan penyematan suara. Penyebab: penelepon tidak berbicara setidaknya selama 20 detik, kualitas audio buruk.

Kecocokan identifikasi

Setelah StartSpeakerSearchTaskAPIdipanggil untuk diberikantransactionId, layanan Konektor Suara mengembalikan pemberitahuan kecocokan identifikasi setelah 10 detik ucapan non-diam. Layanan mengembalikan 10 pertandingan teratas, bersama dengan ID profil suara dan skor kepercayaan mulai dari [0, 1]. Semakin tinggi skor kepercayaan, semakin besar kemungkinan pembicara dari panggilan tersebut cocok dengan ID profil suara. Jika model pembelajaran mesin tidak menemukan kecocokan, detailStatus bidang notifikasi berisiIdentificationNoMatchesFound.

Contoh berikut menunjukkan pemberitahuan untuk pertandingan yang berhasil.

{    
    "version": "0",
    "id": "12345678-1234-1234-1234-111122223333",
    "detail-type": "SpeakerSearchStatus",
    "service-type": "VoiceAnalytics",
    "source": "aws.chime",
    "account": "111122223333",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "taskId": "uuid",
        "detailStatus": "IdentificationSuccessful",
        "speakerSearchDetails" : {
            "results": [
                {
                    "voiceProfileId": "vp-505e0992-82da-49eb-9d4a-4b34772b96b6",
                    "confidenceScore": "0.94567856",
                },
                {
                    "voiceProfileId": "vp-fba9cbfa-4b8d-4f10-9e41-9dfdd66545ab",
                    "confidenceScore": "0.82783350",
                },
                {
                    "voiceProfileId": "vp-746995fd-16dc-45b9-8965-89569d1cf787",
                    "confidenceScore": "0.77136436",
                }
            ]
        },
        "mediaInsightsPipelineId": "87654321-33ca-4dc6-9cdf-abcde6612345",
        "sourceArn": "arn:aws:chime:us-east-1:111122223333:media-pipeline/87654321-33ca-4dc6-9cdf-abcde6612345",
        "streamArn": "arn:aws:kinesisvideo:us-east-1:111122223333:stream/my-stream/0123456789012",
        "channelId": 0
    }
} 

Generasi penyematan suara

Setelah 10 detik ucapan non-senyap tambahan, Konektor Suara mengirimkan pemberitahuan pembuatan penyematan suara ke target notifikasi. Anda dapat mendaftarkan penyematan suara baru di profil suara, atau memperbarui cetakan yang sudah ada di profil suara.

Contoh berikut menunjukkan pemberitahuan untuk kecocokan yang berhasil, artinya Anda dapat memperbarui profil suara terkait.

{
    "version": "0",
    "id": "12345678-1234-1234-1234-111122223333",
    "detail-type": "SpeakerSearchStatus",
    "service-type": "VoiceAnalytics",
    "source": "aws.chime",
    "account": "111122223333",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "taskId": "guid",
        "detailStatus": "VoiceprintGenerationSuccess",
        "mediaInsightsPipelineId": "87654321-33ca-4dc6-9cdf-abcde6612345",
        "sourceArn": "arn:aws:chime:us-east-1:111122223333:media-pipeline/87654321-33ca-4dc6-9cdf-abcde6612345",
        "streamArn": "arn:aws:kinesisvideo:us-east-1:111122223333:stream/my-stream/0123456789012",
        "channelId": 0
    }
}

Acara analisis nada suara

Peristiwa analisis nada suara memiliki jenis VoiceToneAnalysisStatus detail. Analisis dapat mengembalikan status ini:

• VoiceToneAnalysisSuccessful— Berhasil menganalisis suara penelepon dan agen menjadi probabilitas sentimen — positif, negatif, atau netral.

• VoiceToneAnalysisFailure— Gagal melakukan analisis nada. Ini bisa terjadi jika penelepon hang tanpa berbicara selama 10 detik, atau jika kualitas audio menjadi terlalu buruk.

• VoiceToneAnalysisCompleted— Berhasil menganalisis suara pengguna dan agen ke dalam probabilitas sentimen untuk seluruh panggilan. Ini adalah acara terakhir, dikirim ketika analisis nada suara selesai.

Contoh berikut menunjukkan peristiwa analisis nada suara yang khas.

{
  "detail-type": "VoiceToneAnalysisStatus",
  "service-type": "VoiceAnalytics",
  "source": "aws.chime",
  "account": "216539279014",
  "time": "2022-08-26T17:55:15.563441Z",
  "region": "us-east-1",
  "detail": {
    "taskId": "uuid",
    "detailStatus": "VoiceToneAnalysisSuccessful",
    "voiceToneAnalysisDetails": {
      "currentAverageVoiceTone": {
          "startTime": "2022-08-26T17:55:15.563Z",
          "endTime": "2022-08-26T17:55:45.720Z",
          "voiceToneLabel": "neutral",
          "voiceToneScore": {    
            "neutral": "0.83",    
            "positive": "0.13",    
            "negative": "0.04"
          }
      },
      "overallAverageVoiceTone": {
          "startTime": "2022-08-26T16:23:13.344Z",
          "endTime": "2022-08-26T17:55:45.720Z",
          "voiceToneLabel": "positive",
          "voiceToneScore": {    
            "neutral": "0.25",    
            "positive": "0.65",    
            "negative": "0.1"
          }
      }
    },
        "startFragmentNumber": "01234567890123456789",
        "mediaInsightsPipelineId": "87654321-33ca-4dc6-9cdf-abcde6612345",
        "sourceArn": "arn:aws:chime:us-east-1:111122223333:media-pipeline/87654321-33ca-4dc6-9cdf-abcde6612345",
        "streamArn": "arn:aws:kinesisvideo:us-east-1:111122223333:stream/my-stream/0123456789012",
        "channelId": 0
  },
  "version": "0",
  "id": "Id-f928dfe3-f44b-4965-8a17-612f9fb92d59"
}

Acara ringkasan pasca-panggilan

Acara ringkasan panggilan pos dikirim 5 menit setelah panggilan berakhir. Ringkasan ini memberikan gambaran umum tentang tugas pencarian pembicara yang terjadi selama panggilan.

Contoh berikut menunjukkan ringkasan panggilan pos dengan kecocokan profil suara terbaik, identitas pembicara yang dikonfirmasi, dan daftar profil suara yang dibuat atau diperbarui melalui CreateVoiceProfile dan UpdateVoiceProfile API panggilan yang dilakukan selama panggilan.

{
    "version": "0",
    "id": "12345678-1234-1234-1234-111122223333",
    "detail-type": "VoiceAnalyticsStatus",
    "service-type": "VoiceAnalytics",
    "source": "aws.chime",
    "account": "111122223333",
    "time": "yyyy-mm-ddThh:mm:ssZ",    
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "detailStatus": "PostCallVoiceAnalytics",
        "callId": "22e8dee8-bbd7-4f94-927b-2d0ebaeddc1c",
        "transactionId": "daaeb6bf-2fe2-4e51-984e-d0fbf2f09436",
        "voiceConnectorId": "abcdef1ghij2klmno3pqr4",
        "isCaller": true | false,
        "speakerSearchResults": {
            "bestMatchedVoiceProfileId": "vp-04c25ba1-a059-4fd3-8495-4ac91b55e2bf",
            "customerValidatedCallerIdentity": "vp-04c25ba1-a059-4fd3-8495-4ac91b55e2bf",
            "createVoiceProfileTransactions": [
                {
                    "voiceProfileId": "vp-04c25ba1-a059-4fd3-8495-4ac91b55e2bf",
                    "requestTimestamp": "2022-12-14T18:38:38.796Z"
                },
                {
                    "voiceProfileId": "vp-04c25ba1-a059-4fd3-8495-4ac91b55e2bf",
                    "requestTimestamp": "2022-12-14T18:38:38.796Z",
                }
            ],
            "updateVoiceProfileTransactions": [
                {
                    "voiceProfileId": "vp-04c25ba1-a059-4fd3-8495-4ac91b55e2bf",
                    "requestTimestamp": "2022-12-14T18:38:38.796Z",
                },
                {
                    "voiceProfileId": "vp-04c25ba1-a059-4fd3-8495-4ac91b55e2bf",
                    "requestTimestamp": "2022-12-14T18:38:38.796Z",
                }
            ]
        }
    }
}