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

# Amazon Chime SDK 的語音音調分析工作流程範例
<a name="va-tone-flow"></a>

**重要**  
語音音調分析涉及根據語言和音調資訊，對發言者的情緒進行預測。您不得以法律禁止的任何方式使用情緒分析，包括做出有關個人的決策，這些決策會對這些個人產生法律或類似的重大影響 （例如，與僱用、房屋、信用價值或財務優惠等相關）。

語音音調分析會分析通話中人物的語音，並預測他們的情緒，可能是 `positive`、 `negative`或 `neutral`。

下圖顯示語音色調分析的範例工作流程。影像下方的編號項目說明程序的每個步驟。

**注意**  
圖表假設您已使用具有 的通話分析組態來設定 Amazon Chime SDK Voice Connector`VoiceAnalyticsProcessor`。如需詳細資訊，請參閱[錄製語音連接器呼叫](record-vc-calls.md)。

![顯示透過語音音調分析之資料流程的圖表。](http://docs.aws.amazon.com/zh_tw/chime-sdk/latest/dg/images/voice-tone-workflow-v2.png)


在圖表中：

1. 來電者使用指派給 Amazon Chime SDK Voice Connector 的電話號碼撥入 。或者，客服人員使用語音連接器號碼進行外撥通話。

1. Voice Connector 服務會建立交易 ID，並將其與呼叫建立關聯。

1. 您的應用程式，例如互動式語音回應系統，或客服人員會通知來電者有關通話錄音和使用語音內嵌進行語音分析，並尋求他們的參與同意。

1. 假設您的應用程式訂閱 EventBridge 事件，您的應用程式會使用媒體洞見管道組態和語音連接器呼叫的 Kinesis Video Stream ARNs 來呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API。

   如需使用 EventBridge 的詳細資訊，請參閱 [了解 Amazon Chime SDK 機器學習型分析的工作流程](ml-based-analytics.md)。

1. 發起人提供同意後，如果您有語音連接器和交易 ID，您的應用程式或客服人員可以透過語音 [ SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask.html) API。或者，如果您有媒體洞察管道 ID 而不是交易 ID，您可以在[媒體管道 SDK ](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html)中呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html) API。

   一旦發起人提供同意，您的應用程式或客服人員就會呼叫 `StartSpeakerSearchTask` API。您必須將語音連接器 ID、交易 ID 和語音設定檔網域 ID 傳遞給 API。會傳回發言者搜尋任務 ID，以識別非同步任務。

1. 使用者在整個通話中說話。

1. 客服人員會在通話過程中說話。

1. 每 5 秒，媒體洞察管道會使用機器學習模型來分析最後 30 秒的語音，並預測該間隔的發起人語氣，以及從`StartVoiceToneAnalysisTask`第一次呼叫 起的整個通話。

1. 媒體洞察管道會傳送含有該資訊的通知至設定的通知目標。您可以根據其串流 ARN 和頻道 ID 來識別通知。如需詳細資訊[了解 Amazon Chime SDK 的通知](va-notification-targets.md)，請參閱本節稍後的 。

1. 重複步驟 9 和 10，直到通話結束。

1. 在通話結束時，媒體洞察管道會傳送一個最終通知，其中包含過去 30 秒內目前的平均音調預測，以及整個通話的平均音調。

1. 您的應用程式會視需要呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetVoiceToneAnalysisTask.html) API，以取得語音音調分析任務的最新狀態。
**注意**  
`GetVoiceToneAnalysisTask` API 不會串流音調資料。

**注意**  
[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetVoiceToneAnalysisTask.html) API 不會傳回語音音調資料。