Acara pencarian pembicara Peristiwa analisis nada suara Post-call ringkasan acara

Memahami notifikasi untuk Amazon Chime SDK

Analisis suara secara otomatis mengirimkan acara ke target saat pencarian 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 peran IAM dengan kebijakan yang diperlukan untuk mengakses target notifikasi Anda. Untuk informasi selengkapnya, lihat Menggunakan peran akses sumber daya analisis panggilan untuk Amazon Chime SDK.

catatan

Untuk Amazon SQS dan Amazon SNS, kami tidak mendukung antrian yang masuk pertama keluar. Akibatnya, pesan mungkin datang rusak. Sebaiknya periksa stempel waktu untuk memesan pesan sesuai kebutuhan, dan mempertahankan pesan di penyimpanan data seperti Amazon DynamoDB. Anda juga dapat menggunakan Get API yang dijelaskan dalam Polling untuk hasil tugas untuk Amazon Chime SDK untuk menerima hasil terbaru.

Tabel berikut mencantumkan peristiwa dan tipe detail yang sesuai.

Acara pemberitahuan	Tipe detail
Metadata analisis suara	`VoiceAnalyticsStatus`
Pencarian pembicara	`SpeakerSearchStatus`
Analisis nada suara	`VoiceToneAnalysisStatus`

Acara pencarian pembicara

Acara pencarian pembicara memiliki tipe SpeakerSearchStatus detail.

Konektor Suara Amazon Chime SDK mengirimkan 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 selama 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 audio non-senyap selama 20 detik.
VoiceprintGenerationFailure— Sistem gagal menghasilkan penyematan suara. Penyebab: penelepon tidak berbicara setidaknya selama 20 detik, kualitas audio buruk.

Kecocokan identifikasi

Setelah StartSpeakerSearchTask API dipanggil untuk tertentutransactionId, layanan Konektor Suara mengembalikan pemberitahuan kecocokan identifikasi setelah 10 detik pidato tanpa suara. Layanan mengembalikan 10 kecocokan teratas, bersama dengan ID profil suara dan skor kepercayaan mulai dari [0, 1]. Semakin tinggi skor kepercayaan, semakin besar kemungkinan pembicara dari panggilan 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 tambahan 10 detik pidato tanpa suara, 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 pencocokan 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
    }
}

Peristiwa analisis nada suara

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

VoiceToneAnalysisSuccessfulBerhasil menganalisis suara penelepon dan agen menjadi probabilitas sentiment—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"
}

Post-call ringkasan acara

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

Contoh berikut menunjukkan ringkasan pasca panggilan dengan kecocokan profil suara terbaik, identitas pembicara yang dikonfirmasi, dan daftar profil suara yang dibuat atau diperbarui melalui panggilan CreateVoiceProfile dan UpdateVoiceProfile API 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",
                }
            ]
        }
    }
}

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Polling untuk hasil tugas

Memahami kebijakan IAM untuk target notifikasi