了解通知 - Amazon Chime SDK
揚聲器搜尋事件語音分析事件通話後摘要事件

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

了解通知

語音分析會在喇叭搜尋或語音分析工作開始、執行時以及完成時，自動將事件傳送至目標。您可以使用通知目標來接收這些事件。如果您的工作流程或應用程式需要高可用性，建議使用多個通知目標。

此外，您必須搭配存取通知目標所需的政策使用 IAM 角色。如需詳細資訊，請參閱 使用呼叫分析資源存取角色。

注意

對於 Amazon SQS 和 Amazon SNS，我們不支持 first-in-first-out 隊列。因此，郵件可能會出現故障。建議您根據需要檢查時間戳記以訂購訊息，並在資料存放區 (例如 Amazon DynamoDB) 中保留訊息。您也可以使用中所述的 Get API 輪詢工作結果 來接收最新結果。

下表列出了事件及其對應的詳細信息類型。

通知事件

詳圖類型

語音分析元數據

VoiceAnalyticsStatus

揚聲器搜尋

SpeakerSearchStatus

語音分析

VoiceToneAnalysisStatus

揚聲器搜尋事件

發言人搜尋事件具有SpeakerSearchStatus詳細資料類型。

Amazon Chime SDK 語音連接器會傳送下列喇叭搜尋事件：

  • 識別符合

  • 語音嵌入生成

事件可以具有下列狀態：

  • IdentificationSuccessful— 在給定的語音配置文件域中成功識別至少一個具有高可信度分數的匹配語音配置文件 ID。

  • IdentificationFailure— 無法執行識別。原因：來電者至少 10 秒鐘沒有通話，音頻質量差。

  • IdentificationNoMatchesFound— 在指定的語音設定檔網域中找不到高可信度相符項目。來電者可能是新來電者，或者他們的聲音可能已經改變。

  • VoiceprintGenerationSuccessful— 系統使用 20 秒的非靜音音頻生成了嵌入語音。

  • VoiceprintGenerationFailure— 系統無法生成語音嵌入。原因：來電者至少 20 秒不通話，音頻質量差。

識別符合

呼叫指定的 StartSpeakerSearchTaskAPI 之後transactionId，語音連接器服務會在 10 秒的非靜音語音後傳回識別符合通知。服務會傳回前 10 名相符項目，以及語音設定檔 ID 和置信度分數 (範圍為 [0, 1])。信賴度分數越高，來自通話的發言者與語音設定檔 ID 相符的可能性就越大。如果機器學習模型找不到相符項目，則通知的detailStatus欄位會包含IdentificationNoMatchesFound。

下列範例顯示成功比對的通知。

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

語音嵌入生成

經過額外 10 秒的非靜音語音之後，語音連接器會傳送語音內嵌產生通知給通知目標。您可以在語音設定檔中註冊新的語音內嵌，或更新語音設定檔中已有的列印。

下列範例顯示成功比對的通知，表示您可以更新關聯的語音設定檔。

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

語音分析事件

語調分析事件具有VoiceToneAnalysisStatus詳細類型。分析可以傳回下列狀態：

  • VoiceToneAnalysisSuccessful— 成功地將來電者和代理人的聲音分析為情緒的概率-正面，負面或中立。

  • VoiceToneAnalysisFailure— 無法執行色調分析。如果呼叫者在 10 秒內沒有通話而掛起，或者音頻質量變得太差，則可能會發生這種情況。

  • VoiceToneAnalysisCompleted— 成功地將用戶和代理人的聲音分析為整個呼叫的情緒概率。這是語音分析完成時傳送的最後一個事件。

下列範例顯示典型的語調分析事件。

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

通話後摘要事件

通話後摘要事件會在通話結束 5 分鐘後傳送。這些摘要提供了在整個通話中發生的發言者搜索任務的概述。

下列範例會顯示通話後摘要，其中包含最佳語音設定檔比對、已確認的發言者身分，以及透過通話期間進行的CreateVoiceProfile和 UpdateVoiceProfile API 呼叫建立或更新的語音設定檔清單。

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