View a markdown version of this page

Informazioni sulle notifiche per l'SDK Amazon Chime - SDK Amazon Chime
Eventi di ricerca degli altoparlantiEventi di analisi del tono vocalePost-call eventi di riepilogo

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Informazioni sulle notifiche per l'SDK Amazon Chime

L'analisi vocale invia automaticamente gli eventi a un target quando le attività di ricerca degli altoparlanti o di analisi del tono vocale iniziano, mentre sono in esecuzione e quando finiscono. Gli obiettivi di notifica vengono utilizzati per ricevere tali eventi. Ti consigliamo di utilizzare più destinazioni di notifica se il flusso di lavoro o l'applicazione richiedono un'elevata disponibilità.

Inoltre, è necessario utilizzare un ruolo IAM con le policy necessarie per accedere ai destinatari delle notifiche. Per ulteriori informazioni, consulta Utilizzo del ruolo di accesso alle risorse di analisi delle chiamate per l'SDK Amazon Chime.

Nota

Per Amazon SQS e Amazon SNS, non supportiamo le code first-in-first-out. Di conseguenza, i messaggi potrebbero arrivare fuori servizio. Consigliamo di controllare i timestamp per ordinare i messaggi in base alle esigenze e di mantenere i messaggi in un archivio dati come Amazon DynamoDB. Puoi anche utilizzare le API Get descritte in Sondaggio dei risultati delle attività per l'SDK Amazon Chime per ricevere i risultati più recenti.

La tabella seguente elenca gli eventi e i tipi di dettagli corrispondenti.

Evento di notifica

Tipo di dettaglio

Metadati di analisi vocale

VoiceAnalyticsStatus

Ricerca degli altoparlanti

SpeakerSearchStatus

Analisi del tono vocale

VoiceToneAnalysisStatus

Eventi di ricerca degli altoparlanti

Gli eventi di ricerca degli altoparlanti hanno il tipo di SpeakerSearchStatus dettaglio.

I connettori vocali di Amazon Chime SDK inviano i seguenti eventi di ricerca degli altoparlanti:

  • L'identificazione corrisponde

  • Generazione di incorporamento vocale

Gli eventi possono avere i seguenti stati:

  • IdentificationSuccessful— Identificato con successo almeno un ID del profilo vocale corrispondente con un punteggio di confidenza elevato nel dominio del profilo vocale specificato.

  • IdentificationFailure— Impossibile eseguire l'identificazione. Cause: il chiamante non parla per almeno 10 secondi, qualità audio scadente.

  • IdentificationNoMatchesFound— Impossibile trovare una corrispondenza ad alta confidenza nel dominio del profilo vocale specificato. Il chiamante potrebbe essere nuovo o la sua voce potrebbe essere cambiata.

  • VoiceprintGenerationSuccessful— Il sistema ha generato un incorporamento vocale utilizzando 20 secondi di audio non silenzioso.

  • VoiceprintGenerationFailure— Il sistema non è riuscito a generare un incorporamento vocale. Cause: il chiamante non parla per almeno 20 secondi, qualità audio scadente.

L'identificazione corrisponde

Dopo aver richiamato l'StartSpeakerSearchTaskAPI per un determinato datotransactionId, il servizio Voice Connector restituisce una notifica di corrispondenza identificativa dopo 10 secondi di conversazione non silenziosa. Il servizio restituisce le prime 10 corrispondenze, insieme a un ID del profilo vocale e a un punteggio di confidenza compreso tra [0, 1]. Più alto è il punteggio di confidenza, più è probabile che l'altoparlante della chiamata corrisponda all'ID del profilo vocale. Se il modello di machine learning non trova corrispondenze, il detailStatus campo della notifica contieneIdentificationNoMatchesFound.

L'esempio seguente mostra la notifica per una corrispondenza riuscita.

{    
    "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
    }
}

Generazione di incorporamento vocale

Dopo altri 10 secondi di conversazione non silenziosa, Voice Connector invia una notifica di generazione di incorporamento vocale ai destinatari delle notifiche. Puoi registrare nuove incorporazioni vocali in un profilo vocale o aggiornare una stampa già presente in un profilo vocale.

L'esempio seguente mostra la notifica di una corrispondenza riuscita, il che significa che puoi aggiornare il profilo vocale associato.

{
    "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
    }
}

Eventi di analisi del tono vocale

Gli eventi di analisi del tono vocale hanno il tipo di VoiceToneAnalysisStatus dettaglio. Le analisi possono restituire questi stati:

  • VoiceToneAnalysisSuccessful— Ha analizzato con successo le voci del chiamante e dell'agente in base alle probabilità di sentimento: positive, negative o neutre.

  • VoiceToneAnalysisFailure— Impossibile eseguire l'analisi del tono. Ciò può accadere se il chiamante si blocca senza parlare per 10 secondi o se la qualità audio diventa troppo scarsa.

  • VoiceToneAnalysisCompleted— Ha analizzato con successo le voci degli utenti e degli agenti in base alle probabilità di sentimento per l'intera chiamata. Questo è l'evento finale, inviato al termine dell'analisi del tono vocale.

L'esempio seguente mostra un tipico evento di analisi del tono vocale.

{
  "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 eventi di riepilogo

Gli eventi di riepilogo post-chiamata vengono inviati 5 minuti dopo la fine della chiamata. Questi riepiloghi forniscono una panoramica delle attività di ricerca degli oratori eseguite durante la chiamata.

L'esempio seguente mostra un riepilogo dopo la chiamata con la migliore corrispondenza del profilo vocale, l'identità dell'altoparlante confermata e un elenco dei profili vocali creati o aggiornati tramite le chiamate CreateVoiceProfile e UpdateVoiceProfile API effettuate durante la chiamata.

{
    "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",
                }
            ]
        }
    }
}