Benachrichtigungen verstehen - Amazon Chime SDK
Veranstaltungen zur Suche nach RednernEreignisse zur StimmentonanalyseZusammenfassung der Ereignisse nach dem Anruf

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.

Benachrichtigungen verstehen

Die Sprachanalyse sendet Ereignisse automatisch an ein Ziel, wenn Aufgaben zur Lautsprechersuche oder Stimmenanalyse beginnen, während sie ausgeführt werden und wenn sie beendet 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 Ressourcenzugriffsrolle Call Analytics.

Anmerkung

Für Amazon SQS und Amazon SNS unterstützen first-in-first-out wir keine Warteschlangen. Dies kann dazu führen, dass 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 von Aufgabenergebnissen zu erhalten.

In der folgenden Tabelle sind die Ereignisse und ihre entsprechenden Detailtypen aufgeführt.

Benachrichtigungsereignis

Art des Details

Metadaten zur Sprachanalyse

VoiceAnalyticsStatus

Suche nach Lautsprechern

SpeakerSearchStatus

Analyse des Stimmklangs

VoiceToneAnalysisStatus

Veranstaltungen zur Suche nach Rednern

Ereignisse zur Suche nach Rednern haben den Typ „SpeakerSearchStatusDetail“.

Amazon Chime SDK Voice Connectors senden die folgenden Lautsprecher-Suchereignisse:

  • Die Identifizierung stimmt überein

  • Generierung von Spracheinbettung

Die Ereignisse können den folgenden Status haben:

  • IdentificationSuccessful— Es wurde erfolgreich mindestens eine passende Sprachprofil-ID mit einem hohen Konfidenzwert in der angegebenen Sprachprofildomäne identifiziert.

  • IdentificationFailure— Identifizierung konnte nicht durchgeführt werden. Ursachen: Der Anrufer spricht mindestens 10 Sekunden lang nicht, schlechte Audioqualität.

  • IdentificationNoMatchesFound— In der angegebenen Sprachprofildomäne konnte keine Übereinstimmung mit hoher Zuverlässigkeit gefunden werden. Der Anrufer ist möglicherweise neu, oder seine Stimme hat sich geändert.

  • VoiceprintGenerationSuccessful— Das System generierte eine Spracheinbettung mithilfe von 20 Sekunden ohne Geräuschlosigkeit.

  • 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 StartSpeakerSearchTaskAPI für einen bestimmten Vorgang aufgerufen wurdetransactionId, sendet der Voice Connector-Dienst nach 10 Sekunden Spracheingabe eine Benachrichtigung über den Identifizierungsabgleich zurück. Der Dienst gibt die 10 besten Treffer zusammen mit einer Stimmprofil-ID und einem Konfidenzwert zwischen [0, 1] zurück. Je höher der Konfidenzwert, desto wahrscheinlicher ist es, dass der Sprecher des Anrufs mit der Stimmprofil-ID übereinstimmt. Wenn das Modell für maschinelles Lernen 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 von Spracheinbettung

Nach weiteren 10 Sekunden Spracheingabe ohne Ton sendet der Voice Connector eine Benachrichtigung über die Generierung der Spracheinbettung an die Benachrichtigungsziele. Sie können neue Spracheinbettungen in ein Stimmprofil aufnehmen oder einen Ausdruck aktualisieren, der sich bereits in einem Sprachprofil befindet.

Das folgende Beispiel zeigt die Benachrichtigung für einen erfolgreichen Abgleich, 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 zur Stimmentonanalyse

Ereignisse zur Stimmenanalyse haben den Typ „VoiceToneAnalysisStatusDetail“. Die Analysen können folgende Status zurückgeben:

  • VoiceToneAnalysisSuccessful— Die Stimmen des Anrufers und des Agenten wurden erfolgreich nach Stimmungswahrscheinlichkeiten — positiv, negativ oder neutral — 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 von Benutzern und Agenten wurden erfolgreich analysiert, um Stimmungswahrscheinlichkeiten für den gesamten Anruf zu ermitteln. Dies ist das letzte Ereignis, das gesendet wird, wenn die Stimmenanalyse 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"
}

Zusammenfassung der Ereignisse nach dem Anruf

Eine Zusammenfassung der Ereignisse nach dem Anruf wird 5 Minuten nach Ende des Anrufs gesendet. Diese Zusammenfassungen bieten einen Überblick über die Aufgaben zur Sprechersuche, die während des Anrufs durchgeführt wurden.

Das folgende Beispiel zeigt eine Zusammenfassung nach dem Anruf mit der besten Übereinstimmung mit dem Stimmprofil, der bestätigten Sprecheridentität und einer Liste der Sprachprofile, die über die während des Anrufs CreateVoiceProfile 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",
                }
            ]
        }
    }
}