Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Grundlegendes zu Benachrichtigungen für das Amazon Chime SDK
Die Sprachanalyse sendet automatisch Ereignisse an ein Ziel, wenn Aufgaben zur Sprechersuche oder zur Sprachtonanalyse gestartet werden, während sie ausgeführt werden und wenn sie abgeschlossen sind. Sie verwenden Benachrichtigungsziele, um diese Ereignisse zu empfangen. Wir empfehlen, mehrere Benachrichtigungsziele zu verwenden, wenn Ihr Workflow oder Ihre Anwendung eine hohe Verfügbarkeit benötigt.
Außerdem müssen Sie eine IAM-Rolle mit den Richtlinien verwenden, die für den Zugriff auf Ihre Benachrichtigungsziele erforderlich sind. Weitere Informationen finden Sie unter Verwenden Sie die Rolle für den Ressourcenzugriff auf Call Analytics für das Amazon Chime SDK.
Anmerkung
Für Amazon SQS und Amazon SNS unterstützen wir keine First-in-First-Out-Warteschlangen. Daher können Nachrichten nicht in der richtigen Reihenfolge ankommen. Wir empfehlen, die Zeitstempel zu überprüfen, um Nachrichten nach Bedarf zu sortieren, und Nachrichten in einem Datenspeicher wie Amazon DynamoDB zu speichern. Sie können auch die unter beschriebenen Get APIs verwenden, um die neuesten Ergebnisse Abfrage der Aufgabenergebnisse für das Amazon Chime SDK zu erhalten.
In der folgenden Tabelle sind die Ereignisse und die entsprechenden Detailtypen aufgeführt.
Benachrichtigungsereignis |
Typ des Details |
|---|---|
Metadaten zur Sprachanalyse |
|
Suche nach Sprechern |
|
Analyse des Sprachtons |
|
Veranstaltungen zur Sprechersuche
Ereignisse für die Sprechersuche haben den SpeakerSearchStatus Detailtyp.
Amazon Chime SDK Voice Connectors senden die folgenden Lautsprecher-Suchereignisse:
-
Die Identifizierung stimmt überein
-
Generierung der Spracheinbettung
Die Ereignisse können den folgenden Status haben:
-
IdentificationSuccessful— Mindestens eine passende Stimmprofil-ID mit einem hohen Konfidenzwert in der angegebenen Stimmprofildomäne wurde erfolgreich identifiziert. -
IdentificationFailure— Identifizierung konnte nicht durchgeführt werden. Ursachen: Der Anrufer spricht mindestens 10 Sekunden lang nicht, schlechte Audioqualität. -
IdentificationNoMatchesFound— In der angegebenen Sprachprofil-Domäne konnte kein Treffer mit hoher Konfidenz gefunden werden. Der Anrufer ist möglicherweise neu oder seine Stimme hat sich geändert. -
VoiceprintGenerationSuccessful— Das System generierte eine Spracheinbettung, bei der 20 Sekunden lang kein Ton verstummt war. -
VoiceprintGenerationFailure— Das System konnte keine Spracheinbettung generieren. Ursachen: Der Anrufer spricht mindestens 20 Sekunden lang nicht, schlechte Audioqualität.
Die Identifizierung stimmt überein
Nachdem die StartSpeakerSearchTask API für eine bestimmte Zeit aufgerufen wurdetransactionId, sendet der Voice Connector-Dienst nach 10 Sekunden ohne stumme Spracheingabe eine Benachrichtigung über die Identifikationsübereinstimmung zurück. Der Dienst gibt die 10 besten Treffer zusammen mit einer Stimmprofil-ID und einem Vertrauenswert im Bereich von [0, 1] zurück. Je höher der Vertrauenswert, desto wahrscheinlicher ist es, dass der Sprecher aus dem Anruf mit der Sprachprofil-ID übereinstimmt. Wenn das Machine-Learning-Modell keine Treffer findet, enthält das detailStatus Feld der Benachrichtigung FolgendesIdentificationNoMatchesFound.
Das folgende Beispiel zeigt eine Benachrichtigung über einen erfolgreichen Treffer.
{ "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 } }
Generierung der Spracheinbettung
Nach weiteren 10 Sekunden ohne Stummschaltung sendet der Voice Connector eine Benachrichtigung zur Generierung der Spracheinbettung an die Benachrichtigungsziele. Sie können neue Spracheinbettungen in ein Stimmprofil aufnehmen oder einen bereits in einem Stimmprofil vorhandenen Ausdruck aktualisieren.
Das folgende Beispiel zeigt die Benachrichtigung über einen erfolgreichen Match, was bedeutet, dass Sie das zugehörige Stimmprofil aktualisieren können.
{ "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 } }
Ereignisse bei der Analyse des Sprachtons
Ereignisse der Stimmtonanalyse haben den VoiceToneAnalysisStatus Detailtyp. Die Analysen können die folgenden Status zurückgeben:
-
VoiceToneAnalysisSuccessful— Die Stimmen des Anrufers und des Agenten wurden erfolgreich im Hinblick auf die Wahrscheinlichkeit einer positiven, negativen oder neutralen Stimmung analysiert. -
VoiceToneAnalysisFailure— Die Tonanalyse konnte nicht durchgeführt werden. Dies kann passieren, wenn der Anrufer 10 Sekunden lang hängen bleibt, ohne zu sprechen, oder wenn die Audioqualität zu schlecht wird. -
VoiceToneAnalysisCompleted— Die Stimmen des Benutzers und des Agenten wurden erfolgreich auf die Stimmungswahrscheinlichkeiten für den gesamten Anruf hin analysiert. Dies ist das letzte Ereignis, das gesendet wird, wenn die Sprachtonanalyse abgeschlossen ist.
Das folgende Beispiel zeigt ein typisches Ereignis zur Stimmentonanalyse.
{ "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 zusammenfassende Ereignisse
Zusammenfassende Ereignisse nach einem Anruf werden 5 Minuten nach Ende des Anrufs gesendet. Diese Zusammenfassungen bieten einen Überblick über die Aufgaben zur Sprechersuche, die während des Anrufs anfielen.
Das folgende Beispiel zeigt eine Zusammenfassung nach einem Anruf mit dem am besten passenden Sprachprofil, der bestätigten Sprecheridentität und einer Liste der Sprachprofile, die über die CreateVoiceProfile und während des Anrufs getätigten UpdateVoiceProfile API-Aufrufe erstellt oder aktualisiert wurden.
{ "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", } ] } } }
